PyPI - nautobot - Versions diffs - 2.0.0a3__py3-none-any.whl → 2.0.0b1__py3-none-any.whl - Mend

nautobot 2.0.0a3py3-none-any.whl → 2.0.0b1py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (780) hide show

nautobot/apps/api.py +6 -8
nautobot/apps/forms.py +0 -2
nautobot/apps/ui.py +0 -8
nautobot/circuits/api/serializers.py +9 -117
nautobot/circuits/api/urls.py +1 -1
nautobot/circuits/api/views.py +0 -1
nautobot/circuits/forms.py +0 -65
nautobot/circuits/migrations/0014_related_name_changes.py +1 -1
nautobot/circuits/migrations/0016_tagsfield.py +34 -0
nautobot/circuits/migrations/0017_fixup_null_statuses.py +22 -0
nautobot/circuits/migrations/0018_status_nonnullable.py +22 -0
nautobot/circuits/models.py +3 -87
nautobot/circuits/navigation.py +14 -69
nautobot/circuits/signals.py +0 -2
nautobot/circuits/tables.py +39 -1
nautobot/circuits/tests/integration/test_relationships.py +9 -9
nautobot/circuits/tests/test_api.py +4 -8
nautobot/circuits/tests/test_filters.py +10 -4
nautobot/circuits/tests/test_models.py +5 -1
nautobot/circuits/tests/test_views.py +27 -5
nautobot/circuits/views.py +18 -10
nautobot/core/api/__init__.py +8 -2
nautobot/core/api/fields.py +15 -6
nautobot/core/api/filter_backends.py +3 -2
nautobot/core/api/metadata.py +237 -30
nautobot/core/api/mixins.py +94 -0
nautobot/core/api/pagination.py +4 -0
nautobot/core/api/parsers.py +154 -0
nautobot/core/api/renderers.py +153 -2
nautobot/core/api/schema.py +46 -2
nautobot/core/api/serializers.py +377 -35
nautobot/core/api/urls.py +11 -3
nautobot/core/api/utils.py +174 -2
nautobot/core/api/versioning.py +32 -10
nautobot/core/api/views.py +266 -72
nautobot/core/apps/__init__.py +138 -220
nautobot/core/celery/__init__.py +112 -41
nautobot/core/celery/backends.py +19 -12
nautobot/core/celery/control.py +46 -0
nautobot/core/celery/encoders.py +53 -0
nautobot/core/celery/log.py +38 -0
nautobot/core/celery/schedulers.py +23 -4
nautobot/core/celery/task.py +1 -16
nautobot/core/checks.py +0 -27
nautobot/core/choices.py +0 -113
nautobot/core/{cli.py → cli/__init__.py} +1 -1
nautobot/core/cli/__main__.py +3 -0
nautobot/core/constants.py +0 -24
nautobot/core/context_processors.py +12 -0
nautobot/core/filters.py +2 -2
nautobot/core/forms/__init__.py +0 -4
nautobot/core/forms/fields.py +38 -65
nautobot/core/forms/forms.py +4 -1
nautobot/core/forms/utils.py +0 -52
nautobot/core/graphql/schema.py +4 -27
nautobot/core/jobs/__init__.py +75 -0
nautobot/core/management/commands/build_ui.py +255 -0
nautobot/core/management/commands/generate_test_data.py +3 -2
nautobot/core/management/commands/post_upgrade.py +24 -24
nautobot/core/models/__init__.py +26 -1
nautobot/core/models/fields.py +24 -5
nautobot/core/models/generics.py +2 -42
nautobot/core/models/managers.py +5 -0
nautobot/core/models/name_color_content_types.py +0 -14
nautobot/core/models/tree_queries.py +14 -4
nautobot/core/models/utils.py +5 -6
nautobot/core/models/validators.py +17 -8
nautobot/core/releases.py +8 -10
nautobot/core/settings.py +80 -42
nautobot/core/tables.py +5 -5
nautobot/core/tasks.py +4 -7
nautobot/core/templates/base.html +1 -49
nautobot/core/templates/base_django.html +49 -0
nautobot/core/templates/base_react.html +55 -0
nautobot/core/templates/buttons/export.html +6 -4
nautobot/core/templates/generic/object_bulk_create.html +10 -21
nautobot/core/templates/generic/object_list.html +3 -1
nautobot/core/templates/generic/object_retrieve_plugin_full_width.html +3 -0
nautobot/core/templates/inc/footer.html +1 -0
nautobot/core/templates/inc/javascript.html +0 -14
nautobot/core/templates/inc/nav_menu.html +28 -33
nautobot/core/templates/inc/object_details_advanced_panel.html +13 -0
nautobot/core/templates/inc/relationships_table_rows.html +2 -2
nautobot/core/templates/nautobot_config.py.j2 +8 -20
nautobot/core/templates/plugin_template/__init__.py-tpl +1 -2
nautobot/core/templates/rest_framework/api.html +8 -0
nautobot/core/templatetags/buttons.py +32 -28
nautobot/core/testing/__init__.py +47 -44
nautobot/core/testing/api.py +362 -47
nautobot/core/testing/filters.py +1 -1
nautobot/core/testing/migrations.py +2 -0
nautobot/core/testing/mixins.py +22 -9
nautobot/core/testing/schema.py +2 -1
nautobot/core/testing/views.py +21 -46
nautobot/core/tests/integration/test_filters.py +17 -8
nautobot/core/tests/integration/test_navbar.py +11 -34
nautobot/core/tests/integration/test_plugin_navbar.py +9 -103
nautobot/core/tests/nautobot_config.py +2 -3
nautobot/core/tests/test_api.py +290 -21
nautobot/core/tests/test_checks.py +0 -7
nautobot/core/tests/test_filters.py +107 -59
nautobot/core/tests/test_forms.py +26 -92
nautobot/core/tests/test_graphql.py +110 -77
nautobot/core/tests/test_logging.py +4 -0
nautobot/core/tests/test_managers.py +3 -1
nautobot/core/tests/test_models.py +2 -0
nautobot/core/tests/test_paginator.py +3 -1
nautobot/core/tests/test_releases.py +12 -12
nautobot/core/tests/test_templatetags_helpers.py +4 -4
nautobot/core/tests/test_utils.py +32 -68
nautobot/core/tests/test_views.py +12 -15
nautobot/core/utils/data.py +17 -0
nautobot/core/utils/deprecation.py +9 -6
nautobot/core/utils/filtering.py +8 -3
nautobot/core/utils/git.py +12 -4
nautobot/core/utils/lookup.py +3 -1
nautobot/core/utils/requests.py +1 -104
nautobot/core/views/__init__.py +1 -0
nautobot/core/views/generic.py +75 -110
nautobot/core/views/mixins.py +52 -61
nautobot/core/views/renderers.py +6 -7
nautobot/core/views/utils.py +80 -0
nautobot/dcim/api/serializers.py +160 -667
nautobot/dcim/api/urls.py +1 -1
nautobot/dcim/api/views.py +7 -44
nautobot/dcim/choices.py +2 -0
nautobot/dcim/filters/__init__.py +21 -0
nautobot/dcim/form_mixins.py +1 -27
nautobot/dcim/forms.py +19 -765
nautobot/dcim/migrations/0024_alter_device_and_rack_role_add_new_role.py +2 -1
nautobot/dcim/migrations/0025_device_and_rack_roles_data_migrations.py +19 -13
nautobot/dcim/migrations/0027_remove_device_role_and_rack_role.py +1 -1
nautobot/dcim/migrations/0028_rename_foreignkey_fields.py +1 -1
nautobot/dcim/migrations/0030_migrate_region_and_site_data_to_locations.py +2 -2
nautobot/dcim/migrations/0035_related_name_changes.py +1 -1
nautobot/dcim/migrations/0036_remove_region_and_site.py +1 -1
nautobot/dcim/migrations/0040_tagsfield.py +109 -0
nautobot/dcim/migrations/{0040_ipam__namespaces.py → 0041_ipam__namespaces.py} +1 -1
nautobot/dcim/migrations/0042_fixup_null_statuses.py +51 -0
nautobot/dcim/migrations/0043_status_nonnullable.py +72 -0
nautobot/dcim/models/cables.py +3 -33
nautobot/dcim/models/device_component_templates.py +6 -0
nautobot/dcim/models/device_components.py +12 -198
nautobot/dcim/models/devices.py +30 -143
nautobot/dcim/models/locations.py +3 -64
nautobot/dcim/models/power.py +3 -50
nautobot/dcim/models/racks.py +7 -84
nautobot/dcim/navigation.py +141 -467
nautobot/dcim/signals.py +0 -2
nautobot/dcim/tables/locations.py +2 -2
nautobot/dcim/tables/power.py +1 -2
nautobot/dcim/templates/dcim/console_port_connection_list.html +7 -0
nautobot/dcim/templates/dcim/devicetype.html +2 -2
nautobot/dcim/templates/dcim/interface_connection_list.html +7 -0
nautobot/dcim/templates/dcim/location.html +16 -1
nautobot/dcim/templates/dcim/locationtype.html +15 -0
nautobot/dcim/templates/dcim/power_port_connection_list.html +7 -0
nautobot/dcim/templates/dcim/rackgroup.html +0 -12
nautobot/dcim/tests/test_api.py +166 -81
nautobot/dcim/tests/test_cablepaths.py +41 -35
nautobot/dcim/tests/test_filters.py +67 -23
nautobot/dcim/tests/test_forms.py +5 -205
nautobot/dcim/tests/test_graphql.py +7 -2
nautobot/dcim/tests/test_migrations.py +6 -11
nautobot/dcim/tests/test_models.py +182 -110
nautobot/dcim/tests/test_natural_ordering.py +11 -8
nautobot/dcim/tests/test_signals.py +6 -3
nautobot/dcim/tests/test_views.py +197 -175
nautobot/dcim/urls.py +11 -16
nautobot/dcim/views.py +7 -134
nautobot/docs/additional-features/caching.md +6 -87
nautobot/docs/additional-features/job-scheduling-and-approvals.md +3 -0
nautobot/docs/additional-features/jobs.md +177 -195
nautobot/docs/administration/nautobot-server.md +6 -21
nautobot/docs/administration/replicating-nautobot.md +0 -10
nautobot/docs/configuration/optional-settings.md +32 -41
nautobot/docs/configuration/required-settings.md +11 -52
nautobot/docs/development/application-registry.md +2 -13
nautobot/docs/development/extending-models.md +15 -17
nautobot/docs/development/generic-views.md +0 -2
nautobot/docs/development/getting-started.md +55 -5
nautobot/docs/development/navigation-menu.md +22 -93
nautobot/docs/development/react-ui.md +105 -0
nautobot/docs/development/role-internals.md +1 -3
nautobot/docs/development/style-guide.md +6 -4
nautobot/docs/index.md +3 -2
nautobot/docs/installation/migrating-from-netbox.md +11 -42
nautobot/docs/installation/nautobot.md +1 -1
nautobot/docs/installation/tables/v2-api-behavior-changes.yaml +70 -0
nautobot/docs/installation/tables/v2-api-removed-fields.yaml +142 -0
nautobot/docs/installation/tables/v2-api-renamed-fields.yaml +124 -0
nautobot/docs/installation/tables/v2-code-location-changes.yaml +241 -0
nautobot/docs/installation/tables/v2-code-removals.yaml +67 -0
nautobot/docs/installation/tables/v2-database-behavior-changes.yaml +37 -0
nautobot/docs/installation/tables/v2-database-removed-fields.yaml +166 -0
nautobot/docs/installation/tables/v2-database-renamed-fields.yaml +340 -0
nautobot/docs/installation/tables/v2-filters-corrected-fields.yaml +28 -0
nautobot/docs/installation/tables/v2-filters-enhanced-fields.yaml +241 -0
nautobot/docs/installation/tables/v2-filters-removed-fields.yaml +553 -0
nautobot/docs/installation/tables/v2-filters-renamed-fields.yaml +223 -0
nautobot/docs/installation/tables/v2-logging-renamed-loggers.yaml +23 -0
nautobot/docs/installation/upgrading-from-nautobot-v1.md +170 -747
nautobot/docs/models/dcim/device.md +3 -0
nautobot/docs/models/dcim/deviceredundancygroup.md +3 -3
nautobot/docs/models/extras/computedfield.md +4 -4
nautobot/docs/models/extras/gitrepository.md +3 -0
nautobot/docs/models/extras/job.md +1 -0
nautobot/docs/models/extras/jobbutton.md +18 -13
nautobot/docs/models/extras/jobhook.md +7 -4
nautobot/docs/models/extras/jobresult.md +6 -2
nautobot/docs/models/extras/relationship.md +2 -2
nautobot/docs/models/extras/status.md +6 -19
nautobot/docs/models/ipam/ipaddress.md +3 -0
nautobot/docs/models/virtualization/virtualmachine.md +3 -0
nautobot/docs/plugins/development.md +83 -21
nautobot/docs/release-notes/version-1.5.md +53 -0
nautobot/docs/release-notes/version-2.0.md +180 -0
nautobot/docs/requirements.txt +1 -0
nautobot/docs/rest-api/overview.md +384 -215
nautobot/docs/rest-api/ui-related-endpoints.md +9 -0
nautobot/extras/admin.py +3 -5
nautobot/extras/api/customfields.py +15 -39
nautobot/extras/api/fields.py +0 -11
nautobot/extras/api/mixins.py +45 -0
nautobot/extras/api/relationships.py +63 -158
nautobot/extras/api/serializers.py +165 -700
nautobot/extras/api/urls.py +1 -1
nautobot/extras/api/views.py +294 -280
nautobot/extras/apps.py +4 -7
nautobot/extras/choices.py +11 -9
nautobot/extras/constants.py +9 -3
nautobot/extras/datasources/__init__.py +2 -0
nautobot/extras/datasources/git.py +135 -186
nautobot/extras/datasources/registry.py +25 -35
nautobot/extras/filters/__init__.py +20 -19
nautobot/extras/filters/mixins.py +4 -4
nautobot/extras/forms/forms.py +63 -127
nautobot/extras/forms/mixins.py +23 -51
nautobot/extras/health_checks.py +0 -33
nautobot/extras/jobs.py +387 -565
nautobot/extras/management/commands/runjob.py +24 -62
nautobot/extras/managers.py +30 -7
nautobot/extras/migrations/0058_jobresult_add_time_status_idxs.py +38 -0
nautobot/extras/migrations/{0058_joblogentry_scheduledjob_webhook_data_migration.py → 0059_joblogentry_scheduledjob_webhook_data_migration.py} +1 -1
nautobot/extras/migrations/{0059_alter_joblogentry_scheduledjob_webhook_fields.py → 0060_alter_joblogentry_scheduledjob_webhook_fields.py} +1 -1
nautobot/extras/migrations/{0060_role_and_alter_status.py → 0061_role_and_alter_status.py} +1 -7
nautobot/extras/migrations/{0061_collect_roles_from_related_apps_roles.py → 0062_collect_roles_from_related_apps_roles.py} +33 -32
nautobot/extras/migrations/{0062_alter_role_options.py → 0063_alter_role_options.py} +1 -1
nautobot/extras/migrations/{0063_alter_configcontext_and_add_new_role.py → 0064_alter_configcontext_and_add_new_role.py} +1 -1
nautobot/extras/migrations/0065_configcontext_data_migrations.py +44 -0
nautobot/extras/migrations/{0065_rename_configcontext_role.py → 0066_rename_configcontext_role.py} +1 -1
nautobot/extras/migrations/{0066_jobresult__add_celery_fields.py → 0067_jobresult__add_celery_fields.py} +36 -2
nautobot/extras/migrations/{0067_created_datetime.py → 0068_created_datetime.py} +1 -1
nautobot/extras/migrations/{0068_remove_site_and_region_attributes_from_config_context.py → 0069_remove_site_and_region_attributes_from_config_context.py} +1 -1
nautobot/extras/migrations/{0069_replace_related_names.py → 0070_replace_related_names.py} +1 -1
nautobot/extras/migrations/{0070_rename_model_fields.py → 0071_rename_model_fields.py} +1 -1
nautobot/extras/migrations/0072_job__unique_name_data_migration.py +86 -0
nautobot/extras/migrations/{0072_job__unique_name.py → 0073_job__unique_name.py} +13 -9
nautobot/extras/migrations/{0073_remove_gitrepository_fields.py → 0074_remove_gitrepository_fields.py} +1 -1
nautobot/extras/migrations/{0074_rename_slug_to_key_for_custom_field.py → 0075_rename_slug_to_key_for_custom_field.py} +1 -1
nautobot/extras/migrations/{0075_migrate_custom_field_data.py → 0076_migrate_custom_field_data.py} +1 -1
nautobot/extras/migrations/{0076_remove_name_field_and_make_label_field_non_nullable.py → 0077_remove_name_field_and_make_label_field_non_nullable.py} +1 -1
nautobot/extras/migrations/{0077_remove_slug.py → 0078_remove_slug.py} +1 -5
nautobot/extras/migrations/0079_tagsfield.py +28 -0
nautobot/extras/migrations/0080_rename_relationship_slug_to_key.py +17 -0
nautobot/extras/migrations/0081_rename_relationship_name_to_label.py +29 -0
nautobot/extras/migrations/0082_ensure_relationship_keys_are_unique.py +43 -0
nautobot/extras/migrations/0083_rename_computed_field_slug_to_key.py +21 -0
nautobot/extras/migrations/0084_taggeditem_cleanup.py +43 -0
nautobot/extras/migrations/0085_taggeditem_uniqueness.py +22 -0
nautobot/extras/migrations/0086_job__celery_task_fields__dryrun_support.py +81 -0
nautobot/extras/migrations/0087_job__commit_default_data_migration.py +26 -0
nautobot/extras/migrations/0088_joblogentry__log_level_default.py +17 -0
nautobot/extras/migrations/0089_joblogentry__log_level_data_migration.py +34 -0
nautobot/extras/migrations/0090_scheduledjob__data_migration.py +57 -0
nautobot/extras/models/__init__.py +2 -3
nautobot/extras/models/change_logging.py +0 -36
nautobot/extras/models/customfields.py +39 -33
nautobot/extras/models/datasources.py +48 -50
nautobot/extras/models/groups.py +5 -6
nautobot/extras/models/jobs.py +189 -321
nautobot/extras/models/mixins.py +0 -71
nautobot/extras/models/models.py +0 -19
nautobot/extras/models/relationships.py +19 -13
nautobot/extras/models/roles.py +0 -34
nautobot/extras/models/secrets.py +2 -26
nautobot/extras/models/statuses.py +6 -5
nautobot/extras/models/tags.py +2 -17
nautobot/extras/navigation.py +89 -307
nautobot/extras/plugins/__init__.py +3 -120
nautobot/extras/plugins/utils.py +0 -3
nautobot/extras/plugins/validators.py +5 -4
nautobot/extras/plugins/views.py +16 -3
nautobot/extras/querysets.py +1 -7
nautobot/extras/registry.py +3 -0
nautobot/extras/signals.py +26 -60
nautobot/extras/tables.py +34 -40
nautobot/extras/tasks.py +0 -12
nautobot/extras/templates/extras/configcontext.html +1 -1
nautobot/extras/templates/extras/configcontextschema.html +16 -1
nautobot/extras/templates/extras/customfield.html +0 -13
nautobot/extras/templates/extras/gitrepository.html +3 -3
nautobot/extras/templates/extras/inc/jobresult.html +10 -0
nautobot/extras/templates/extras/inc/panel_jobhistory.html +1 -1
nautobot/extras/templates/extras/job.html +35 -25
nautobot/extras/templates/extras/job_approval_request.html +15 -30
nautobot/extras/templates/extras/job_detail.html +13 -31
nautobot/extras/templates/extras/job_edit.html +15 -17
nautobot/extras/templates/extras/jobresult.html +24 -6
nautobot/extras/templates/extras/scheduledjob.html +2 -2
nautobot/extras/templates/extras/secret.html +28 -0
nautobot/extras/templatetags/job_buttons.py +1 -0
nautobot/extras/{tests/example_jobs → test_jobs}/api_test_job.py +13 -6
nautobot/extras/test_jobs/atomic_transaction.py +53 -0
nautobot/extras/test_jobs/dry_run.py +29 -0
nautobot/extras/{tests/example_jobs/test_duplicate_name.py → test_jobs/duplicate_name.py} +4 -0
nautobot/extras/test_jobs/duplicate_name2.py +9 -0
nautobot/extras/test_jobs/fail.py +23 -0
nautobot/extras/{tests/example_jobs/test_field_default.py → test_jobs/field_default.py} +4 -0
nautobot/extras/{tests/example_jobs/test_field_order.py → test_jobs/field_order.py} +4 -0
nautobot/extras/{tests/example_jobs/test_file_upload_fail.py → test_jobs/file_upload_fail.py} +11 -6
nautobot/extras/test_jobs/file_upload_pass.py +25 -0
nautobot/extras/test_jobs/has_sensitive_variables.py +25 -0
nautobot/extras/test_jobs/ipaddress_vars.py +66 -0
nautobot/extras/test_jobs/job_button_receiver.py +28 -0
nautobot/extras/test_jobs/job_hook_receiver.py +29 -0
nautobot/extras/test_jobs/job_variables.py +88 -0
nautobot/extras/test_jobs/location_with_custom_field.py +45 -0
nautobot/extras/test_jobs/log_redaction.py +20 -0
nautobot/extras/test_jobs/log_skip_db_logging.py +17 -0
nautobot/extras/test_jobs/modify_db.py +25 -0
nautobot/extras/{tests/example_jobs/test_no_field_order.py → test_jobs/no_field_order.py} +4 -0
nautobot/extras/test_jobs/object_var_optional.py +21 -0
nautobot/extras/test_jobs/object_var_required.py +21 -0
nautobot/extras/test_jobs/object_vars.py +26 -0
nautobot/extras/test_jobs/pass.py +25 -0
nautobot/extras/test_jobs/profiling.py +32 -0
nautobot/extras/test_jobs/read_only_job.py +15 -0
nautobot/extras/{tests/example_jobs/test_required_args.py → test_jobs/required_args.py} +4 -0
nautobot/extras/{tests/example_jobs/test_soft_time_limit_greater_than_time_limit.py → test_jobs/soft_time_limit_greater_than_time_limit.py} +5 -1
nautobot/extras/{tests/example_jobs/test_task_queues.py → test_jobs/task_queues.py} +5 -1
nautobot/extras/tests/integration/test_computedfields.py +1 -1
nautobot/extras/tests/integration/test_configcontextschema.py +5 -3
nautobot/extras/tests/integration/test_customfields.py +4 -2
nautobot/extras/tests/integration/test_dynamicgroups.py +1 -1
nautobot/extras/tests/integration/test_jobs.py +25 -27
nautobot/extras/tests/integration/test_notes.py +8 -4
nautobot/extras/tests/integration/test_relationships.py +2 -2
nautobot/extras/tests/test_api.py +649 -642
nautobot/extras/tests/test_changelog.py +3 -3
nautobot/extras/tests/test_context_managers.py +5 -3
nautobot/extras/tests/test_customfields.py +92 -50
nautobot/extras/tests/test_datasources.py +189 -112
nautobot/extras/tests/test_dynamicgroups.py +7 -8
nautobot/extras/tests/test_filters.py +137 -89
nautobot/extras/tests/test_forms.py +73 -75
nautobot/extras/tests/{test_scripts.py → test_job_variables.py} +43 -49
nautobot/extras/tests/test_jobs.py +262 -263
nautobot/extras/tests/test_migrations.py +4 -3
nautobot/extras/tests/test_models.py +116 -161
nautobot/extras/tests/test_plugins.py +38 -60
nautobot/extras/tests/test_relationships.py +167 -120
nautobot/extras/tests/test_tags.py +6 -11
nautobot/extras/tests/test_utils.py +31 -1
nautobot/extras/tests/test_views.py +201 -145
nautobot/extras/tests/test_webhooks.py +6 -2
nautobot/extras/urls.py +42 -42
nautobot/extras/utils.py +137 -163
nautobot/extras/views.py +78 -152
nautobot/ipam/api/fields.py +17 -0
nautobot/ipam/api/serializers.py +58 -164
nautobot/ipam/api/urls.py +1 -1
nautobot/ipam/api/views.py +3 -2
nautobot/ipam/apps.py +1 -2
nautobot/ipam/filters.py +1 -10
nautobot/ipam/forms.py +4 -177
nautobot/ipam/lookups.py +1 -0
nautobot/ipam/management/commands/__init__.py +0 -0
nautobot/ipam/management/commands/fix_prefix_broadcast.py +17 -0
nautobot/ipam/migrations/0010_alter_ipam_role_add_new_role.py +1 -1
nautobot/ipam/migrations/0011_migrate_ipam_role_data.py +32 -38
nautobot/ipam/migrations/0020_related_name_changes.py +1 -1
nautobot/ipam/migrations/0022_aggregate_to_prefix_data_migration.py +2 -2
nautobot/ipam/migrations/0028_tagsfield.py +44 -0
nautobot/ipam/migrations/0029_ip_address_to_interface_uniqueness_constraints.py +18 -0
nautobot/ipam/migrations/{0028_ipam__namespaces.py → 0030_ipam__namespaces.py} +77 -28
nautobot/ipam/migrations/0031_ipam__prefix__add_parent.py +58 -0
nautobot/ipam/migrations/0032_ipam__namespaces_finish.py +63 -0
nautobot/ipam/migrations/0033_fixup_null_statuses.py +26 -0
nautobot/ipam/migrations/0034_status_nonnullable.py +36 -0
nautobot/ipam/models.py +100 -236
nautobot/ipam/navigation.py +36 -181
nautobot/ipam/querysets.py +20 -25
nautobot/ipam/signals.py +49 -6
nautobot/ipam/tables.py +10 -3
nautobot/ipam/templates/ipam/namespace_ipaddresses.html +11 -0
nautobot/ipam/templates/ipam/namespace_prefixes.html +11 -0
nautobot/ipam/templates/ipam/namespace_retrieve.html +17 -4
nautobot/ipam/templates/ipam/namespace_vrfs.html +11 -0
nautobot/ipam/templates/ipam/prefix.html +1 -1
nautobot/ipam/templates/ipam/vlangroup.html +0 -13
nautobot/ipam/templates/ipam/vrf_edit.html +6 -0
nautobot/ipam/tests/integration/test_prefixes.py +3 -26
nautobot/ipam/tests/test_api.py +22 -19
nautobot/ipam/tests/test_filters.py +59 -23
nautobot/ipam/tests/test_migrations.py +6 -10
nautobot/ipam/tests/test_models.py +323 -198
nautobot/ipam/tests/test_ordering.py +2 -2
nautobot/ipam/tests/test_querysets.py +44 -24
nautobot/ipam/tests/test_views.py +73 -26
nautobot/ipam/urls.py +16 -0
nautobot/ipam/{utils.py → utils/__init__.py} +2 -2
nautobot/ipam/utils/migrations.py +713 -0
nautobot/ipam/views.py +137 -20
nautobot/project-static/docs/404.html +1178 -10
nautobot/project-static/docs/additional-features/caching.html +1224 -159
nautobot/project-static/docs/additional-features/change-logging.html +1180 -12
nautobot/project-static/docs/additional-features/config-contexts.html +1180 -12
nautobot/project-static/docs/additional-features/graphql.html +1179 -11
nautobot/project-static/docs/additional-features/healthcheck.html +1180 -12
nautobot/project-static/docs/additional-features/job-scheduling-and-approvals.html +1184 -12
nautobot/project-static/docs/additional-features/jobs.html +1514 -328
nautobot/project-static/docs/additional-features/napalm.html +1180 -12
nautobot/project-static/docs/additional-features/prometheus-metrics.html +1180 -12
nautobot/project-static/docs/additional-features/template-filters.html +1180 -12
nautobot/project-static/docs/administration/celery-queues.html +1178 -10
nautobot/project-static/docs/administration/nautobot-server.html +1451 -304
nautobot/project-static/docs/administration/nautobot-shell.html +1178 -10
nautobot/project-static/docs/administration/permissions.html +1178 -10
nautobot/project-static/docs/administration/replicating-nautobot.html +1262 -113
nautobot/project-static/docs/apps/index.html +1178 -10
nautobot/project-static/docs/apps/nautobot-apps.html +1178 -10
nautobot/project-static/docs/code-reference/nautobot/apps/__init__.html +1580 -426
nautobot/project-static/docs/code-reference/nautobot/apps/admin.html +1178 -10
nautobot/project-static/docs/code-reference/nautobot/apps/api.html +3481 -1838
nautobot/project-static/docs/code-reference/nautobot/apps/choices.html +1178 -10
nautobot/project-static/docs/code-reference/nautobot/apps/config.html +1178 -10
nautobot/project-static/docs/code-reference/nautobot/apps/datasources.html +1185 -11
nautobot/project-static/docs/code-reference/nautobot/apps/filters.html +1719 -551
nautobot/project-static/docs/code-reference/nautobot/apps/forms.html +2062 -930
nautobot/project-static/docs/code-reference/nautobot/apps/models.html +1946 -659
nautobot/project-static/docs/code-reference/nautobot/apps/secrets.html +1180 -12
nautobot/project-static/docs/code-reference/nautobot/apps/tables.html +1189 -21
nautobot/project-static/docs/code-reference/nautobot/apps/testing.html +9283 -6218
nautobot/project-static/docs/code-reference/nautobot/apps/ui.html +2734 -2122
nautobot/project-static/docs/code-reference/nautobot/apps/urls.html +1178 -10
nautobot/project-static/docs/code-reference/nautobot/apps/views.html +2337 -1300
nautobot/project-static/docs/configuration/authentication/ldap.html +1178 -10
nautobot/project-static/docs/configuration/authentication/remote.html +1178 -10
nautobot/project-static/docs/configuration/authentication/sso.html +1178 -10
nautobot/project-static/docs/configuration/index.html +1178 -10
nautobot/project-static/docs/configuration/optional-settings.html +1311 -160
nautobot/project-static/docs/configuration/required-settings.html +1312 -211
nautobot/project-static/docs/core-functionality/circuits.html +1178 -10
nautobot/project-static/docs/core-functionality/device-types.html +1178 -10
nautobot/project-static/docs/core-functionality/devices.html +1182 -10
nautobot/project-static/docs/core-functionality/ipam.html +1182 -10
nautobot/project-static/docs/core-functionality/power.html +1178 -10
nautobot/project-static/docs/core-functionality/secrets.html +1178 -10
nautobot/project-static/docs/core-functionality/services.html +1178 -10
nautobot/project-static/docs/core-functionality/sites-and-racks.html +1178 -10
nautobot/project-static/docs/core-functionality/tenancy.html +1178 -10
nautobot/project-static/docs/core-functionality/virtualization.html +1182 -10
nautobot/project-static/docs/core-functionality/vlans.html +1179 -11
nautobot/project-static/docs/development/application-registry.html +1190 -42
nautobot/project-static/docs/development/best-practices.html +1178 -10
nautobot/project-static/docs/development/docker-compose-advanced-use-cases.html +1178 -10
nautobot/project-static/docs/development/extending-models.html +1238 -83
nautobot/project-static/docs/development/generic-views.html +1180 -14
nautobot/project-static/docs/development/getting-started.html +1365 -90
nautobot/project-static/docs/development/homepage.html +1178 -10
nautobot/project-static/docs/development/index.html +1178 -10
nautobot/project-static/docs/development/model-features.html +1178 -10
nautobot/project-static/docs/development/natural-keys.html +1178 -10
nautobot/project-static/docs/development/navigation-menu.html +1215 -125
nautobot/project-static/docs/development/react-ui.html +4199 -0
nautobot/project-static/docs/development/release-checklist.html +1178 -10
nautobot/project-static/docs/development/role-internals.html +1179 -12
nautobot/project-static/docs/development/style-guide.html +1188 -19
nautobot/project-static/docs/development/templates.html +1178 -10
nautobot/project-static/docs/development/testing.html +1178 -10
nautobot/project-static/docs/development/user-preferences.html +1178 -10
nautobot/project-static/docs/docker/index.html +1178 -10
nautobot/project-static/docs/index.html +1183 -12
nautobot/project-static/docs/installation/centos.html +1178 -10
nautobot/project-static/docs/installation/external-authentication.html +1178 -10
nautobot/project-static/docs/installation/http-server.html +1178 -10
nautobot/project-static/docs/installation/index.html +1178 -10
nautobot/project-static/docs/installation/migrating-from-netbox.html +1305 -189
nautobot/project-static/docs/installation/migrating-from-postgresql.html +1178 -10
nautobot/project-static/docs/installation/nautobot.html +1179 -11
nautobot/project-static/docs/installation/region-and-site-data-migration-guide.html +1178 -10
nautobot/project-static/docs/installation/selinux-troubleshooting.html +1178 -10
nautobot/project-static/docs/installation/services.html +1178 -10
nautobot/project-static/docs/installation/tables/v2-api-behavior-changes.yaml +70 -0
nautobot/project-static/docs/installation/tables/v2-api-removed-fields.yaml +142 -0
nautobot/project-static/docs/installation/tables/v2-api-renamed-fields.yaml +124 -0
nautobot/project-static/docs/installation/tables/v2-code-location-changes.yaml +241 -0
nautobot/project-static/docs/installation/tables/v2-code-removals.yaml +67 -0
nautobot/project-static/docs/installation/tables/v2-database-behavior-changes.yaml +37 -0
nautobot/project-static/docs/installation/tables/v2-database-removed-fields.yaml +166 -0
nautobot/project-static/docs/installation/tables/v2-database-renamed-fields.yaml +340 -0
nautobot/project-static/docs/installation/tables/v2-filters-corrected-fields.yaml +28 -0
nautobot/project-static/docs/installation/tables/v2-filters-enhanced-fields.yaml +241 -0
nautobot/project-static/docs/installation/tables/v2-filters-removed-fields.yaml +553 -0
nautobot/project-static/docs/installation/tables/v2-filters-renamed-fields.yaml +223 -0
nautobot/project-static/docs/installation/tables/v2-logging-renamed-loggers.yaml +23 -0
nautobot/project-static/docs/installation/ubuntu.html +1178 -10
nautobot/project-static/docs/installation/upgrading-from-nautobot-v1.html +3823 -2152
nautobot/project-static/docs/installation/upgrading.html +1178 -10
nautobot/project-static/docs/models/circuits/circuit.html +1293 -103
nautobot/project-static/docs/models/circuits/circuittermination.html +1293 -103
nautobot/project-static/docs/models/circuits/circuittype.html +1293 -103
nautobot/project-static/docs/models/circuits/provider.html +1293 -103
nautobot/project-static/docs/models/circuits/providernetwork.html +1293 -103
nautobot/project-static/docs/models/dcim/cable.html +1324 -103
nautobot/project-static/docs/models/dcim/consoleport.html +1293 -103
nautobot/project-static/docs/models/dcim/consoleporttemplate.html +1293 -103
nautobot/project-static/docs/models/dcim/consoleserverport.html +1293 -103
nautobot/project-static/docs/models/dcim/consoleserverporttemplate.html +1293 -103
nautobot/project-static/docs/models/dcim/device.html +1326 -132
nautobot/project-static/docs/models/dcim/devicebay.html +1293 -103
nautobot/project-static/docs/models/dcim/devicebaytemplate.html +1293 -103
nautobot/project-static/docs/models/dcim/deviceredundancygroup.html +1379 -97
nautobot/project-static/docs/models/dcim/devicetype.html +1293 -103
nautobot/project-static/docs/models/dcim/frontport.html +1293 -103
nautobot/project-static/docs/models/dcim/frontporttemplate.html +1293 -103
nautobot/project-static/docs/models/dcim/interface.html +1293 -103
nautobot/project-static/docs/models/dcim/interfacetemplate.html +1293 -103
nautobot/project-static/docs/models/dcim/inventoryitem.html +1293 -103
nautobot/project-static/docs/models/dcim/location.html +1293 -103
nautobot/project-static/docs/models/dcim/locationtype.html +1293 -103
nautobot/project-static/docs/models/dcim/manufacturer.html +1292 -102
nautobot/project-static/docs/models/dcim/platform.html +1272 -82
nautobot/project-static/docs/models/dcim/powerfeed.html +1270 -80
nautobot/project-static/docs/models/dcim/poweroutlet.html +1272 -82
nautobot/project-static/docs/models/dcim/poweroutlettemplate.html +1272 -82
nautobot/project-static/docs/models/dcim/powerpanel.html +1270 -80
nautobot/project-static/docs/models/dcim/powerport.html +1272 -82
nautobot/project-static/docs/models/dcim/powerporttemplate.html +1272 -82
nautobot/project-static/docs/models/dcim/rack.html +1272 -82
nautobot/project-static/docs/models/dcim/rackgroup.html +1272 -82
nautobot/project-static/docs/models/dcim/rackreservation.html +1272 -82
nautobot/project-static/docs/models/dcim/rearport.html +1286 -96
nautobot/project-static/docs/models/dcim/rearporttemplate.html +1286 -96
nautobot/project-static/docs/models/dcim/region.html +1178 -10
nautobot/project-static/docs/models/dcim/site.html +1178 -10
nautobot/project-static/docs/models/dcim/virtualchassis.html +1284 -94
nautobot/project-static/docs/models/extras/computedfield.html +1184 -16
nautobot/project-static/docs/models/extras/configcontext.html +1314 -86
nautobot/project-static/docs/models/extras/configcontextschema.html +1276 -86
nautobot/project-static/docs/models/extras/customfield.html +1180 -12
nautobot/project-static/docs/models/extras/customlink.html +1180 -12
nautobot/project-static/docs/models/extras/dynamicgroup.html +1180 -12
nautobot/project-static/docs/models/extras/exporttemplate.html +1180 -12
nautobot/project-static/docs/models/extras/gitrepository.html +1184 -12
nautobot/project-static/docs/models/extras/graphqlquery.html +1321 -86
nautobot/project-static/docs/models/extras/imageattachment.html +1276 -86
nautobot/project-static/docs/models/extras/job.html +1277 -86
nautobot/project-static/docs/models/extras/jobbutton.html +1201 -29
nautobot/project-static/docs/models/extras/jobhook.html +1188 -16
nautobot/project-static/docs/models/extras/joblogentry.html +1274 -84
nautobot/project-static/docs/models/extras/jobresult.html +1364 -169
nautobot/project-static/docs/models/extras/note.html +1180 -12
nautobot/project-static/docs/models/extras/relationship.html +1182 -14
nautobot/project-static/docs/models/extras/role.html +1320 -86
nautobot/project-static/docs/models/extras/secret.html +1314 -86
nautobot/project-static/docs/models/extras/secretsgroup.html +1276 -86
nautobot/project-static/docs/models/extras/status.html +1188 -59
nautobot/project-static/docs/models/extras/tag.html +1180 -12
nautobot/project-static/docs/models/extras/webhook.html +1180 -12
nautobot/project-static/docs/models/ipam/ipaddress.html +1327 -102
nautobot/project-static/docs/models/ipam/prefix.html +1276 -86
nautobot/project-static/docs/models/ipam/rir.html +1276 -86
nautobot/project-static/docs/models/ipam/routetarget.html +1276 -86
nautobot/project-static/docs/models/ipam/service.html +1276 -86
nautobot/project-static/docs/models/ipam/vlan.html +1276 -86
nautobot/project-static/docs/models/ipam/vlangroup.html +1276 -86
nautobot/project-static/docs/models/ipam/vrf.html +1276 -86
nautobot/project-static/docs/models/tenancy/tenant.html +1276 -86
nautobot/project-static/docs/models/tenancy/tenantgroup.html +1276 -86
nautobot/project-static/docs/models/users/objectpermission.html +1314 -86
nautobot/project-static/docs/models/users/token.html +1276 -86
nautobot/project-static/docs/models/virtualization/cluster.html +1276 -86
nautobot/project-static/docs/models/virtualization/clustergroup.html +1276 -86
nautobot/project-static/docs/models/virtualization/clustertype.html +1276 -86
nautobot/project-static/docs/models/virtualization/virtualmachine.html +1321 -127
nautobot/project-static/docs/models/virtualization/vminterface.html +1276 -86
nautobot/project-static/docs/objects.inv +0 -0
nautobot/project-static/docs/plugins/development.html +1726 -495
nautobot/project-static/docs/plugins/index.html +1178 -10
nautobot/project-static/docs/plugins/porting-from-netbox.html +1178 -10
nautobot/project-static/docs/release-notes/index.html +1178 -10
nautobot/project-static/docs/release-notes/version-1.0.html +1178 -10
nautobot/project-static/docs/release-notes/version-1.1.html +1178 -10
nautobot/project-static/docs/release-notes/version-1.2.html +1178 -10
nautobot/project-static/docs/release-notes/version-1.3.html +1178 -10
nautobot/project-static/docs/release-notes/version-1.4.html +1178 -10
nautobot/project-static/docs/release-notes/version-1.5.html +1608 -225
nautobot/project-static/docs/release-notes/version-2.0.html +1547 -47
nautobot/project-static/docs/requirements.txt +1 -0
nautobot/project-static/docs/rest-api/authentication.html +1179 -11
nautobot/project-static/docs/rest-api/filtering.html +1178 -10
nautobot/project-static/docs/rest-api/overview.html +1841 -446
nautobot/project-static/docs/rest-api/ui-related-endpoints.html +4057 -0
nautobot/project-static/docs/search/search_index.json +1 -1
nautobot/project-static/docs/sitemap.xml +197 -187
nautobot/project-static/docs/sitemap.xml.gz +0 -0
nautobot/project-static/docs/user-guides/custom-fields.html +1178 -10
nautobot/project-static/docs/user-guides/getting-started/creating-devices.html +1178 -10
nautobot/project-static/docs/user-guides/getting-started/index.html +1178 -10
nautobot/project-static/docs/user-guides/getting-started/interfaces.html +1178 -10
nautobot/project-static/docs/user-guides/getting-started/ipam.html +1178 -10
nautobot/project-static/docs/user-guides/getting-started/platforms.html +1178 -10
nautobot/project-static/docs/user-guides/getting-started/regions.html +1178 -10
nautobot/project-static/docs/user-guides/getting-started/search-bar.html +1178 -10
nautobot/project-static/docs/user-guides/getting-started/tenants.html +1178 -10
nautobot/project-static/docs/user-guides/getting-started/vlans-and-vlan-groups.html +1178 -10
nautobot/project-static/docs/user-guides/git-data-source.html +1178 -10
nautobot/project-static/docs/user-guides/graphql.html +1178 -10
nautobot/project-static/docs/user-guides/relationships.html +1178 -10
nautobot/project-static/docs/user-guides/s3-django-storage.html +1178 -10
nautobot/project-static/js/forms.js +16 -9
nautobot/project-static/js/theme.js +5 -0
nautobot/tenancy/api/serializers.py +4 -32
nautobot/tenancy/api/urls.py +1 -1
nautobot/tenancy/forms.py +0 -28
nautobot/tenancy/migrations/0008_tagsfield.py +19 -0
nautobot/tenancy/models.py +0 -25
nautobot/tenancy/navigation.py +6 -39
nautobot/tenancy/templates/tenancy/tenant.html +12 -12
nautobot/tenancy/templates/tenancy/tenantgroup.html +1 -1
nautobot/tenancy/tests/test_api.py +1 -3
nautobot/tenancy/tests/test_filters.py +10 -5
nautobot/tenancy/views.py +0 -2
nautobot/ui/.eslintignore +6 -0
nautobot/ui/.gitignore +10 -0
nautobot/ui/.prettierignore +9 -0
nautobot/ui/.prettierrc +4 -0
nautobot/ui/README.md +33 -0
nautobot/ui/app_imports.js.j2 +7 -0
nautobot/ui/craco.config.js +46 -0
nautobot/ui/jsconfig-base.json +11 -0
nautobot/ui/jsconfig.json +5 -0
nautobot/ui/lib/nautobot-craco-alias-plugin.js +40 -0
nautobot/ui/package-lock.json +21451 -0
nautobot/ui/package.json +70 -0
nautobot/ui/public/index.html +47 -0
nautobot/ui/public/logo192.png +0 -0
nautobot/ui/public/logo512.png +0 -0
nautobot/ui/public/manifest.json +25 -0
nautobot/ui/public/nautobot_logo.svg +131 -0
nautobot/ui/public/robots.txt +3 -0
nautobot/ui/src/App.js +71 -0
nautobot/ui/src/components/AppFullWidthComponents.js +8 -0
nautobot/ui/src/components/AppTab.js +40 -0
nautobot/ui/src/components/Apps.js +60 -0
nautobot/ui/src/components/HomeChangelogPanel.js +98 -0
nautobot/ui/src/components/HomePanel.js +58 -0
nautobot/ui/src/components/JobHistoryTable.js +78 -0
nautobot/ui/src/components/Layout.js +53 -0
nautobot/ui/src/components/LoadingWidget.js +25 -0
nautobot/ui/src/components/Navbar.js +116 -0
nautobot/ui/src/components/NotificationPopover.js +27 -0
nautobot/ui/src/components/ObjectListTable.js +209 -0
nautobot/ui/src/components/ReferenceDataTag.js +35 -0
nautobot/ui/src/components/RouterButton.js +10 -0
nautobot/ui/src/components/RouterLink.js +10 -0
nautobot/ui/src/components/SidebarNav.js +147 -0
nautobot/ui/src/components/Table.js +48 -0
nautobot/ui/src/components/TableItem.js +71 -0
nautobot/ui/src/components/__tests__/AppFullWidthComponents.test.js +16 -0
nautobot/ui/src/components/__tests__/AppTab.test.js +21 -0
nautobot/ui/src/components/__tests__/Apps.test.js +14 -0
nautobot/ui/src/components/__tests__/Layout.test.js +33 -0
nautobot/ui/src/components/__tests__/Table.test.js +36 -0
nautobot/ui/src/components/__tests__/TableItem.test.js +37 -0
nautobot/ui/src/components/__tests__/paginator.test.js +43 -0
nautobot/ui/src/components/__tests__/paginator_form.test.js +13 -0
nautobot/ui/src/components/pagination.js +93 -0
nautobot/ui/src/components/paginator.js +79 -0
nautobot/ui/src/components/paginator_form.js +43 -0
nautobot/ui/src/components/usePagination.js +57 -0
nautobot/ui/src/constants/apiPath.js +10 -0
nautobot/ui/src/constants/icons.js +15 -0
nautobot/ui/src/constants/size.js +15 -0
nautobot/ui/src/index.js +65 -0
nautobot/ui/src/reportWebVitals.js +15 -0
nautobot/ui/src/router.js +77 -0
nautobot/ui/src/utils/api.js +131 -0
nautobot/ui/src/utils/app-import.js +15 -0
nautobot/ui/src/utils/color.js +15 -0
nautobot/ui/src/utils/date.js +14 -0
nautobot/ui/src/utils/index.js +15 -0
nautobot/ui/src/utils/navigation.js +32 -0
nautobot/ui/src/utils/session.js +64 -0
nautobot/ui/src/utils/store.js +242 -0
nautobot/ui/src/utils/string.js +6 -0
nautobot/ui/src/utils/url.js +4 -0
nautobot/ui/src/views/Home.js +138 -0
nautobot/ui/src/views/InstalledApps.js +80 -0
nautobot/ui/src/views/Login.js +48 -0
nautobot/ui/src/views/Logout.js +20 -0
nautobot/ui/src/views/__tests__/BSCreateViewTemplate.test.js +11 -0
nautobot/ui/src/views/__tests__/BSListViewTemplate.test.js +107 -0
nautobot/ui/src/views/__tests__/Login.test.js +15 -0
nautobot/ui/src/views/generic/GenericView.js +142 -0
nautobot/ui/src/views/generic/ObjectCreate.js +96 -0
nautobot/ui/src/views/generic/ObjectList.js +127 -0
nautobot/ui/src/views/generic/ObjectRetrieve.js +551 -0
nautobot/users/admin.py +1 -1
nautobot/users/api/serializers.py +51 -61
nautobot/users/api/urls.py +1 -1
nautobot/users/api/views.py +53 -2
nautobot/users/tests/test_api.py +110 -25
nautobot/virtualization/api/serializers.py +18 -130
nautobot/virtualization/api/urls.py +1 -1
nautobot/virtualization/api/views.py +1 -22
nautobot/virtualization/forms.py +13 -99
nautobot/virtualization/migrations/0012_alter_virtualmachine_role_add_new_role.py +1 -1
nautobot/virtualization/migrations/0013_migrate_virtualmachine_role_data.py +18 -11
nautobot/virtualization/migrations/0015_rename_foreignkey_fields.py +1 -1
nautobot/virtualization/migrations/0018_related_name_changes.py +1 -1
nautobot/virtualization/migrations/0021_tagsfield_and_vminterface_to_primarymodel.py +39 -0
nautobot/virtualization/migrations/0022_vminterface_timestamps_data_migration.py +17 -0
nautobot/virtualization/migrations/{0021_ipam__namespaces.py → 0023_ipam__namespaces.py} +2 -2
nautobot/virtualization/migrations/0024_fixup_null_statuses.py +25 -0
nautobot/virtualization/migrations/0025_status_nonnullable.py +29 -0
nautobot/virtualization/models.py +31 -123
nautobot/virtualization/navigation.py +18 -99
nautobot/virtualization/templates/virtualization/virtualmachine.html +2 -1
nautobot/virtualization/templates/virtualization/virtualmachine_edit.html +6 -0
nautobot/virtualization/tests/test_api.py +25 -26
nautobot/virtualization/tests/test_filters.py +41 -15
nautobot/virtualization/tests/test_models.py +31 -7
nautobot/virtualization/tests/test_views.py +42 -25
nautobot/virtualization/views.py +7 -6
{nautobot-2.0.0a3.dist-info → nautobot-2.0.0b1.dist-info}/METADATA +3 -7
{nautobot-2.0.0a3.dist-info → nautobot-2.0.0b1.dist-info}/RECORD +744 -602
{nautobot-2.0.0a3.dist-info → nautobot-2.0.0b1.dist-info}/WHEEL +1 -1
nautobot/circuits/api/nested_serializers.py +0 -69
nautobot/core/templates/plugin_template/navigation.py-tpl +0 -22
nautobot/dcim/api/nested_serializers.py +0 -356
nautobot/dcim/templates/dcim/device_import.html +0 -5
nautobot/dcim/templates/dcim/device_import_child.html +0 -5
nautobot/dcim/templates/dcim/inc/device_import_header.html +0 -4
nautobot/extras/api/nested_serializers.py +0 -353
nautobot/extras/migrations/0064_configcontext_data_migrations.py +0 -41
nautobot/extras/migrations/0071_job__unique_name_data_migration.py +0 -46
nautobot/extras/reports.py +0 -60
nautobot/extras/scripts.py +0 -72
nautobot/extras/tests/example_jobs/script_variables.py +0 -67
nautobot/extras/tests/example_jobs/test_duplicate_name2.py +0 -5
nautobot/extras/tests/example_jobs/test_fail.py +0 -16
nautobot/extras/tests/example_jobs/test_file_upload_pass.py +0 -20
nautobot/extras/tests/example_jobs/test_ipaddress_vars.py +0 -52
nautobot/extras/tests/example_jobs/test_job_button_receiver.py +0 -21
nautobot/extras/tests/example_jobs/test_job_hook_receiver.py +0 -20
nautobot/extras/tests/example_jobs/test_location_with_custom_field.py +0 -35
nautobot/extras/tests/example_jobs/test_log_redaction.py +0 -14
nautobot/extras/tests/example_jobs/test_modify_db.py +0 -18
nautobot/extras/tests/example_jobs/test_object_var_optional.py +0 -14
nautobot/extras/tests/example_jobs/test_object_var_required.py +0 -14
nautobot/extras/tests/example_jobs/test_object_vars.py +0 -29
nautobot/extras/tests/example_jobs/test_pass.py +0 -19
nautobot/extras/tests/example_jobs/test_read_only_fail.py +0 -24
nautobot/extras/tests/example_jobs/test_read_only_no_commit_field.py +0 -10
nautobot/extras/tests/example_jobs/test_read_only_pass.py +0 -22
nautobot/ipam/api/nested_serializers.py +0 -159
nautobot/ipam/migrations/0029_ipam__prefix__add_parent.py +0 -31
nautobot/ipam/migrations/0030_ipam__prefix__data_migration.py +0 -13
nautobot/ipam/migrations/0031_ipam__ipaddress__add_parent.py +0 -41
nautobot/ipam/migrations/0032_ipam__ipaddress__data_migration.py +0 -11
nautobot/tenancy/api/nested_serializers.py +0 -31
nautobot/users/api/nested_serializers.py +0 -67
nautobot/virtualization/api/nested_serializers.py +0 -65
/nautobot/extras/{tests/example_jobs → test_jobs}/__init__.py +0 -0
/nautobot/{dcim/models/sites.py → ipam/management/__init__.py} +0 -0
{nautobot-2.0.0a3.dist-info → nautobot-2.0.0b1.dist-info}/LICENSE.txt +0 -0
{nautobot-2.0.0a3.dist-info → nautobot-2.0.0b1.dist-info}/entry_points.txt +0 -0

nautobot/project-static/docs/code-reference/nautobot/apps/forms.html CHANGED Viewed

@@ -1346,12 +1346,1166 @@
         <label class="md-nav__link" for="__nav_2_8" id="__nav_2_8_label" tabindex="0">
+          Model Details
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_8_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_8">
+          <span class="md-nav__icon md-icon"></span>
+          Model Details
+        </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_2_8_1" >
+        <label class="md-nav__link" for="__nav_2_8_1" id="__nav_2_8_1_label" tabindex="0">
+          Circuits
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_1_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_8_1">
+          <span class="md-nav__icon md-icon"></span>
+          Circuits
+        </label>
+        <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../../models/circuits/circuit.html" class="md-nav__link">
+        Circuit
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/circuits/circuittermination.html" class="md-nav__link">
+        Circuit Termination
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/circuits/circuittype.html" class="md-nav__link">
+        Circuit Type
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/circuits/provider.html" class="md-nav__link">
+        Circuit Provider
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/circuits/providernetwork.html" class="md-nav__link">
+        Circuit Provider Network
+      </a>
+    </li>
+        </ul>
+      </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_2" >
+        <label class="md-nav__link" for="__nav_2_8_2" id="__nav_2_8_2_label" tabindex="0">
+          DCIM
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_2_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_8_2">
+          <span class="md-nav__icon md-icon"></span>
+          DCIM
+        </label>
+        <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/cable.html" class="md-nav__link">
+        Cable
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/consoleport.html" class="md-nav__link">
+        Console Port
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/consoleporttemplate.html" class="md-nav__link">
+        Console Port Template
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/consoleserverport.html" class="md-nav__link">
+        Console Server Port
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/consoleserverporttemplate.html" class="md-nav__link">
+        Console Server Port Template
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/device.html" class="md-nav__link">
+        Device
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/devicebay.html" class="md-nav__link">
+        Device Bay
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/devicebaytemplate.html" class="md-nav__link">
+        Device Bay Template
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/deviceredundancygroup.html" class="md-nav__link">
+        Device Redundancy Group
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/devicetype.html" class="md-nav__link">
+        Device Type
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/frontport.html" class="md-nav__link">
+        Front Port
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/frontporttemplate.html" class="md-nav__link">
+        Front Port Template
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/interface.html" class="md-nav__link">
+        Interface
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/interfacetemplate.html" class="md-nav__link">
+        Interface Template
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/inventoryitem.html" class="md-nav__link">
+        Inventory Item
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/location.html" class="md-nav__link">
+        Location
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/locationtype.html" class="md-nav__link">
+        Location Type
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/manufacturer.html" class="md-nav__link">
+        Manufacturer
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/platform.html" class="md-nav__link">
+        Platform
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/powerfeed.html" class="md-nav__link">
+        Power Feed
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/poweroutlet.html" class="md-nav__link">
+        Power Outlet
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/poweroutlettemplate.html" class="md-nav__link">
+        Power Outlet Template
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/powerpanel.html" class="md-nav__link">
+        Power Panel
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/powerport.html" class="md-nav__link">
+        Power Port
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/powerporttemplate.html" class="md-nav__link">
+        Power Port Template
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/rack.html" class="md-nav__link">
+        Rack
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/rackgroup.html" class="md-nav__link">
+        Rack Group
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/rackreservation.html" class="md-nav__link">
+        Rack Reservation
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/rearport.html" class="md-nav__link">
+        Rear Port
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/rearporttemplate.html" class="md-nav__link">
+        Rear Port Template
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/dcim/virtualchassis.html" class="md-nav__link">
+        Virtual Chassis
+      </a>
+    </li>
+        </ul>
+      </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_3" >
+        <label class="md-nav__link" for="__nav_2_8_3" id="__nav_2_8_3_label" tabindex="0">
+          Extras
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_3_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_8_3">
+          <span class="md-nav__icon md-icon"></span>
+          Extras
+        </label>
+        <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../../models/extras/configcontext.html" class="md-nav__link">
+        Config Context
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/extras/configcontextschema.html" class="md-nav__link">
+        Config Context Schema
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/extras/graphqlquery.html" class="md-nav__link">
+        GraphQL Query
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/extras/imageattachment.html" class="md-nav__link">
+        Image Attachment
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/extras/job.html" class="md-nav__link">
+        Job
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/extras/joblogentry.html" class="md-nav__link">
+        Job Log Entry
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/extras/jobresult.html" class="md-nav__link">
+        Job Result
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/extras/role.html" class="md-nav__link">
+        Role
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/extras/secret.html" class="md-nav__link">
+        Secret
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/extras/secretsgroup.html" class="md-nav__link">
+        Secrets group
+      </a>
+    </li>
+        </ul>
+      </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_4" >
+        <label class="md-nav__link" for="__nav_2_8_4" id="__nav_2_8_4_label" tabindex="0">
+          IPAM
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_4_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_8_4">
+          <span class="md-nav__icon md-icon"></span>
+          IPAM
+        </label>
+        <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../../models/ipam/ipaddress.html" class="md-nav__link">
+        IP Address
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/ipam/prefix.html" class="md-nav__link">
+        Prefix
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/ipam/rir.html" class="md-nav__link">
+        Rir
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/ipam/routetarget.html" class="md-nav__link">
+        Route Target
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/ipam/service.html" class="md-nav__link">
+        Service
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/ipam/vlan.html" class="md-nav__link">
+        VLAN
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/ipam/vlangroup.html" class="md-nav__link">
+        VLAN Group
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/ipam/vrf.html" class="md-nav__link">
+        VRF
+      </a>
+    </li>
+        </ul>
+      </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_5" >
+        <label class="md-nav__link" for="__nav_2_8_5" id="__nav_2_8_5_label" tabindex="0">
+          Tenancy
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_5_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_8_5">
+          <span class="md-nav__icon md-icon"></span>
+          Tenancy
+        </label>
+        <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../../models/tenancy/tenant.html" class="md-nav__link">
+        Tenant
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/tenancy/tenantgroup.html" class="md-nav__link">
+        Tenant Group
+      </a>
+    </li>
+        </ul>
+      </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_6" >
+        <label class="md-nav__link" for="__nav_2_8_6" id="__nav_2_8_6_label" tabindex="0">
+          Users
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_6_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_8_6">
+          <span class="md-nav__icon md-icon"></span>
+          Users
+        </label>
+        <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../../models/users/objectpermission.html" class="md-nav__link">
+        Object Permission
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/users/token.html" class="md-nav__link">
+        Token
+      </a>
+    </li>
+        </ul>
+      </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_8_7" >
+        <label class="md-nav__link" for="__nav_2_8_7" id="__nav_2_8_7_label" tabindex="0">
+          Virtualization
+          <span class="md-nav__icon md-icon"></span>
+        </label>
+      <nav class="md-nav" data-md-level="3" aria-labelledby="__nav_2_8_7_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_8_7">
+          <span class="md-nav__icon md-icon"></span>
+          Virtualization
+        </label>
+        <ul class="md-nav__list" data-md-scrollfix>
+    <li class="md-nav__item">
+      <a href="../../../models/virtualization/cluster.html" class="md-nav__link">
+        Cluster
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/virtualization/clustergroup.html" class="md-nav__link">
+        Cluster Group
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/virtualization/clustertype.html" class="md-nav__link">
+        Cluster Type
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/virtualization/virtualmachine.html" class="md-nav__link">
+        Virtual Machine
+      </a>
+    </li>
+    <li class="md-nav__item">
+      <a href="../../../models/virtualization/vminterface.html" class="md-nav__link">
+        VM Interface
+      </a>
+    </li>
+        </ul>
+      </nav>
+    </li>
+        </ul>
+      </nav>
+    </li>
+    <li class="md-nav__item md-nav__item--nested">
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_9" >
+        <label class="md-nav__link" for="__nav_2_9" id="__nav_2_9_label" tabindex="0">
           Additional Features
           <span class="md-nav__icon md-icon"></span>
         </label>
-      <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_8_label" aria-expanded="false">
-        <label class="md-nav__title" for="__nav_2_8">
+      <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_9_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_9">
           <span class="md-nav__icon md-icon"></span>
           Additional Features
         </label>
@@ -1683,17 +2837,17 @@
-      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_9" >
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_10" >
-        <label class="md-nav__link" for="__nav_2_9" id="__nav_2_9_label" tabindex="0">
+        <label class="md-nav__link" for="__nav_2_10" id="__nav_2_10_label" tabindex="0">
           REST API
           <span class="md-nav__icon md-icon"></span>
         </label>
-      <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_9_label" aria-expanded="false">
-        <label class="md-nav__title" for="__nav_2_9">
+      <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_10_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_10">
           <span class="md-nav__icon md-icon"></span>
           REST API
         </label>
@@ -1741,6 +2895,20 @@
+    <li class="md-nav__item">
+      <a href="../../../rest-api/ui-related-endpoints.html" class="md-nav__link">
+        UI Endpoints
+      </a>
+    </li>
         </ul>
       </nav>
     </li>
@@ -1759,17 +2927,17 @@
-      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_10" >
+      <input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_2_11" >
-        <label class="md-nav__link" for="__nav_2_10" id="__nav_2_10_label" tabindex="0">
+        <label class="md-nav__link" for="__nav_2_11" id="__nav_2_11_label" tabindex="0">
           GraphQL API
           <span class="md-nav__icon md-icon"></span>
         </label>
-      <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_10_label" aria-expanded="false">
-        <label class="md-nav__title" for="__nav_2_10">
+      <nav class="md-nav" data-md-level="2" aria-labelledby="__nav_2_11_label" aria-expanded="false">
+        <label class="md-nav__title" for="__nav_2_11">
           <span class="md-nav__icon md-icon"></span>
           GraphQL API
         </label>
@@ -2169,13 +3337,6 @@
     StatusModelBulkEditFormMixin
   </a>
-</li>
-        <li class="md-nav__item">
-  <a href="#nautobot.apps.forms.StatusModelCSVFormMixin" class="md-nav__link">
-    StatusModelCSVFormMixin
-  </a>
 </li>
         <li class="md-nav__item">
@@ -3103,13 +4264,6 @@
     StatusModelBulkEditFormMixin
   </a>
-</li>
-        <li class="md-nav__item">
-  <a href="#nautobot.apps.forms.StatusModelCSVFormMixin" class="md-nav__link">
-    StatusModelCSVFormMixin
-  </a>
 </li>
         <li class="md-nav__item">
@@ -3270,37 +4424,45 @@ a more powerful subclass and should be used instead of directly inheriting from
       <p>Provides additional validation for model choices entered as CSV data.</p>
+<p>Note: class name is misleading; the subclass CSVContentTypeField (below) is also used in FilterSets, where it has
+nothing to do with CSV data.</p>
         <details class="quote">
           <summary>Source code in <code>nautobot/core/forms/fields.py</code></summary>
-          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-182">182</a></span>
-<span class="normal"><a href="#__codelineno-0-183">183</a></span>
-<span class="normal"><a href="#__codelineno-0-184">184</a></span>
-<span class="normal"><a href="#__codelineno-0-185">185</a></span>
-<span class="normal"><a href="#__codelineno-0-186">186</a></span>
-<span class="normal"><a href="#__codelineno-0-187">187</a></span>
-<span class="normal"><a href="#__codelineno-0-188">188</a></span>
-<span class="normal"><a href="#__codelineno-0-189">189</a></span>
-<span class="normal"><a href="#__codelineno-0-190">190</a></span>
-<span class="normal"><a href="#__codelineno-0-191">191</a></span>
-<span class="normal"><a href="#__codelineno-0-192">192</a></span>
-<span class="normal"><a href="#__codelineno-0-193">193</a></span>
-<span class="normal"><a href="#__codelineno-0-194">194</a></span>
-<span class="normal"><a href="#__codelineno-0-195">195</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-182" name="__codelineno-0-182"></a><span class="k">class</span> <span class="nc">CSVModelChoiceField</span><span class="p">(</span><span class="n">django_forms</span><span class="o">.</span><span class="n">ModelChoiceField</span><span class="p">):</span>
-<a id="__codelineno-0-183" name="__codelineno-0-183"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-184" name="__codelineno-0-184"></a><span class="sd">    Provides additional validation for model choices entered as CSV data.</span>
-<a id="__codelineno-0-185" name="__codelineno-0-185"></a><span class="sd">    &quot;&quot;&quot;</span>
-<a id="__codelineno-0-186" name="__codelineno-0-186"></a>
-<a id="__codelineno-0-187" name="__codelineno-0-187"></a>    <span class="n">default_error_messages</span> <span class="o">=</span> <span class="p">{</span>
-<a id="__codelineno-0-188" name="__codelineno-0-188"></a>        <span class="s2">&quot;invalid_choice&quot;</span><span class="p">:</span> <span class="s2">&quot;Object not found.&quot;</span><span class="p">,</span>
-<a id="__codelineno-0-189" name="__codelineno-0-189"></a>    <span class="p">}</span>
-<a id="__codelineno-0-190" name="__codelineno-0-190"></a>
-<a id="__codelineno-0-191" name="__codelineno-0-191"></a>    <span class="k">def</span> <span class="nf">to_python</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-<a id="__codelineno-0-192" name="__codelineno-0-192"></a>        <span class="k">try</span><span class="p">:</span>
-<a id="__codelineno-0-193" name="__codelineno-0-193"></a>            <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">to_python</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
-<a id="__codelineno-0-194" name="__codelineno-0-194"></a>        <span class="k">except</span> <span class="n">MultipleObjectsReturned</span><span class="p">:</span>
-<a id="__codelineno-0-195" name="__codelineno-0-195"></a>            <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;&quot;</span><span class="si">{</span><span class="n">value</span><span class="si">}</span><span class="s1">&quot; is not a unique value for this field; multiple objects were found&#39;</span><span class="p">)</span>
+          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-148">148</a></span>
+<span class="normal"><a href="#__codelineno-0-149">149</a></span>
+<span class="normal"><a href="#__codelineno-0-150">150</a></span>
+<span class="normal"><a href="#__codelineno-0-151">151</a></span>
+<span class="normal"><a href="#__codelineno-0-152">152</a></span>
+<span class="normal"><a href="#__codelineno-0-153">153</a></span>
+<span class="normal"><a href="#__codelineno-0-154">154</a></span>
+<span class="normal"><a href="#__codelineno-0-155">155</a></span>
+<span class="normal"><a href="#__codelineno-0-156">156</a></span>
+<span class="normal"><a href="#__codelineno-0-157">157</a></span>
+<span class="normal"><a href="#__codelineno-0-158">158</a></span>
+<span class="normal"><a href="#__codelineno-0-159">159</a></span>
+<span class="normal"><a href="#__codelineno-0-160">160</a></span>
+<span class="normal"><a href="#__codelineno-0-161">161</a></span>
+<span class="normal"><a href="#__codelineno-0-162">162</a></span>
+<span class="normal"><a href="#__codelineno-0-163">163</a></span>
+<span class="normal"><a href="#__codelineno-0-164">164</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-148" name="__codelineno-0-148"></a><span class="k">class</span> <span class="nc">CSVModelChoiceField</span><span class="p">(</span><span class="n">django_forms</span><span class="o">.</span><span class="n">ModelChoiceField</span><span class="p">):</span>
+<a id="__codelineno-0-149" name="__codelineno-0-149"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-150" name="__codelineno-0-150"></a><span class="sd">    Provides additional validation for model choices entered as CSV data.</span>
+<a id="__codelineno-0-151" name="__codelineno-0-151"></a>
+<a id="__codelineno-0-152" name="__codelineno-0-152"></a><span class="sd">    Note: class name is misleading; the subclass CSVContentTypeField (below) is also used in FilterSets, where it has</span>
+<a id="__codelineno-0-153" name="__codelineno-0-153"></a><span class="sd">    nothing to do with CSV data.</span>
+<a id="__codelineno-0-154" name="__codelineno-0-154"></a><span class="sd">    &quot;&quot;&quot;</span>
+<a id="__codelineno-0-155" name="__codelineno-0-155"></a>
+<a id="__codelineno-0-156" name="__codelineno-0-156"></a>    <span class="n">default_error_messages</span> <span class="o">=</span> <span class="p">{</span>
+<a id="__codelineno-0-157" name="__codelineno-0-157"></a>        <span class="s2">&quot;invalid_choice&quot;</span><span class="p">:</span> <span class="s2">&quot;Object not found.&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-158" name="__codelineno-0-158"></a>    <span class="p">}</span>
+<a id="__codelineno-0-159" name="__codelineno-0-159"></a>
+<a id="__codelineno-0-160" name="__codelineno-0-160"></a>    <span class="k">def</span> <span class="nf">to_python</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+<a id="__codelineno-0-161" name="__codelineno-0-161"></a>        <span class="k">try</span><span class="p">:</span>
+<a id="__codelineno-0-162" name="__codelineno-0-162"></a>            <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">to_python</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
+<a id="__codelineno-0-163" name="__codelineno-0-163"></a>        <span class="k">except</span> <span class="n">MultipleObjectsReturned</span><span class="p">:</span>
+<a id="__codelineno-0-164" name="__codelineno-0-164"></a>            <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">(</span><span class="sa">f</span><span class="s1">&#39;&quot;</span><span class="si">{</span><span class="n">value</span><span class="si">}</span><span class="s1">&quot; is not a unique value for this field; multiple objects were found&#39;</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
         </details>
@@ -3340,7 +4502,9 @@ a more powerful subclass and should be used instead of directly inheriting from
         Bases: <code><span title="django.forms">forms</span>.<span title="django.forms.ModelForm">ModelForm</span></code></p>
-      <p>ModelForm used for the import of objects in CSV format.</p>
+      <p>ModelForm used for the import of objects.</p>
+<p>Note: the name is misleading as since 2.0 this is no longer used for CSV imports; however it <em>is</em> still used for
+JSON/YAML imports of DeviceTypes and their component templates.</p>
         <details class="quote">
@@ -3357,19 +4521,25 @@ a more powerful subclass and should be used instead of directly inheriting from
 <span class="normal"><a href="#__codelineno-0-147">147</a></span>
 <span class="normal"><a href="#__codelineno-0-148">148</a></span>
 <span class="normal"><a href="#__codelineno-0-149">149</a></span>
-<span class="normal"><a href="#__codelineno-0-150">150</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-138" name="__codelineno-0-138"></a><span class="k">class</span> <span class="nc">CSVModelForm</span><span class="p">(</span><span class="n">forms</span><span class="o">.</span><span class="n">ModelForm</span><span class="p">):</span>
+<span class="normal"><a href="#__codelineno-0-150">150</a></span>
+<span class="normal"><a href="#__codelineno-0-151">151</a></span>
+<span class="normal"><a href="#__codelineno-0-152">152</a></span>
+<span class="normal"><a href="#__codelineno-0-153">153</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-138" name="__codelineno-0-138"></a><span class="k">class</span> <span class="nc">CSVModelForm</span><span class="p">(</span><span class="n">forms</span><span class="o">.</span><span class="n">ModelForm</span><span class="p">):</span>
 <a id="__codelineno-0-139" name="__codelineno-0-139"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-140" name="__codelineno-0-140"></a><span class="sd">    ModelForm used for the import of objects in CSV format.</span>
-<a id="__codelineno-0-141" name="__codelineno-0-141"></a><span class="sd">    &quot;&quot;&quot;</span>
-<a id="__codelineno-0-142" name="__codelineno-0-142"></a>
-<a id="__codelineno-0-143" name="__codelineno-0-143"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="n">headers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-<a id="__codelineno-0-144" name="__codelineno-0-144"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+<a id="__codelineno-0-140" name="__codelineno-0-140"></a><span class="sd">    ModelForm used for the import of objects.</span>
+<a id="__codelineno-0-141" name="__codelineno-0-141"></a>
+<a id="__codelineno-0-142" name="__codelineno-0-142"></a><span class="sd">    Note: the name is misleading as since 2.0 this is no longer used for CSV imports; however it *is* still used for</span>
+<a id="__codelineno-0-143" name="__codelineno-0-143"></a><span class="sd">    JSON/YAML imports of DeviceTypes and their component templates.</span>
+<a id="__codelineno-0-144" name="__codelineno-0-144"></a><span class="sd">    &quot;&quot;&quot;</span>
 <a id="__codelineno-0-145" name="__codelineno-0-145"></a>
-<a id="__codelineno-0-146" name="__codelineno-0-146"></a>        <span class="c1"># Modify the model form to accommodate any customized to_field_name properties</span>
-<a id="__codelineno-0-147" name="__codelineno-0-147"></a>        <span class="k">if</span> <span class="n">headers</span><span class="p">:</span>
-<a id="__codelineno-0-148" name="__codelineno-0-148"></a>            <span class="k">for</span> <span class="n">field</span><span class="p">,</span> <span class="n">to_field</span> <span class="ow">in</span> <span class="n">headers</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-149" name="__codelineno-0-149"></a>                <span class="k">if</span> <span class="n">to_field</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
-<a id="__codelineno-0-150" name="__codelineno-0-150"></a>                    <span class="bp">self</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">to_field_name</span> <span class="o">=</span> <span class="n">to_field</span>
+<a id="__codelineno-0-146" name="__codelineno-0-146"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="n">headers</span><span class="o">=</span><span class="kc">None</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+<a id="__codelineno-0-147" name="__codelineno-0-147"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+<a id="__codelineno-0-148" name="__codelineno-0-148"></a>
+<a id="__codelineno-0-149" name="__codelineno-0-149"></a>        <span class="c1"># Modify the model form to accommodate any customized to_field_name properties</span>
+<a id="__codelineno-0-150" name="__codelineno-0-150"></a>        <span class="k">if</span> <span class="n">headers</span><span class="p">:</span>
+<a id="__codelineno-0-151" name="__codelineno-0-151"></a>            <span class="k">for</span> <span class="n">field</span><span class="p">,</span> <span class="n">to_field</span> <span class="ow">in</span> <span class="n">headers</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-152" name="__codelineno-0-152"></a>                <span class="k">if</span> <span class="n">to_field</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span><span class="p">:</span>
+<a id="__codelineno-0-153" name="__codelineno-0-153"></a>                    <span class="bp">self</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">to_field_name</span> <span class="o">=</span> <span class="n">to_field</span>
 </code></pre></div></td></tr></table></div>
         </details>
@@ -3409,32 +4579,47 @@ a more powerful subclass and should be used instead of directly inheriting from
         Bases: <code><a class="autorefs autorefs-internal" title="nautobot.core.forms.CSVModelForm" href="#nautobot.apps.forms.CSVModelForm">CSVModelForm</a></code>, <code><a class="autorefs autorefs-internal" title="nautobot.extras.forms.mixins.CustomFieldModelFormMixin" href="#nautobot.apps.forms.CustomFieldModelFormMixin">CustomFieldModelFormMixin</a></code></p>
-      <p>Base class for CSV export of models that support custom fields.</p>
+      <p>Base class for CSV/JSON/YAML import of models that support custom fields.</p>
+<p>TODO: The class name is a misnomer; as of 2.0 this class is <strong>not</strong> used for any CSV imports,
+as that's now handled by the REST API. However it is still used when importing component-templates as
+part of a JSON/YAML DeviceType import.</p>
         <details class="quote">
           <summary>Source code in <code>nautobot/extras/forms/forms.py</code></summary>
-          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-405">405</a></span>
-<span class="normal"><a href="#__codelineno-0-406">406</a></span>
-<span class="normal"><a href="#__codelineno-0-407">407</a></span>
-<span class="normal"><a href="#__codelineno-0-408">408</a></span>
-<span class="normal"><a href="#__codelineno-0-409">409</a></span>
-<span class="normal"><a href="#__codelineno-0-410">410</a></span>
+          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-410">410</a></span>
 <span class="normal"><a href="#__codelineno-0-411">411</a></span>
 <span class="normal"><a href="#__codelineno-0-412">412</a></span>
 <span class="normal"><a href="#__codelineno-0-413">413</a></span>
 <span class="normal"><a href="#__codelineno-0-414">414</a></span>
-<span class="normal"><a href="#__codelineno-0-415">415</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-405" name="__codelineno-0-405"></a><span class="k">class</span> <span class="nc">CustomFieldModelCSVForm</span><span class="p">(</span><span class="n">CSVModelForm</span><span class="p">,</span> <span class="n">CustomFieldModelFormMixin</span><span class="p">):</span>
-<a id="__codelineno-0-406" name="__codelineno-0-406"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Base class for CSV export of models that support custom fields.&quot;&quot;&quot;</span>
-<a id="__codelineno-0-407" name="__codelineno-0-407"></a>
-<a id="__codelineno-0-408" name="__codelineno-0-408"></a>    <span class="k">def</span> <span class="nf">_append_customfield_fields</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-0-409" name="__codelineno-0-409"></a>        <span class="c1"># Append form fields</span>
-<a id="__codelineno-0-410" name="__codelineno-0-410"></a>        <span class="k">for</span> <span class="n">cf</span> <span class="ow">in</span> <span class="n">CustomField</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">content_types</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">):</span>
-<a id="__codelineno-0-411" name="__codelineno-0-411"></a>            <span class="n">field_name</span> <span class="o">=</span> <span class="n">cf</span><span class="o">.</span><span class="n">add_prefix_to_cf_key</span><span class="p">()</span>
-<a id="__codelineno-0-412" name="__codelineno-0-412"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">cf</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">for_csv_import</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+<span class="normal"><a href="#__codelineno-0-415">415</a></span>
+<span class="normal"><a href="#__codelineno-0-416">416</a></span>
+<span class="normal"><a href="#__codelineno-0-417">417</a></span>
+<span class="normal"><a href="#__codelineno-0-418">418</a></span>
+<span class="normal"><a href="#__codelineno-0-419">419</a></span>
+<span class="normal"><a href="#__codelineno-0-420">420</a></span>
+<span class="normal"><a href="#__codelineno-0-421">421</a></span>
+<span class="normal"><a href="#__codelineno-0-422">422</a></span>
+<span class="normal"><a href="#__codelineno-0-423">423</a></span>
+<span class="normal"><a href="#__codelineno-0-424">424</a></span>
+<span class="normal"><a href="#__codelineno-0-425">425</a></span>
+<span class="normal"><a href="#__codelineno-0-426">426</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-410" name="__codelineno-0-410"></a><span class="k">class</span> <span class="nc">CustomFieldModelCSVForm</span><span class="p">(</span><span class="n">CSVModelForm</span><span class="p">,</span> <span class="n">CustomFieldModelFormMixin</span><span class="p">):</span>
+<a id="__codelineno-0-411" name="__codelineno-0-411"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-412" name="__codelineno-0-412"></a><span class="sd">    Base class for CSV/JSON/YAML import of models that support custom fields.</span>
 <a id="__codelineno-0-413" name="__codelineno-0-413"></a>
-<a id="__codelineno-0-414" name="__codelineno-0-414"></a>            <span class="c1"># Annotate the field in the list of CustomField form fields</span>
-<a id="__codelineno-0-415" name="__codelineno-0-415"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">custom_fields</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
+<a id="__codelineno-0-414" name="__codelineno-0-414"></a><span class="sd">    TODO: The class name is a misnomer; as of 2.0 this class is **not** used for any CSV imports,</span>
+<a id="__codelineno-0-415" name="__codelineno-0-415"></a><span class="sd">    as that&#39;s now handled by the REST API. However it is still used when importing component-templates as</span>
+<a id="__codelineno-0-416" name="__codelineno-0-416"></a><span class="sd">    part of a JSON/YAML DeviceType import.</span>
+<a id="__codelineno-0-417" name="__codelineno-0-417"></a><span class="sd">    &quot;&quot;&quot;</span>
+<a id="__codelineno-0-418" name="__codelineno-0-418"></a>
+<a id="__codelineno-0-419" name="__codelineno-0-419"></a>    <span class="k">def</span> <span class="nf">_append_customfield_fields</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-0-420" name="__codelineno-0-420"></a>        <span class="c1"># Append form fields</span>
+<a id="__codelineno-0-421" name="__codelineno-0-421"></a>        <span class="k">for</span> <span class="n">cf</span> <span class="ow">in</span> <span class="n">CustomField</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">content_types</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">):</span>
+<a id="__codelineno-0-422" name="__codelineno-0-422"></a>            <span class="n">field_name</span> <span class="o">=</span> <span class="n">cf</span><span class="o">.</span><span class="n">add_prefix_to_cf_key</span><span class="p">()</span>
+<a id="__codelineno-0-423" name="__codelineno-0-423"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">cf</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">for_csv_import</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+<a id="__codelineno-0-424" name="__codelineno-0-424"></a>
+<a id="__codelineno-0-425" name="__codelineno-0-425"></a>            <span class="c1"># Annotate the field in the list of CustomField form fields</span>
+<a id="__codelineno-0-426" name="__codelineno-0-426"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">custom_fields</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
         </details>
@@ -3477,7 +4662,12 @@ a more powerful subclass and should be used instead of directly inheriting from
         <details class="quote">
           <summary>Source code in <code>nautobot/extras/forms/mixins.py</code></summary>
-          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-90"> 90</a></span>
+          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-85"> 85</a></span>
+<span class="normal"><a href="#__codelineno-0-86"> 86</a></span>
+<span class="normal"><a href="#__codelineno-0-87"> 87</a></span>
+<span class="normal"><a href="#__codelineno-0-88"> 88</a></span>
+<span class="normal"><a href="#__codelineno-0-89"> 89</a></span>
+<span class="normal"><a href="#__codelineno-0-90"> 90</a></span>
 <span class="normal"><a href="#__codelineno-0-91"> 91</a></span>
 <span class="normal"><a href="#__codelineno-0-92"> 92</a></span>
 <span class="normal"><a href="#__codelineno-0-93"> 93</a></span>
@@ -3502,42 +4692,37 @@ a more powerful subclass and should be used instead of directly inheriting from
 <span class="normal"><a href="#__codelineno-0-112">112</a></span>
 <span class="normal"><a href="#__codelineno-0-113">113</a></span>
 <span class="normal"><a href="#__codelineno-0-114">114</a></span>
-<span class="normal"><a href="#__codelineno-0-115">115</a></span>
-<span class="normal"><a href="#__codelineno-0-116">116</a></span>
-<span class="normal"><a href="#__codelineno-0-117">117</a></span>
-<span class="normal"><a href="#__codelineno-0-118">118</a></span>
-<span class="normal"><a href="#__codelineno-0-119">119</a></span>
-<span class="normal"><a href="#__codelineno-0-120">120</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-90" name="__codelineno-0-90"></a><span class="k">class</span> <span class="nc">CustomFieldModelFormMixin</span><span class="p">(</span><span class="n">forms</span><span class="o">.</span><span class="n">ModelForm</span><span class="p">):</span>
-<a id="__codelineno-0-91" name="__codelineno-0-91"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-<a id="__codelineno-0-92" name="__codelineno-0-92"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span> <span class="o">=</span> <span class="n">ContentType</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_for_model</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_meta</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-<a id="__codelineno-0-93" name="__codelineno-0-93"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">custom_fields</span> <span class="o">=</span> <span class="p">[]</span>
-<a id="__codelineno-0-94" name="__codelineno-0-94"></a>
-<a id="__codelineno-0-95" name="__codelineno-0-95"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-<a id="__codelineno-0-96" name="__codelineno-0-96"></a>
-<a id="__codelineno-0-97" name="__codelineno-0-97"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_append_customfield_fields</span><span class="p">()</span>
-<a id="__codelineno-0-98" name="__codelineno-0-98"></a>
-<a id="__codelineno-0-99" name="__codelineno-0-99"></a>    <span class="k">def</span> <span class="nf">_append_customfield_fields</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-0-100" name="__codelineno-0-100"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-101" name="__codelineno-0-101"></a><span class="sd">        Append form fields for all CustomFields assigned to this model.</span>
-<a id="__codelineno-0-102" name="__codelineno-0-102"></a><span class="sd">        &quot;&quot;&quot;</span>
-<a id="__codelineno-0-103" name="__codelineno-0-103"></a>        <span class="c1"># Append form fields; assign initial values if modifying and existing object</span>
-<a id="__codelineno-0-104" name="__codelineno-0-104"></a>        <span class="k">for</span> <span class="n">cf</span> <span class="ow">in</span> <span class="n">CustomField</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">content_types</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">):</span>
-<a id="__codelineno-0-105" name="__codelineno-0-105"></a>            <span class="n">field_name</span> <span class="o">=</span> <span class="n">cf</span><span class="o">.</span><span class="n">add_prefix_to_cf_key</span><span class="p">()</span>
-<a id="__codelineno-0-106" name="__codelineno-0-106"></a>            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">present_in_database</span><span class="p">:</span>
-<a id="__codelineno-0-107" name="__codelineno-0-107"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">cf</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">set_initial</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
-<a id="__codelineno-0-108" name="__codelineno-0-108"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">initial</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">cf</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">cf</span><span class="o">.</span><span class="n">key</span><span class="p">)</span>
-<a id="__codelineno-0-109" name="__codelineno-0-109"></a>            <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-110" name="__codelineno-0-110"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">cf</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">()</span>
-<a id="__codelineno-0-111" name="__codelineno-0-111"></a>
-<a id="__codelineno-0-112" name="__codelineno-0-112"></a>            <span class="c1"># Annotate the field in the list of CustomField form fields</span>
-<a id="__codelineno-0-113" name="__codelineno-0-113"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">custom_fields</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
+<span class="normal"><a href="#__codelineno-0-115">115</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-85" name="__codelineno-0-85"></a><span class="k">class</span> <span class="nc">CustomFieldModelFormMixin</span><span class="p">(</span><span class="n">forms</span><span class="o">.</span><span class="n">ModelForm</span><span class="p">):</span>
+<a id="__codelineno-0-86" name="__codelineno-0-86"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+<a id="__codelineno-0-87" name="__codelineno-0-87"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span> <span class="o">=</span> <span class="n">ContentType</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_for_model</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_meta</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+<a id="__codelineno-0-88" name="__codelineno-0-88"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">custom_fields</span> <span class="o">=</span> <span class="p">[]</span>
+<a id="__codelineno-0-89" name="__codelineno-0-89"></a>
+<a id="__codelineno-0-90" name="__codelineno-0-90"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+<a id="__codelineno-0-91" name="__codelineno-0-91"></a>
+<a id="__codelineno-0-92" name="__codelineno-0-92"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_append_customfield_fields</span><span class="p">()</span>
+<a id="__codelineno-0-93" name="__codelineno-0-93"></a>
+<a id="__codelineno-0-94" name="__codelineno-0-94"></a>    <span class="k">def</span> <span class="nf">_append_customfield_fields</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-0-95" name="__codelineno-0-95"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-96" name="__codelineno-0-96"></a><span class="sd">        Append form fields for all CustomFields assigned to this model.</span>
+<a id="__codelineno-0-97" name="__codelineno-0-97"></a><span class="sd">        &quot;&quot;&quot;</span>
+<a id="__codelineno-0-98" name="__codelineno-0-98"></a>        <span class="c1"># Append form fields; assign initial values if modifying and existing object</span>
+<a id="__codelineno-0-99" name="__codelineno-0-99"></a>        <span class="k">for</span> <span class="n">cf</span> <span class="ow">in</span> <span class="n">CustomField</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">content_types</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">):</span>
+<a id="__codelineno-0-100" name="__codelineno-0-100"></a>            <span class="n">field_name</span> <span class="o">=</span> <span class="n">cf</span><span class="o">.</span><span class="n">add_prefix_to_cf_key</span><span class="p">()</span>
+<a id="__codelineno-0-101" name="__codelineno-0-101"></a>            <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">present_in_database</span><span class="p">:</span>
+<a id="__codelineno-0-102" name="__codelineno-0-102"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">cf</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">set_initial</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+<a id="__codelineno-0-103" name="__codelineno-0-103"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">initial</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">cf</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">cf</span><span class="o">.</span><span class="n">key</span><span class="p">)</span>
+<a id="__codelineno-0-104" name="__codelineno-0-104"></a>            <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-105" name="__codelineno-0-105"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">cf</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">()</span>
+<a id="__codelineno-0-106" name="__codelineno-0-106"></a>
+<a id="__codelineno-0-107" name="__codelineno-0-107"></a>            <span class="c1"># Annotate the field in the list of CustomField form fields</span>
+<a id="__codelineno-0-108" name="__codelineno-0-108"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">custom_fields</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
+<a id="__codelineno-0-109" name="__codelineno-0-109"></a>
+<a id="__codelineno-0-110" name="__codelineno-0-110"></a>    <span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-0-111" name="__codelineno-0-111"></a>        <span class="c1"># Save custom field data on instance</span>
+<a id="__codelineno-0-112" name="__codelineno-0-112"></a>        <span class="k">for</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_fields</span><span class="p">:</span>
+<a id="__codelineno-0-113" name="__codelineno-0-113"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">cf</span><span class="p">[</span><span class="n">remove_prefix_from_cf_key</span><span class="p">(</span><span class="n">field_name</span><span class="p">)]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
 <a id="__codelineno-0-114" name="__codelineno-0-114"></a>
-<a id="__codelineno-0-115" name="__codelineno-0-115"></a>    <span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-0-116" name="__codelineno-0-116"></a>        <span class="c1"># Save custom field data on instance</span>
-<a id="__codelineno-0-117" name="__codelineno-0-117"></a>        <span class="k">for</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">custom_fields</span><span class="p">:</span>
-<a id="__codelineno-0-118" name="__codelineno-0-118"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">cf</span><span class="p">[</span><span class="n">remove_prefix_from_cf_key</span><span class="p">(</span><span class="n">field_name</span><span class="p">)]</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
-<a id="__codelineno-0-119" name="__codelineno-0-119"></a>
-<a id="__codelineno-0-120" name="__codelineno-0-120"></a>        <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">()</span>
+<a id="__codelineno-0-115" name="__codelineno-0-115"></a>        <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
         </details>
@@ -3705,33 +4890,33 @@ rendered only with choices set via bound data. Choices are populated on-demand v
         <details class="quote">
           <summary>Source code in <code>nautobot/core/forms/fields.py</code></summary>
-          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-595">595</a></span>
-<span class="normal"><a href="#__codelineno-0-596">596</a></span>
-<span class="normal"><a href="#__codelineno-0-597">597</a></span>
-<span class="normal"><a href="#__codelineno-0-598">598</a></span>
-<span class="normal"><a href="#__codelineno-0-599">599</a></span>
-<span class="normal"><a href="#__codelineno-0-600">600</a></span>
-<span class="normal"><a href="#__codelineno-0-601">601</a></span>
-<span class="normal"><a href="#__codelineno-0-602">602</a></span>
-<span class="normal"><a href="#__codelineno-0-603">603</a></span>
-<span class="normal"><a href="#__codelineno-0-604">604</a></span>
-<span class="normal"><a href="#__codelineno-0-605">605</a></span>
-<span class="normal"><a href="#__codelineno-0-606">606</a></span>
-<span class="normal"><a href="#__codelineno-0-607">607</a></span>
-<span class="normal"><a href="#__codelineno-0-608">608</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-595" name="__codelineno-0-595"></a><span class="k">class</span> <span class="nc">DynamicModelChoiceField</span><span class="p">(</span><span class="n">DynamicModelChoiceMixin</span><span class="p">,</span> <span class="n">django_forms</span><span class="o">.</span><span class="n">ModelChoiceField</span><span class="p">):</span>
-<a id="__codelineno-0-596" name="__codelineno-0-596"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-597" name="__codelineno-0-597"></a><span class="sd">    Override get_bound_field() to avoid pre-populating field choices with a SQL query. The field will be</span>
-<a id="__codelineno-0-598" name="__codelineno-0-598"></a><span class="sd">    rendered only with choices set via bound data. Choices are populated on-demand via the APISelect widget.</span>
-<a id="__codelineno-0-599" name="__codelineno-0-599"></a><span class="sd">    &quot;&quot;&quot;</span>
-<a id="__codelineno-0-600" name="__codelineno-0-600"></a>
-<a id="__codelineno-0-601" name="__codelineno-0-601"></a>    <span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-<a id="__codelineno-0-602" name="__codelineno-0-602"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-603" name="__codelineno-0-603"></a><span class="sd">        When null option is enabled and &quot;None&quot; is sent as part of a form to be submitted, it is sent as the</span>
-<a id="__codelineno-0-604" name="__codelineno-0-604"></a><span class="sd">        string &#39;null&#39;.  This will check for that condition and gracefully handle the conversion to a NoneType.</span>
-<a id="__codelineno-0-605" name="__codelineno-0-605"></a><span class="sd">        &quot;&quot;&quot;</span>
-<a id="__codelineno-0-606" name="__codelineno-0-606"></a>        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">null_option</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">value</span> <span class="o">==</span> <span class="n">settings</span><span class="o">.</span><span class="n">FILTERS_NULL_CHOICE_VALUE</span><span class="p">:</span>
-<a id="__codelineno-0-607" name="__codelineno-0-607"></a>            <span class="k">return</span> <span class="kc">None</span>
-<a id="__codelineno-0-608" name="__codelineno-0-608"></a>        <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
+          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-568">568</a></span>
+<span class="normal"><a href="#__codelineno-0-569">569</a></span>
+<span class="normal"><a href="#__codelineno-0-570">570</a></span>
+<span class="normal"><a href="#__codelineno-0-571">571</a></span>
+<span class="normal"><a href="#__codelineno-0-572">572</a></span>
+<span class="normal"><a href="#__codelineno-0-573">573</a></span>
+<span class="normal"><a href="#__codelineno-0-574">574</a></span>
+<span class="normal"><a href="#__codelineno-0-575">575</a></span>
+<span class="normal"><a href="#__codelineno-0-576">576</a></span>
+<span class="normal"><a href="#__codelineno-0-577">577</a></span>
+<span class="normal"><a href="#__codelineno-0-578">578</a></span>
+<span class="normal"><a href="#__codelineno-0-579">579</a></span>
+<span class="normal"><a href="#__codelineno-0-580">580</a></span>
+<span class="normal"><a href="#__codelineno-0-581">581</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-568" name="__codelineno-0-568"></a><span class="k">class</span> <span class="nc">DynamicModelChoiceField</span><span class="p">(</span><span class="n">DynamicModelChoiceMixin</span><span class="p">,</span> <span class="n">django_forms</span><span class="o">.</span><span class="n">ModelChoiceField</span><span class="p">):</span>
+<a id="__codelineno-0-569" name="__codelineno-0-569"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-570" name="__codelineno-0-570"></a><span class="sd">    Override get_bound_field() to avoid pre-populating field choices with a SQL query. The field will be</span>
+<a id="__codelineno-0-571" name="__codelineno-0-571"></a><span class="sd">    rendered only with choices set via bound data. Choices are populated on-demand via the APISelect widget.</span>
+<a id="__codelineno-0-572" name="__codelineno-0-572"></a><span class="sd">    &quot;&quot;&quot;</span>
+<a id="__codelineno-0-573" name="__codelineno-0-573"></a>
+<a id="__codelineno-0-574" name="__codelineno-0-574"></a>    <span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+<a id="__codelineno-0-575" name="__codelineno-0-575"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-576" name="__codelineno-0-576"></a><span class="sd">        When null option is enabled and &quot;None&quot; is sent as part of a form to be submitted, it is sent as the</span>
+<a id="__codelineno-0-577" name="__codelineno-0-577"></a><span class="sd">        string &#39;null&#39;.  This will check for that condition and gracefully handle the conversion to a NoneType.</span>
+<a id="__codelineno-0-578" name="__codelineno-0-578"></a><span class="sd">        &quot;&quot;&quot;</span>
+<a id="__codelineno-0-579" name="__codelineno-0-579"></a>        <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">null_option</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">value</span> <span class="o">==</span> <span class="n">settings</span><span class="o">.</span><span class="n">FILTERS_NULL_CHOICE_VALUE</span><span class="p">:</span>
+<a id="__codelineno-0-580" name="__codelineno-0-580"></a>            <span class="k">return</span> <span class="kc">None</span>
+<a id="__codelineno-0-581" name="__codelineno-0-581"></a>        <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
         </details>
@@ -3764,21 +4949,21 @@ string 'null'.  This will check for that condition and gracefully handle the con
       <details class="quote">
         <summary>Source code in <code>nautobot/core/forms/fields.py</code></summary>
-        <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-601">601</a></span>
-<span class="normal"><a href="#__codelineno-0-602">602</a></span>
-<span class="normal"><a href="#__codelineno-0-603">603</a></span>
-<span class="normal"><a href="#__codelineno-0-604">604</a></span>
-<span class="normal"><a href="#__codelineno-0-605">605</a></span>
-<span class="normal"><a href="#__codelineno-0-606">606</a></span>
-<span class="normal"><a href="#__codelineno-0-607">607</a></span>
-<span class="normal"><a href="#__codelineno-0-608">608</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-601" name="__codelineno-0-601"></a><span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
-<a id="__codelineno-0-602" name="__codelineno-0-602"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-603" name="__codelineno-0-603"></a><span class="sd">    When null option is enabled and &quot;None&quot; is sent as part of a form to be submitted, it is sent as the</span>
-<a id="__codelineno-0-604" name="__codelineno-0-604"></a><span class="sd">    string &#39;null&#39;.  This will check for that condition and gracefully handle the conversion to a NoneType.</span>
-<a id="__codelineno-0-605" name="__codelineno-0-605"></a><span class="sd">    &quot;&quot;&quot;</span>
-<a id="__codelineno-0-606" name="__codelineno-0-606"></a>    <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">null_option</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">value</span> <span class="o">==</span> <span class="n">settings</span><span class="o">.</span><span class="n">FILTERS_NULL_CHOICE_VALUE</span><span class="p">:</span>
-<a id="__codelineno-0-607" name="__codelineno-0-607"></a>        <span class="k">return</span> <span class="kc">None</span>
-<a id="__codelineno-0-608" name="__codelineno-0-608"></a>    <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
+        <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-574">574</a></span>
+<span class="normal"><a href="#__codelineno-0-575">575</a></span>
+<span class="normal"><a href="#__codelineno-0-576">576</a></span>
+<span class="normal"><a href="#__codelineno-0-577">577</a></span>
+<span class="normal"><a href="#__codelineno-0-578">578</a></span>
+<span class="normal"><a href="#__codelineno-0-579">579</a></span>
+<span class="normal"><a href="#__codelineno-0-580">580</a></span>
+<span class="normal"><a href="#__codelineno-0-581">581</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-574" name="__codelineno-0-574"></a><span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">value</span><span class="p">):</span>
+<a id="__codelineno-0-575" name="__codelineno-0-575"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-576" name="__codelineno-0-576"></a><span class="sd">    When null option is enabled and &quot;None&quot; is sent as part of a form to be submitted, it is sent as the</span>
+<a id="__codelineno-0-577" name="__codelineno-0-577"></a><span class="sd">    string &#39;null&#39;.  This will check for that condition and gracefully handle the conversion to a NoneType.</span>
+<a id="__codelineno-0-578" name="__codelineno-0-578"></a><span class="sd">    &quot;&quot;&quot;</span>
+<a id="__codelineno-0-579" name="__codelineno-0-579"></a>    <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">null_option</span> <span class="ow">is</span> <span class="ow">not</span> <span class="kc">None</span> <span class="ow">and</span> <span class="n">value</span> <span class="o">==</span> <span class="n">settings</span><span class="o">.</span><span class="n">FILTERS_NULL_CHOICE_VALUE</span><span class="p">:</span>
+<a id="__codelineno-0-580" name="__codelineno-0-580"></a>        <span class="k">return</span> <span class="kc">None</span>
+<a id="__codelineno-0-581" name="__codelineno-0-581"></a>    <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">(</span><span class="n">value</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
       </details>
   </div>
@@ -3814,19 +4999,19 @@ string 'null'.  This will check for that condition and gracefully handle the con
         <details class="quote">
           <summary>Source code in <code>nautobot/core/forms/fields.py</code></summary>
-          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-611">611</a></span>
-<span class="normal"><a href="#__codelineno-0-612">612</a></span>
-<span class="normal"><a href="#__codelineno-0-613">613</a></span>
-<span class="normal"><a href="#__codelineno-0-614">614</a></span>
-<span class="normal"><a href="#__codelineno-0-615">615</a></span>
-<span class="normal"><a href="#__codelineno-0-616">616</a></span>
-<span class="normal"><a href="#__codelineno-0-617">617</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-611" name="__codelineno-0-611"></a><span class="k">class</span> <span class="nc">DynamicModelMultipleChoiceField</span><span class="p">(</span><span class="n">DynamicModelChoiceMixin</span><span class="p">,</span> <span class="n">django_forms</span><span class="o">.</span><span class="n">ModelMultipleChoiceField</span><span class="p">):</span>
-<a id="__codelineno-0-612" name="__codelineno-0-612"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-613" name="__codelineno-0-613"></a><span class="sd">    A multiple-choice version of DynamicModelChoiceField.</span>
-<a id="__codelineno-0-614" name="__codelineno-0-614"></a><span class="sd">    &quot;&quot;&quot;</span>
-<a id="__codelineno-0-615" name="__codelineno-0-615"></a>
-<a id="__codelineno-0-616" name="__codelineno-0-616"></a>    <span class="nb">filter</span> <span class="o">=</span> <span class="n">django_filters</span><span class="o">.</span><span class="n">ModelMultipleChoiceFilter</span>
-<a id="__codelineno-0-617" name="__codelineno-0-617"></a>    <span class="n">widget</span> <span class="o">=</span> <span class="n">widgets</span><span class="o">.</span><span class="n">APISelectMultiple</span>
+          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-584">584</a></span>
+<span class="normal"><a href="#__codelineno-0-585">585</a></span>
+<span class="normal"><a href="#__codelineno-0-586">586</a></span>
+<span class="normal"><a href="#__codelineno-0-587">587</a></span>
+<span class="normal"><a href="#__codelineno-0-588">588</a></span>
+<span class="normal"><a href="#__codelineno-0-589">589</a></span>
+<span class="normal"><a href="#__codelineno-0-590">590</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-584" name="__codelineno-0-584"></a><span class="k">class</span> <span class="nc">DynamicModelMultipleChoiceField</span><span class="p">(</span><span class="n">DynamicModelChoiceMixin</span><span class="p">,</span> <span class="n">django_forms</span><span class="o">.</span><span class="n">ModelMultipleChoiceField</span><span class="p">):</span>
+<a id="__codelineno-0-585" name="__codelineno-0-585"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-586" name="__codelineno-0-586"></a><span class="sd">    A multiple-choice version of DynamicModelChoiceField.</span>
+<a id="__codelineno-0-587" name="__codelineno-0-587"></a><span class="sd">    &quot;&quot;&quot;</span>
+<a id="__codelineno-0-588" name="__codelineno-0-588"></a>
+<a id="__codelineno-0-589" name="__codelineno-0-589"></a>    <span class="nb">filter</span> <span class="o">=</span> <span class="n">django_filters</span><span class="o">.</span><span class="n">ModelMultipleChoiceFilter</span>
+<a id="__codelineno-0-590" name="__codelineno-0-590"></a>    <span class="n">widget</span> <span class="o">=</span> <span class="n">widgets</span><span class="o">.</span><span class="n">APISelectMultiple</span>
 </code></pre></div></td></tr></table></div>
         </details>
@@ -3947,17 +5132,17 @@ NoteModelFormMixin are needed.</p>
         <details class="quote">
           <summary>Source code in <code>nautobot/extras/forms/mixins.py</code></summary>
-          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-160">160</a></span>
-<span class="normal"><a href="#__codelineno-0-161">161</a></span>
-<span class="normal"><a href="#__codelineno-0-162">162</a></span>
-<span class="normal"><a href="#__codelineno-0-163">163</a></span>
-<span class="normal"><a href="#__codelineno-0-164">164</a></span>
-<span class="normal"><a href="#__codelineno-0-165">165</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-160" name="__codelineno-0-160"></a><span class="k">class</span> <span class="nc">NoteModelBulkEditFormMixin</span><span class="p">(</span><span class="n">BulkEditForm</span><span class="p">,</span> <span class="n">NoteFormBase</span><span class="p">):</span>
-<a id="__codelineno-0-161" name="__codelineno-0-161"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Bulk-edit form mixin for models that support Notes.&quot;&quot;&quot;</span>
-<a id="__codelineno-0-162" name="__codelineno-0-162"></a>
-<a id="__codelineno-0-163" name="__codelineno-0-163"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-<a id="__codelineno-0-164" name="__codelineno-0-164"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-<a id="__codelineno-0-165" name="__codelineno-0-165"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span> <span class="o">=</span> <span class="n">ContentType</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_for_model</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-155">155</a></span>
+<span class="normal"><a href="#__codelineno-0-156">156</a></span>
+<span class="normal"><a href="#__codelineno-0-157">157</a></span>
+<span class="normal"><a href="#__codelineno-0-158">158</a></span>
+<span class="normal"><a href="#__codelineno-0-159">159</a></span>
+<span class="normal"><a href="#__codelineno-0-160">160</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-155" name="__codelineno-0-155"></a><span class="k">class</span> <span class="nc">NoteModelBulkEditFormMixin</span><span class="p">(</span><span class="n">BulkEditForm</span><span class="p">,</span> <span class="n">NoteFormBase</span><span class="p">):</span>
+<a id="__codelineno-0-156" name="__codelineno-0-156"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Bulk-edit form mixin for models that support Notes.&quot;&quot;&quot;</span>
+<a id="__codelineno-0-157" name="__codelineno-0-157"></a>
+<a id="__codelineno-0-158" name="__codelineno-0-158"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+<a id="__codelineno-0-159" name="__codelineno-0-159"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+<a id="__codelineno-0-160" name="__codelineno-0-160"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span> <span class="o">=</span> <span class="n">ContentType</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_for_model</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
         </details>
@@ -4002,7 +5187,12 @@ NoteModelFormMixin are needed.</p>
         <details class="quote">
           <summary>Source code in <code>nautobot/extras/forms/mixins.py</code></summary>
-          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-175">175</a></span>
+          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-170">170</a></span>
+<span class="normal"><a href="#__codelineno-0-171">171</a></span>
+<span class="normal"><a href="#__codelineno-0-172">172</a></span>
+<span class="normal"><a href="#__codelineno-0-173">173</a></span>
+<span class="normal"><a href="#__codelineno-0-174">174</a></span>
+<span class="normal"><a href="#__codelineno-0-175">175</a></span>
 <span class="normal"><a href="#__codelineno-0-176">176</a></span>
 <span class="normal"><a href="#__codelineno-0-177">177</a></span>
 <span class="normal"><a href="#__codelineno-0-178">178</a></span>
@@ -4264,273 +5454,274 @@ NoteModelFormMixin are needed.</p>
 <span class="normal"><a href="#__codelineno-0-434">434</a></span>
 <span class="normal"><a href="#__codelineno-0-435">435</a></span>
 <span class="normal"><a href="#__codelineno-0-436">436</a></span>
-<span class="normal"><a href="#__codelineno-0-437">437</a></span>
-<span class="normal"><a href="#__codelineno-0-438">438</a></span>
-<span class="normal"><a href="#__codelineno-0-439">439</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-175" name="__codelineno-0-175"></a><span class="k">class</span> <span class="nc">RelationshipModelBulkEditFormMixin</span><span class="p">(</span><span class="n">BulkEditForm</span><span class="p">):</span>
-<a id="__codelineno-0-176" name="__codelineno-0-176"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Bulk-edit form mixin for models that support Relationships.&quot;&quot;&quot;</span>
-<a id="__codelineno-0-177" name="__codelineno-0-177"></a>
-<a id="__codelineno-0-178" name="__codelineno-0-178"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-<a id="__codelineno-0-179" name="__codelineno-0-179"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+<span class="normal"><a href="#__codelineno-0-437">437</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-170" name="__codelineno-0-170"></a><span class="k">class</span> <span class="nc">RelationshipModelBulkEditFormMixin</span><span class="p">(</span><span class="n">BulkEditForm</span><span class="p">):</span>
+<a id="__codelineno-0-171" name="__codelineno-0-171"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Bulk-edit form mixin for models that support Relationships.&quot;&quot;&quot;</span>
+<a id="__codelineno-0-172" name="__codelineno-0-172"></a>
+<a id="__codelineno-0-173" name="__codelineno-0-173"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+<a id="__codelineno-0-174" name="__codelineno-0-174"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+<a id="__codelineno-0-175" name="__codelineno-0-175"></a>
+<a id="__codelineno-0-176" name="__codelineno-0-176"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span> <span class="o">=</span> <span class="n">ContentType</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_for_model</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+<a id="__codelineno-0-177" name="__codelineno-0-177"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span> <span class="o">=</span> <span class="p">[]</span>
+<a id="__codelineno-0-178" name="__codelineno-0-178"></a>
+<a id="__codelineno-0-179" name="__codelineno-0-179"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_append_relationships</span><span class="p">()</span>
 <a id="__codelineno-0-180" name="__codelineno-0-180"></a>
-<a id="__codelineno-0-181" name="__codelineno-0-181"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span> <span class="o">=</span> <span class="n">ContentType</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_for_model</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-<a id="__codelineno-0-182" name="__codelineno-0-182"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span> <span class="o">=</span> <span class="p">[]</span>
-<a id="__codelineno-0-183" name="__codelineno-0-183"></a>
-<a id="__codelineno-0-184" name="__codelineno-0-184"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_append_relationships</span><span class="p">()</span>
-<a id="__codelineno-0-185" name="__codelineno-0-185"></a>
-<a id="__codelineno-0-186" name="__codelineno-0-186"></a>    <span class="k">def</span> <span class="nf">_append_relationships</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-0-187" name="__codelineno-0-187"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-188" name="__codelineno-0-188"></a><span class="sd">        Append form fields for all Relationships assigned to this model.</span>
-<a id="__codelineno-0-189" name="__codelineno-0-189"></a><span class="sd">        &quot;&quot;&quot;</span>
-<a id="__codelineno-0-190" name="__codelineno-0-190"></a>        <span class="n">source_relationships</span> <span class="o">=</span> <span class="n">Relationship</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">source_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span> <span class="n">source_hidden</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
-<a id="__codelineno-0-191" name="__codelineno-0-191"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_append_relationships_side</span><span class="p">(</span><span class="n">source_relationships</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_SOURCE</span><span class="p">)</span>
-<a id="__codelineno-0-192" name="__codelineno-0-192"></a>
-<a id="__codelineno-0-193" name="__codelineno-0-193"></a>        <span class="n">dest_relationships</span> <span class="o">=</span> <span class="n">Relationship</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">destination_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span> <span class="n">destination_hidden</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
-<a id="__codelineno-0-194" name="__codelineno-0-194"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_append_relationships_side</span><span class="p">(</span><span class="n">dest_relationships</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_DESTINATION</span><span class="p">)</span>
-<a id="__codelineno-0-195" name="__codelineno-0-195"></a>
-<a id="__codelineno-0-196" name="__codelineno-0-196"></a>    <span class="k">def</span> <span class="nf">_append_relationships_side</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">relationships</span><span class="p">,</span> <span class="n">initial_side</span><span class="p">):</span>
-<a id="__codelineno-0-197" name="__codelineno-0-197"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-198" name="__codelineno-0-198"></a><span class="sd">        Helper method to _append_relationships, for processing one &quot;side&quot; of the relationships for this model.</span>
-<a id="__codelineno-0-199" name="__codelineno-0-199"></a>
-<a id="__codelineno-0-200" name="__codelineno-0-200"></a><span class="sd">        For different relationship types there are different expectations of the UI:</span>
-<a id="__codelineno-0-201" name="__codelineno-0-201"></a>
-<a id="__codelineno-0-202" name="__codelineno-0-202"></a><span class="sd">        - For one-to-one (symmetric or non-symmetric) it doesn&#39;t make sense to bulk-set this relationship,</span>
-<a id="__codelineno-0-203" name="__codelineno-0-203"></a><span class="sd">          but we want it to be clearable/nullable.</span>
-<a id="__codelineno-0-204" name="__codelineno-0-204"></a><span class="sd">        - For one-to-many (from the source, &quot;one&quot;, side) we likewise want it clearable/nullable but not settable.</span>
-<a id="__codelineno-0-205" name="__codelineno-0-205"></a><span class="sd">        - For one-to-many (from the destination, &quot;many&quot;, side) a single value can be set, or it can be nulled.</span>
-<a id="__codelineno-0-206" name="__codelineno-0-206"></a><span class="sd">        - For many-to-many (symmetric or non-symmetric) we provide &quot;add&quot; and &quot;remove&quot; multi-select fields,</span>
-<a id="__codelineno-0-207" name="__codelineno-0-207"></a><span class="sd">          similar to the TagsBulkEditFormMixin behavior. No nullability is provided here.</span>
-<a id="__codelineno-0-208" name="__codelineno-0-208"></a><span class="sd">        &quot;&quot;&quot;</span>
-<a id="__codelineno-0-209" name="__codelineno-0-209"></a>        <span class="k">for</span> <span class="n">relationship</span> <span class="ow">in</span> <span class="n">relationships</span><span class="p">:</span>
-<a id="__codelineno-0-210" name="__codelineno-0-210"></a>            <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">symmetric</span><span class="p">:</span>
-<a id="__codelineno-0-211" name="__codelineno-0-211"></a>                <span class="n">side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span>
-<a id="__codelineno-0-212" name="__codelineno-0-212"></a>            <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-213" name="__codelineno-0-213"></a>                <span class="n">side</span> <span class="o">=</span> <span class="n">initial_side</span>
-<a id="__codelineno-0-214" name="__codelineno-0-214"></a>            <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
-<a id="__codelineno-0-215" name="__codelineno-0-215"></a>
-<a id="__codelineno-0-216" name="__codelineno-0-216"></a>            <span class="c1"># If this model is on the &quot;source&quot; side of the relationship, then the field will be named</span>
-<a id="__codelineno-0-217" name="__codelineno-0-217"></a>            <span class="c1"># &quot;cr_&lt;relationship-slug&gt;__destination&quot; since it&#39;s used to pick the destination object(s).</span>
-<a id="__codelineno-0-218" name="__codelineno-0-218"></a>            <span class="c1"># If we&#39;re on the &quot;destination&quot; side, the field will be &quot;cr_&lt;relationship-slug&gt;__source&quot;.</span>
-<a id="__codelineno-0-219" name="__codelineno-0-219"></a>            <span class="c1"># For a symmetric relationship, both sides are &quot;peer&quot;, so the field will be &quot;cr_&lt;relationship-slug&gt;__peer&quot;</span>
-<a id="__codelineno-0-220" name="__codelineno-0-220"></a>            <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">slug</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
+<a id="__codelineno-0-181" name="__codelineno-0-181"></a>    <span class="k">def</span> <span class="nf">_append_relationships</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-0-182" name="__codelineno-0-182"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-183" name="__codelineno-0-183"></a><span class="sd">        Append form fields for all Relationships assigned to this model.</span>
+<a id="__codelineno-0-184" name="__codelineno-0-184"></a><span class="sd">        &quot;&quot;&quot;</span>
+<a id="__codelineno-0-185" name="__codelineno-0-185"></a>        <span class="n">source_relationships</span> <span class="o">=</span> <span class="n">Relationship</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">source_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span> <span class="n">source_hidden</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+<a id="__codelineno-0-186" name="__codelineno-0-186"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_append_relationships_side</span><span class="p">(</span><span class="n">source_relationships</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_SOURCE</span><span class="p">)</span>
+<a id="__codelineno-0-187" name="__codelineno-0-187"></a>
+<a id="__codelineno-0-188" name="__codelineno-0-188"></a>        <span class="n">dest_relationships</span> <span class="o">=</span> <span class="n">Relationship</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="n">destination_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span> <span class="n">destination_hidden</span><span class="o">=</span><span class="kc">False</span><span class="p">)</span>
+<a id="__codelineno-0-189" name="__codelineno-0-189"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_append_relationships_side</span><span class="p">(</span><span class="n">dest_relationships</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_DESTINATION</span><span class="p">)</span>
+<a id="__codelineno-0-190" name="__codelineno-0-190"></a>
+<a id="__codelineno-0-191" name="__codelineno-0-191"></a>    <span class="k">def</span> <span class="nf">_append_relationships_side</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">relationships</span><span class="p">,</span> <span class="n">initial_side</span><span class="p">):</span>
+<a id="__codelineno-0-192" name="__codelineno-0-192"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-193" name="__codelineno-0-193"></a><span class="sd">        Helper method to _append_relationships, for processing one &quot;side&quot; of the relationships for this model.</span>
+<a id="__codelineno-0-194" name="__codelineno-0-194"></a>
+<a id="__codelineno-0-195" name="__codelineno-0-195"></a><span class="sd">        For different relationship types there are different expectations of the UI:</span>
+<a id="__codelineno-0-196" name="__codelineno-0-196"></a>
+<a id="__codelineno-0-197" name="__codelineno-0-197"></a><span class="sd">        - For one-to-one (symmetric or non-symmetric) it doesn&#39;t make sense to bulk-set this relationship,</span>
+<a id="__codelineno-0-198" name="__codelineno-0-198"></a><span class="sd">          but we want it to be clearable/nullable.</span>
+<a id="__codelineno-0-199" name="__codelineno-0-199"></a><span class="sd">        - For one-to-many (from the source, &quot;one&quot;, side) we likewise want it clearable/nullable but not settable.</span>
+<a id="__codelineno-0-200" name="__codelineno-0-200"></a><span class="sd">        - For one-to-many (from the destination, &quot;many&quot;, side) a single value can be set, or it can be nulled.</span>
+<a id="__codelineno-0-201" name="__codelineno-0-201"></a><span class="sd">        - For many-to-many (symmetric or non-symmetric) we provide &quot;add&quot; and &quot;remove&quot; multi-select fields,</span>
+<a id="__codelineno-0-202" name="__codelineno-0-202"></a><span class="sd">          similar to the TagsBulkEditFormMixin behavior. No nullability is provided here.</span>
+<a id="__codelineno-0-203" name="__codelineno-0-203"></a><span class="sd">        &quot;&quot;&quot;</span>
+<a id="__codelineno-0-204" name="__codelineno-0-204"></a>        <span class="k">for</span> <span class="n">relationship</span> <span class="ow">in</span> <span class="n">relationships</span><span class="p">:</span>
+<a id="__codelineno-0-205" name="__codelineno-0-205"></a>            <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">symmetric</span><span class="p">:</span>
+<a id="__codelineno-0-206" name="__codelineno-0-206"></a>                <span class="n">side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span>
+<a id="__codelineno-0-207" name="__codelineno-0-207"></a>            <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-208" name="__codelineno-0-208"></a>                <span class="n">side</span> <span class="o">=</span> <span class="n">initial_side</span>
+<a id="__codelineno-0-209" name="__codelineno-0-209"></a>            <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
+<a id="__codelineno-0-210" name="__codelineno-0-210"></a>
+<a id="__codelineno-0-211" name="__codelineno-0-211"></a>            <span class="c1"># If this model is on the &quot;source&quot; side of the relationship, then the field will be named</span>
+<a id="__codelineno-0-212" name="__codelineno-0-212"></a>            <span class="c1"># &quot;cr_&lt;relationship_key&gt;__destination&quot; since it&#39;s used to pick the destination object(s).</span>
+<a id="__codelineno-0-213" name="__codelineno-0-213"></a>            <span class="c1"># If we&#39;re on the &quot;destination&quot; side, the field will be &quot;cr_&lt;relationship_key&gt;__source&quot;.</span>
+<a id="__codelineno-0-214" name="__codelineno-0-214"></a>            <span class="c1"># For a symmetric relationship, both sides are &quot;peer&quot;, so the field will be &quot;cr_&lt;relationship_key&gt;__peer&quot;</span>
+<a id="__codelineno-0-215" name="__codelineno-0-215"></a>            <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">key</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
+<a id="__codelineno-0-216" name="__codelineno-0-216"></a>
+<a id="__codelineno-0-217" name="__codelineno-0-217"></a>            <span class="k">if</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span><span class="p">:</span>
+<a id="__codelineno-0-218" name="__codelineno-0-218"></a>                <span class="c1"># This is a symmetric relationship that we already processed from the opposing &quot;initial_side&quot;.</span>
+<a id="__codelineno-0-219" name="__codelineno-0-219"></a>                <span class="c1"># No need to process it a second time!</span>
+<a id="__codelineno-0-220" name="__codelineno-0-220"></a>                <span class="k">continue</span>
 <a id="__codelineno-0-221" name="__codelineno-0-221"></a>
-<a id="__codelineno-0-222" name="__codelineno-0-222"></a>            <span class="k">if</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span><span class="p">:</span>
-<a id="__codelineno-0-223" name="__codelineno-0-223"></a>                <span class="c1"># This is a symmetric relationship that we already processed from the opposing &quot;initial_side&quot;.</span>
-<a id="__codelineno-0-224" name="__codelineno-0-224"></a>                <span class="c1"># No need to process it a second time!</span>
-<a id="__codelineno-0-225" name="__codelineno-0-225"></a>                <span class="k">continue</span>
-<a id="__codelineno-0-226" name="__codelineno-0-226"></a>
-<a id="__codelineno-0-227" name="__codelineno-0-227"></a>            <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">side</span><span class="p">):</span>
-<a id="__codelineno-0-228" name="__codelineno-0-228"></a>                <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">type</span> <span class="o">==</span> <span class="n">RelationshipTypeChoices</span><span class="o">.</span><span class="n">TYPE_ONE_TO_MANY</span><span class="p">:</span>
-<a id="__codelineno-0-229" name="__codelineno-0-229"></a>                    <span class="c1"># Destination side of a one-to-many field - provide a standard form field for selecting the &quot;one&quot;,</span>
-<a id="__codelineno-0-230" name="__codelineno-0-230"></a>                    <span class="c1"># as well as making this field nullable.</span>
-<a id="__codelineno-0-231" name="__codelineno-0-231"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">relationship</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">side</span><span class="o">=</span><span class="n">side</span><span class="p">)</span>
-<a id="__codelineno-0-232" name="__codelineno-0-232"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">nullable_fields</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
-<a id="__codelineno-0-233" name="__codelineno-0-233"></a>                <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-234" name="__codelineno-0-234"></a>                    <span class="c1"># Many-to-many field - provide &quot;add&quot; and &quot;remove&quot; form fields like with tags, no nullable option.</span>
-<a id="__codelineno-0-235" name="__codelineno-0-235"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">relationship</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">side</span><span class="o">=</span><span class="n">side</span><span class="p">)</span>
-<a id="__codelineno-0-236" name="__codelineno-0-236"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">label</span> <span class="o">=</span> <span class="s2">&quot;Add &quot;</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">label</span>
-<a id="__codelineno-0-237" name="__codelineno-0-237"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">relationship</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">side</span><span class="o">=</span><span class="n">side</span><span class="p">)</span>
-<a id="__codelineno-0-238" name="__codelineno-0-238"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">label</span> <span class="o">=</span> <span class="s2">&quot;Remove &quot;</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">label</span>
-<a id="__codelineno-0-239" name="__codelineno-0-239"></a>            <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-240" name="__codelineno-0-240"></a>                <span class="c1"># The &quot;one&quot; side of a one-to-one or one-to-many relationship.</span>
-<a id="__codelineno-0-241" name="__codelineno-0-241"></a>                <span class="c1"># In this case, the only valid bulk-edit operation is nulling/clearing the relationship,</span>
-<a id="__codelineno-0-242" name="__codelineno-0-242"></a>                <span class="c1"># but the &quot;Set null&quot; checkbox only appears if we have a form field for the the relationship itself.</span>
-<a id="__codelineno-0-243" name="__codelineno-0-243"></a>                <span class="c1"># This could probably be refined, but for now we just add the field and disable it.</span>
-<a id="__codelineno-0-244" name="__codelineno-0-244"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">relationship</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">side</span><span class="o">=</span><span class="n">side</span><span class="p">)</span>
-<a id="__codelineno-0-245" name="__codelineno-0-245"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">disabled</span> <span class="o">=</span> <span class="kc">True</span>
-<a id="__codelineno-0-246" name="__codelineno-0-246"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">nullable_fields</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
-<a id="__codelineno-0-247" name="__codelineno-0-247"></a>
-<a id="__codelineno-0-248" name="__codelineno-0-248"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
-<a id="__codelineno-0-249" name="__codelineno-0-249"></a>
-<a id="__codelineno-0-250" name="__codelineno-0-250"></a>    <span class="k">def</span> <span class="nf">save_relationships</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">instance</span><span class="p">,</span> <span class="n">nullified_fields</span><span class="p">):</span>
-<a id="__codelineno-0-251" name="__codelineno-0-251"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Helper method to be called from BulkEditView.post().&quot;&quot;&quot;</span>
-<a id="__codelineno-0-252" name="__codelineno-0-252"></a>        <span class="c1"># The below may seem inefficient as it re-loads the Relationship objects afresh for each instance;</span>
-<a id="__codelineno-0-253" name="__codelineno-0-253"></a>        <span class="c1"># however this is necessary as it applies the source/destination filters (if any) to determine</span>
-<a id="__codelineno-0-254" name="__codelineno-0-254"></a>        <span class="c1"># whether each relationship actually applies to the given instance.</span>
-<a id="__codelineno-0-255" name="__codelineno-0-255"></a>        <span class="n">instance_relationships</span> <span class="o">=</span> <span class="n">instance</span><span class="o">.</span><span class="n">get_relationships</span><span class="p">(</span><span class="n">include_hidden</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-<a id="__codelineno-0-256" name="__codelineno-0-256"></a>
-<a id="__codelineno-0-257" name="__codelineno-0-257"></a>        <span class="k">for</span> <span class="n">side</span><span class="p">,</span> <span class="n">relationships_data</span> <span class="ow">in</span> <span class="n">instance_relationships</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-258" name="__codelineno-0-258"></a>            <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
-<a id="__codelineno-0-259" name="__codelineno-0-259"></a>            <span class="k">for</span> <span class="n">relationship</span><span class="p">,</span> <span class="n">relationshipassociation_queryset</span> <span class="ow">in</span> <span class="n">relationships_data</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-260" name="__codelineno-0-260"></a>                <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">slug</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
-<a id="__codelineno-0-261" name="__codelineno-0-261"></a>                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-<a id="__codelineno-0-262" name="__codelineno-0-262"></a>                    <span class="s2">&quot;Processing relationship </span><span class="si">%s</span><span class="s2"> </span><span class="si">%s</span><span class="s2"> (field </span><span class="si">%s</span><span class="s2">) for instance </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span>
-<a id="__codelineno-0-263" name="__codelineno-0-263"></a>                    <span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-264" name="__codelineno-0-264"></a>                    <span class="n">side</span><span class="p">,</span>
-<a id="__codelineno-0-265" name="__codelineno-0-265"></a>                    <span class="n">field_name</span><span class="p">,</span>
-<a id="__codelineno-0-266" name="__codelineno-0-266"></a>                    <span class="n">instance</span><span class="p">,</span>
-<a id="__codelineno-0-267" name="__codelineno-0-267"></a>                <span class="p">)</span>
-<a id="__codelineno-0-268" name="__codelineno-0-268"></a>                <span class="k">if</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">nullable_fields</span> <span class="ow">and</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="n">nullified_fields</span><span class="p">:</span>
-<a id="__codelineno-0-269" name="__codelineno-0-269"></a>                    <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Deleting existing relationship associations for </span><span class="si">%s</span><span class="s2"> on </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">relationship</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>
-<a id="__codelineno-0-270" name="__codelineno-0-270"></a>                    <span class="n">relationshipassociation_queryset</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
-<a id="__codelineno-0-271" name="__codelineno-0-271"></a>                <span class="k">elif</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
-<a id="__codelineno-0-272" name="__codelineno-0-272"></a>                    <span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
-<a id="__codelineno-0-273" name="__codelineno-0-273"></a>                    <span class="k">if</span> <span class="n">value</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">peer_side</span><span class="p">):</span>
-<a id="__codelineno-0-274" name="__codelineno-0-274"></a>                        <span class="n">ra</span><span class="p">,</span> <span class="n">created</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">update_or_create</span><span class="p">(</span>
-<a id="__codelineno-0-275" name="__codelineno-0-275"></a>                            <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-276" name="__codelineno-0-276"></a>                            <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
-<a id="__codelineno-0-277" name="__codelineno-0-277"></a>                            <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
-<a id="__codelineno-0-278" name="__codelineno-0-278"></a>                            <span class="n">defaults</span><span class="o">=</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">value</span><span class="o">.</span><span class="n">pk</span><span class="p">},</span>
-<a id="__codelineno-0-279" name="__codelineno-0-279"></a>                            <span class="o">**</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">},</span>
-<a id="__codelineno-0-280" name="__codelineno-0-280"></a>                        <span class="p">)</span>
-<a id="__codelineno-0-281" name="__codelineno-0-281"></a>                        <span class="k">if</span> <span class="n">created</span><span class="p">:</span>
-<a id="__codelineno-0-282" name="__codelineno-0-282"></a>                            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Created </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
-<a id="__codelineno-0-283" name="__codelineno-0-283"></a>                        <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-284" name="__codelineno-0-284"></a>                            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Updated </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
-<a id="__codelineno-0-285" name="__codelineno-0-285"></a>                <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-286" name="__codelineno-0-286"></a>                    <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
-<a id="__codelineno-0-287" name="__codelineno-0-287"></a>                        <span class="n">added</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-<a id="__codelineno-0-288" name="__codelineno-0-288"></a>                        <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">added</span><span class="p">:</span>
-<a id="__codelineno-0-289" name="__codelineno-0-289"></a>                            <span class="k">if</span> <span class="n">peer_side</span> <span class="o">!=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">:</span>
-<a id="__codelineno-0-290" name="__codelineno-0-290"></a>                                <span class="n">ra</span><span class="p">,</span> <span class="n">created</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_or_create</span><span class="p">(</span>
-<a id="__codelineno-0-291" name="__codelineno-0-291"></a>                                    <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-292" name="__codelineno-0-292"></a>                                    <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
-<a id="__codelineno-0-293" name="__codelineno-0-293"></a>                                    <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
-<a id="__codelineno-0-294" name="__codelineno-0-294"></a>                                    <span class="o">**</span><span class="p">{</span>
-<a id="__codelineno-0-295" name="__codelineno-0-295"></a>                                        <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-296" name="__codelineno-0-296"></a>                                        <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-297" name="__codelineno-0-297"></a>                                    <span class="p">},</span>
-<a id="__codelineno-0-298" name="__codelineno-0-298"></a>                                <span class="p">)</span>
-<a id="__codelineno-0-299" name="__codelineno-0-299"></a>                            <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-300" name="__codelineno-0-300"></a>                                <span class="k">if</span> <span class="p">(</span>
-<a id="__codelineno-0-301" name="__codelineno-0-301"></a>                                    <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-222" name="__codelineno-0-222"></a>            <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">side</span><span class="p">):</span>
+<a id="__codelineno-0-223" name="__codelineno-0-223"></a>                <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">type</span> <span class="o">==</span> <span class="n">RelationshipTypeChoices</span><span class="o">.</span><span class="n">TYPE_ONE_TO_MANY</span><span class="p">:</span>
+<a id="__codelineno-0-224" name="__codelineno-0-224"></a>                    <span class="c1"># Destination side of a one-to-many field - provide a standard form field for selecting the &quot;one&quot;,</span>
+<a id="__codelineno-0-225" name="__codelineno-0-225"></a>                    <span class="c1"># as well as making this field nullable.</span>
+<a id="__codelineno-0-226" name="__codelineno-0-226"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">relationship</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">side</span><span class="o">=</span><span class="n">side</span><span class="p">)</span>
+<a id="__codelineno-0-227" name="__codelineno-0-227"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">nullable_fields</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
+<a id="__codelineno-0-228" name="__codelineno-0-228"></a>                <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-229" name="__codelineno-0-229"></a>                    <span class="c1"># Many-to-many field - provide &quot;add&quot; and &quot;remove&quot; form fields like with tags, no nullable option.</span>
+<a id="__codelineno-0-230" name="__codelineno-0-230"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">relationship</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">side</span><span class="o">=</span><span class="n">side</span><span class="p">)</span>
+<a id="__codelineno-0-231" name="__codelineno-0-231"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">label</span> <span class="o">=</span> <span class="s2">&quot;Add &quot;</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">label</span>
+<a id="__codelineno-0-232" name="__codelineno-0-232"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">relationship</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">side</span><span class="o">=</span><span class="n">side</span><span class="p">)</span>
+<a id="__codelineno-0-233" name="__codelineno-0-233"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">label</span> <span class="o">=</span> <span class="s2">&quot;Remove &quot;</span> <span class="o">+</span> <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span><span class="o">.</span><span class="n">label</span>
+<a id="__codelineno-0-234" name="__codelineno-0-234"></a>            <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-235" name="__codelineno-0-235"></a>                <span class="c1"># The &quot;one&quot; side of a one-to-one or one-to-many relationship.</span>
+<a id="__codelineno-0-236" name="__codelineno-0-236"></a>                <span class="c1"># In this case, the only valid bulk-edit operation is nulling/clearing the relationship,</span>
+<a id="__codelineno-0-237" name="__codelineno-0-237"></a>                <span class="c1"># but the &quot;Set null&quot; checkbox only appears if we have a form field for the the relationship itself.</span>
+<a id="__codelineno-0-238" name="__codelineno-0-238"></a>                <span class="c1"># This could probably be refined, but for now we just add the field and disable it.</span>
+<a id="__codelineno-0-239" name="__codelineno-0-239"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">relationship</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">side</span><span class="o">=</span><span class="n">side</span><span class="p">)</span>
+<a id="__codelineno-0-240" name="__codelineno-0-240"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">disabled</span> <span class="o">=</span> <span class="kc">True</span>
+<a id="__codelineno-0-241" name="__codelineno-0-241"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">nullable_fields</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
+<a id="__codelineno-0-242" name="__codelineno-0-242"></a>
+<a id="__codelineno-0-243" name="__codelineno-0-243"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
+<a id="__codelineno-0-244" name="__codelineno-0-244"></a>
+<a id="__codelineno-0-245" name="__codelineno-0-245"></a>    <span class="k">def</span> <span class="nf">save_relationships</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">instance</span><span class="p">,</span> <span class="n">nullified_fields</span><span class="p">):</span>
+<a id="__codelineno-0-246" name="__codelineno-0-246"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Helper method to be called from BulkEditView.post().&quot;&quot;&quot;</span>
+<a id="__codelineno-0-247" name="__codelineno-0-247"></a>        <span class="c1"># The below may seem inefficient as it re-loads the Relationship objects afresh for each instance;</span>
+<a id="__codelineno-0-248" name="__codelineno-0-248"></a>        <span class="c1"># however this is necessary as it applies the source/destination filters (if any) to determine</span>
+<a id="__codelineno-0-249" name="__codelineno-0-249"></a>        <span class="c1"># whether each relationship actually applies to the given instance.</span>
+<a id="__codelineno-0-250" name="__codelineno-0-250"></a>        <span class="n">instance_relationships</span> <span class="o">=</span> <span class="n">instance</span><span class="o">.</span><span class="n">get_relationships</span><span class="p">(</span><span class="n">include_hidden</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+<a id="__codelineno-0-251" name="__codelineno-0-251"></a>
+<a id="__codelineno-0-252" name="__codelineno-0-252"></a>        <span class="k">for</span> <span class="n">side</span><span class="p">,</span> <span class="n">relationships_data</span> <span class="ow">in</span> <span class="n">instance_relationships</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-253" name="__codelineno-0-253"></a>            <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
+<a id="__codelineno-0-254" name="__codelineno-0-254"></a>            <span class="k">for</span> <span class="n">relationship</span><span class="p">,</span> <span class="n">relationshipassociation_queryset</span> <span class="ow">in</span> <span class="n">relationships_data</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-255" name="__codelineno-0-255"></a>                <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">key</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
+<a id="__codelineno-0-256" name="__codelineno-0-256"></a>                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+<a id="__codelineno-0-257" name="__codelineno-0-257"></a>                    <span class="s2">&quot;Processing relationship </span><span class="si">%s</span><span class="s2"> </span><span class="si">%s</span><span class="s2"> (field </span><span class="si">%s</span><span class="s2">) for instance </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-258" name="__codelineno-0-258"></a>                    <span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-259" name="__codelineno-0-259"></a>                    <span class="n">side</span><span class="p">,</span>
+<a id="__codelineno-0-260" name="__codelineno-0-260"></a>                    <span class="n">field_name</span><span class="p">,</span>
+<a id="__codelineno-0-261" name="__codelineno-0-261"></a>                    <span class="n">instance</span><span class="p">,</span>
+<a id="__codelineno-0-262" name="__codelineno-0-262"></a>                <span class="p">)</span>
+<a id="__codelineno-0-263" name="__codelineno-0-263"></a>                <span class="k">if</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">nullable_fields</span> <span class="ow">and</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="n">nullified_fields</span><span class="p">:</span>
+<a id="__codelineno-0-264" name="__codelineno-0-264"></a>                    <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Deleting existing relationship associations for </span><span class="si">%s</span><span class="s2"> on </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">relationship</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>
+<a id="__codelineno-0-265" name="__codelineno-0-265"></a>                    <span class="n">relationshipassociation_queryset</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
+<a id="__codelineno-0-266" name="__codelineno-0-266"></a>                <span class="k">elif</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
+<a id="__codelineno-0-267" name="__codelineno-0-267"></a>                    <span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
+<a id="__codelineno-0-268" name="__codelineno-0-268"></a>                    <span class="k">if</span> <span class="n">value</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">peer_side</span><span class="p">):</span>
+<a id="__codelineno-0-269" name="__codelineno-0-269"></a>                        <span class="n">ra</span><span class="p">,</span> <span class="n">created</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">update_or_create</span><span class="p">(</span>
+<a id="__codelineno-0-270" name="__codelineno-0-270"></a>                            <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-271" name="__codelineno-0-271"></a>                            <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
+<a id="__codelineno-0-272" name="__codelineno-0-272"></a>                            <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
+<a id="__codelineno-0-273" name="__codelineno-0-273"></a>                            <span class="n">defaults</span><span class="o">=</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">value</span><span class="o">.</span><span class="n">pk</span><span class="p">},</span>
+<a id="__codelineno-0-274" name="__codelineno-0-274"></a>                            <span class="o">**</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">},</span>
+<a id="__codelineno-0-275" name="__codelineno-0-275"></a>                        <span class="p">)</span>
+<a id="__codelineno-0-276" name="__codelineno-0-276"></a>                        <span class="k">if</span> <span class="n">created</span><span class="p">:</span>
+<a id="__codelineno-0-277" name="__codelineno-0-277"></a>                            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Created </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
+<a id="__codelineno-0-278" name="__codelineno-0-278"></a>                        <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-279" name="__codelineno-0-279"></a>                            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Updated </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
+<a id="__codelineno-0-280" name="__codelineno-0-280"></a>                <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-281" name="__codelineno-0-281"></a>                    <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
+<a id="__codelineno-0-282" name="__codelineno-0-282"></a>                        <span class="n">added</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-283" name="__codelineno-0-283"></a>                        <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">added</span><span class="p">:</span>
+<a id="__codelineno-0-284" name="__codelineno-0-284"></a>                            <span class="k">if</span> <span class="n">peer_side</span> <span class="o">!=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">:</span>
+<a id="__codelineno-0-285" name="__codelineno-0-285"></a>                                <span class="n">ra</span><span class="p">,</span> <span class="n">created</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_or_create</span><span class="p">(</span>
+<a id="__codelineno-0-286" name="__codelineno-0-286"></a>                                    <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-287" name="__codelineno-0-287"></a>                                    <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
+<a id="__codelineno-0-288" name="__codelineno-0-288"></a>                                    <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
+<a id="__codelineno-0-289" name="__codelineno-0-289"></a>                                    <span class="o">**</span><span class="p">{</span>
+<a id="__codelineno-0-290" name="__codelineno-0-290"></a>                                        <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-291" name="__codelineno-0-291"></a>                                        <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-292" name="__codelineno-0-292"></a>                                    <span class="p">},</span>
+<a id="__codelineno-0-293" name="__codelineno-0-293"></a>                                <span class="p">)</span>
+<a id="__codelineno-0-294" name="__codelineno-0-294"></a>                            <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-295" name="__codelineno-0-295"></a>                                <span class="k">if</span> <span class="p">(</span>
+<a id="__codelineno-0-296" name="__codelineno-0-296"></a>                                    <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-297" name="__codelineno-0-297"></a>                                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-298" name="__codelineno-0-298"></a>                                        <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-299" name="__codelineno-0-299"></a>                                        <span class="n">destination_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-300" name="__codelineno-0-300"></a>                                    <span class="p">)</span><span class="o">.</span><span class="n">exists</span><span class="p">()</span>
+<a id="__codelineno-0-301" name="__codelineno-0-301"></a>                                    <span class="ow">or</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
 <a id="__codelineno-0-302" name="__codelineno-0-302"></a>                                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-303" name="__codelineno-0-303"></a>                                        <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-304" name="__codelineno-0-304"></a>                                        <span class="n">destination_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-303" name="__codelineno-0-303"></a>                                        <span class="n">source_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-304" name="__codelineno-0-304"></a>                                        <span class="n">destination_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
 <a id="__codelineno-0-305" name="__codelineno-0-305"></a>                                    <span class="p">)</span><span class="o">.</span><span class="n">exists</span><span class="p">()</span>
-<a id="__codelineno-0-306" name="__codelineno-0-306"></a>                                    <span class="ow">or</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
-<a id="__codelineno-0-307" name="__codelineno-0-307"></a>                                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-308" name="__codelineno-0-308"></a>                                        <span class="n">source_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-309" name="__codelineno-0-309"></a>                                        <span class="n">destination_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-310" name="__codelineno-0-310"></a>                                    <span class="p">)</span><span class="o">.</span><span class="n">exists</span><span class="p">()</span>
-<a id="__codelineno-0-311" name="__codelineno-0-311"></a>                                <span class="p">):</span>
-<a id="__codelineno-0-312" name="__codelineno-0-312"></a>                                    <span class="n">ra</span> <span class="o">=</span> <span class="kc">None</span>
-<a id="__codelineno-0-313" name="__codelineno-0-313"></a>                                    <span class="n">created</span> <span class="o">=</span> <span class="kc">False</span>
-<a id="__codelineno-0-314" name="__codelineno-0-314"></a>                                <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-315" name="__codelineno-0-315"></a>                                    <span class="n">ra</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-<a id="__codelineno-0-316" name="__codelineno-0-316"></a>                                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-317" name="__codelineno-0-317"></a>                                        <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
-<a id="__codelineno-0-318" name="__codelineno-0-318"></a>                                        <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-319" name="__codelineno-0-319"></a>                                        <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
-<a id="__codelineno-0-320" name="__codelineno-0-320"></a>                                        <span class="n">destination_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-321" name="__codelineno-0-321"></a>                                    <span class="p">)</span>
-<a id="__codelineno-0-322" name="__codelineno-0-322"></a>                                    <span class="n">created</span> <span class="o">=</span> <span class="kc">True</span>
-<a id="__codelineno-0-323" name="__codelineno-0-323"></a>
-<a id="__codelineno-0-324" name="__codelineno-0-324"></a>                            <span class="k">if</span> <span class="n">created</span><span class="p">:</span>
-<a id="__codelineno-0-325" name="__codelineno-0-325"></a>                                <span class="n">ra</span><span class="o">.</span><span class="n">validated_save</span><span class="p">()</span>
-<a id="__codelineno-0-326" name="__codelineno-0-326"></a>                                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Created </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
-<a id="__codelineno-0-327" name="__codelineno-0-327"></a>
-<a id="__codelineno-0-328" name="__codelineno-0-328"></a>                    <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
-<a id="__codelineno-0-329" name="__codelineno-0-329"></a>                        <span class="n">removed</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-<a id="__codelineno-0-330" name="__codelineno-0-330"></a>
-<a id="__codelineno-0-331" name="__codelineno-0-331"></a>                        <span class="n">source_count</span> <span class="o">=</span> <span class="mi">0</span>
-<a id="__codelineno-0-332" name="__codelineno-0-332"></a>                        <span class="n">destination_count</span> <span class="o">=</span> <span class="mi">0</span>
-<a id="__codelineno-0-333" name="__codelineno-0-333"></a>                        <span class="k">if</span> <span class="n">side</span> <span class="ow">in</span> <span class="p">[</span><span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_SOURCE</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">]:</span>
-<a id="__codelineno-0-334" name="__codelineno-0-334"></a>                            <span class="n">source_count</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
-<a id="__codelineno-0-335" name="__codelineno-0-335"></a>                                <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-336" name="__codelineno-0-336"></a>                                <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-337" name="__codelineno-0-337"></a>                                <span class="n">destination_id__in</span><span class="o">=</span><span class="p">[</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span> <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">removed</span><span class="p">],</span>
-<a id="__codelineno-0-338" name="__codelineno-0-338"></a>                            <span class="p">)</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
-<a id="__codelineno-0-339" name="__codelineno-0-339"></a>                        <span class="k">if</span> <span class="n">side</span> <span class="ow">in</span> <span class="p">[</span><span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_DESTINATION</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">]:</span>
-<a id="__codelineno-0-340" name="__codelineno-0-340"></a>                            <span class="n">destination_count</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
-<a id="__codelineno-0-341" name="__codelineno-0-341"></a>                                <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-342" name="__codelineno-0-342"></a>                                <span class="n">source_id__in</span><span class="o">=</span><span class="p">[</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span> <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">removed</span><span class="p">],</span>
-<a id="__codelineno-0-343" name="__codelineno-0-343"></a>                                <span class="n">destination_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-344" name="__codelineno-0-344"></a>                            <span class="p">)</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
-<a id="__codelineno-0-345" name="__codelineno-0-345"></a>                        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Deleted </span><span class="si">%s</span><span class="s2"> RelationshipAssociation(s)&quot;</span><span class="p">,</span> <span class="n">source_count</span> <span class="o">+</span> <span class="n">destination_count</span><span class="p">)</span>
-<a id="__codelineno-0-346" name="__codelineno-0-346"></a>
-<a id="__codelineno-0-347" name="__codelineno-0-347"></a>    <span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-0-348" name="__codelineno-0-348"></a>        <span class="c1"># Get any initial required relationship objects errors (i.e. non-existent required objects)</span>
-<a id="__codelineno-0-349" name="__codelineno-0-349"></a>        <span class="n">required_objects_errors</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">required_related_objects_errors</span><span class="p">(</span><span class="n">output_for</span><span class="o">=</span><span class="s2">&quot;ui&quot;</span><span class="p">)</span>
-<a id="__codelineno-0-350" name="__codelineno-0-350"></a>        <span class="n">already_invalidated_slugs</span> <span class="o">=</span> <span class="p">[]</span>
-<a id="__codelineno-0-351" name="__codelineno-0-351"></a>        <span class="k">for</span> <span class="n">field</span><span class="p">,</span> <span class="n">errors</span> <span class="ow">in</span> <span class="n">required_objects_errors</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-352" name="__codelineno-0-352"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">add_error</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="n">errors</span><span class="p">)</span>
-<a id="__codelineno-0-353" name="__codelineno-0-353"></a>            <span class="n">relationship_slug</span> <span class="o">=</span> <span class="n">field</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;__&quot;</span><span class="p">)[</span><span class="mi">0</span><span class="p">][</span><span class="mi">3</span><span class="p">:]</span>
-<a id="__codelineno-0-354" name="__codelineno-0-354"></a>            <span class="n">already_invalidated_slugs</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">relationship_slug</span><span class="p">)</span>
-<a id="__codelineno-0-355" name="__codelineno-0-355"></a>
-<a id="__codelineno-0-356" name="__codelineno-0-356"></a>        <span class="n">required_relationships</span> <span class="o">=</span> <span class="p">[]</span>
-<a id="__codelineno-0-357" name="__codelineno-0-357"></a>        <span class="c1"># The following query excludes already invalidated relationships (this happened above</span>
-<a id="__codelineno-0-358" name="__codelineno-0-358"></a>        <span class="c1"># by checking for the existence of required objects</span>
-<a id="__codelineno-0-359" name="__codelineno-0-359"></a>        <span class="c1"># with the call to self.Meta().model.required_related_objects_errors(output_for=&quot;ui&quot;))</span>
-<a id="__codelineno-0-360" name="__codelineno-0-360"></a>        <span class="k">for</span> <span class="n">relationship</span> <span class="ow">in</span> <span class="n">Relationship</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_required_for_model</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">exclude</span><span class="p">(</span>
-<a id="__codelineno-0-361" name="__codelineno-0-361"></a>            <span class="n">slug__in</span><span class="o">=</span><span class="n">already_invalidated_slugs</span>
-<a id="__codelineno-0-362" name="__codelineno-0-362"></a>        <span class="p">):</span>
-<a id="__codelineno-0-363" name="__codelineno-0-363"></a>            <span class="n">required_relationships</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-<a id="__codelineno-0-364" name="__codelineno-0-364"></a>                <span class="p">{</span>
-<a id="__codelineno-0-365" name="__codelineno-0-365"></a>                    <span class="s2">&quot;slug&quot;</span><span class="p">:</span> <span class="n">relationship</span><span class="o">.</span><span class="n">slug</span><span class="p">,</span>
-<a id="__codelineno-0-366" name="__codelineno-0-366"></a>                    <span class="s2">&quot;required_side&quot;</span><span class="p">:</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">relationship</span><span class="o">.</span><span class="n">required_on</span><span class="p">],</span>
-<a id="__codelineno-0-367" name="__codelineno-0-367"></a>                    <span class="s2">&quot;relationship&quot;</span><span class="p">:</span> <span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-368" name="__codelineno-0-368"></a>                <span class="p">}</span>
-<a id="__codelineno-0-369" name="__codelineno-0-369"></a>            <span class="p">)</span>
-<a id="__codelineno-0-370" name="__codelineno-0-370"></a>
-<a id="__codelineno-0-371" name="__codelineno-0-371"></a>        <span class="c1"># Get difference of add/remove objects for each required relationship:</span>
-<a id="__codelineno-0-372" name="__codelineno-0-372"></a>        <span class="n">required_relationships_to_check</span> <span class="o">=</span> <span class="p">[]</span>
-<a id="__codelineno-0-373" name="__codelineno-0-373"></a>        <span class="k">for</span> <span class="n">required_relationship</span> <span class="ow">in</span> <span class="n">required_relationships</span><span class="p">:</span>
-<a id="__codelineno-0-374" name="__codelineno-0-374"></a>            <span class="n">required_field</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">required_relationship</span><span class="p">[</span><span class="s1">&#39;slug&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">required_relationship</span><span class="p">[</span><span class="s1">&#39;required_side&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2">&quot;</span>
-<a id="__codelineno-0-375" name="__codelineno-0-375"></a>
-<a id="__codelineno-0-376" name="__codelineno-0-376"></a>            <span class="n">add_list</span> <span class="o">=</span> <span class="p">[]</span>
-<a id="__codelineno-0-377" name="__codelineno-0-377"></a>            <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">required_field</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
-<a id="__codelineno-0-378" name="__codelineno-0-378"></a>                <span class="n">add_list</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">required_field</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span>
-<a id="__codelineno-0-379" name="__codelineno-0-379"></a>
-<a id="__codelineno-0-380" name="__codelineno-0-380"></a>            <span class="n">remove_list</span> <span class="o">=</span> <span class="p">[]</span>
-<a id="__codelineno-0-381" name="__codelineno-0-381"></a>            <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">required_field</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
-<a id="__codelineno-0-382" name="__codelineno-0-382"></a>                <span class="n">remove_list</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">required_field</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span>
-<a id="__codelineno-0-383" name="__codelineno-0-383"></a>
-<a id="__codelineno-0-384" name="__codelineno-0-384"></a>            <span class="c1"># Determine difference of add/remove inputs</span>
-<a id="__codelineno-0-385" name="__codelineno-0-385"></a>            <span class="n">to_add</span> <span class="o">=</span> <span class="p">[</span><span class="n">obj</span> <span class="k">for</span> <span class="n">obj</span> <span class="ow">in</span> <span class="n">add_list</span> <span class="k">if</span> <span class="n">obj</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">remove_list</span><span class="p">]</span>
-<a id="__codelineno-0-386" name="__codelineno-0-386"></a>
-<a id="__codelineno-0-387" name="__codelineno-0-387"></a>            <span class="c1"># If we are adding at least one relationship association (and also not removing it), further validation is</span>
-<a id="__codelineno-0-388" name="__codelineno-0-388"></a>            <span class="c1"># not necessary because at least one object is required for every type of required relationship (one-to-one,</span>
-<a id="__codelineno-0-389" name="__codelineno-0-389"></a>            <span class="c1"># one-to-many and many-to-many)</span>
-<a id="__codelineno-0-390" name="__codelineno-0-390"></a>            <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">to_add</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
-<a id="__codelineno-0-391" name="__codelineno-0-391"></a>                <span class="k">continue</span>
+<a id="__codelineno-0-306" name="__codelineno-0-306"></a>                                <span class="p">):</span>
+<a id="__codelineno-0-307" name="__codelineno-0-307"></a>                                    <span class="n">ra</span> <span class="o">=</span> <span class="kc">None</span>
+<a id="__codelineno-0-308" name="__codelineno-0-308"></a>                                    <span class="n">created</span> <span class="o">=</span> <span class="kc">False</span>
+<a id="__codelineno-0-309" name="__codelineno-0-309"></a>                                <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-310" name="__codelineno-0-310"></a>                                    <span class="n">ra</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
+<a id="__codelineno-0-311" name="__codelineno-0-311"></a>                                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-312" name="__codelineno-0-312"></a>                                        <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
+<a id="__codelineno-0-313" name="__codelineno-0-313"></a>                                        <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-314" name="__codelineno-0-314"></a>                                        <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
+<a id="__codelineno-0-315" name="__codelineno-0-315"></a>                                        <span class="n">destination_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-316" name="__codelineno-0-316"></a>                                    <span class="p">)</span>
+<a id="__codelineno-0-317" name="__codelineno-0-317"></a>                                    <span class="n">created</span> <span class="o">=</span> <span class="kc">True</span>
+<a id="__codelineno-0-318" name="__codelineno-0-318"></a>
+<a id="__codelineno-0-319" name="__codelineno-0-319"></a>                            <span class="k">if</span> <span class="n">created</span><span class="p">:</span>
+<a id="__codelineno-0-320" name="__codelineno-0-320"></a>                                <span class="n">ra</span><span class="o">.</span><span class="n">validated_save</span><span class="p">()</span>
+<a id="__codelineno-0-321" name="__codelineno-0-321"></a>                                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Created </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
+<a id="__codelineno-0-322" name="__codelineno-0-322"></a>
+<a id="__codelineno-0-323" name="__codelineno-0-323"></a>                    <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
+<a id="__codelineno-0-324" name="__codelineno-0-324"></a>                        <span class="n">removed</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-325" name="__codelineno-0-325"></a>
+<a id="__codelineno-0-326" name="__codelineno-0-326"></a>                        <span class="n">source_count</span> <span class="o">=</span> <span class="mi">0</span>
+<a id="__codelineno-0-327" name="__codelineno-0-327"></a>                        <span class="n">destination_count</span> <span class="o">=</span> <span class="mi">0</span>
+<a id="__codelineno-0-328" name="__codelineno-0-328"></a>                        <span class="k">if</span> <span class="n">side</span> <span class="ow">in</span> <span class="p">[</span><span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_SOURCE</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">]:</span>
+<a id="__codelineno-0-329" name="__codelineno-0-329"></a>                            <span class="n">source_count</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-330" name="__codelineno-0-330"></a>                                <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-331" name="__codelineno-0-331"></a>                                <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-332" name="__codelineno-0-332"></a>                                <span class="n">destination_id__in</span><span class="o">=</span><span class="p">[</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span> <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">removed</span><span class="p">],</span>
+<a id="__codelineno-0-333" name="__codelineno-0-333"></a>                            <span class="p">)</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
+<a id="__codelineno-0-334" name="__codelineno-0-334"></a>                        <span class="k">if</span> <span class="n">side</span> <span class="ow">in</span> <span class="p">[</span><span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_DESTINATION</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">]:</span>
+<a id="__codelineno-0-335" name="__codelineno-0-335"></a>                            <span class="n">destination_count</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-336" name="__codelineno-0-336"></a>                                <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-337" name="__codelineno-0-337"></a>                                <span class="n">source_id__in</span><span class="o">=</span><span class="p">[</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span> <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">removed</span><span class="p">],</span>
+<a id="__codelineno-0-338" name="__codelineno-0-338"></a>                                <span class="n">destination_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-339" name="__codelineno-0-339"></a>                            <span class="p">)</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
+<a id="__codelineno-0-340" name="__codelineno-0-340"></a>                        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Deleted </span><span class="si">%s</span><span class="s2"> RelationshipAssociation(s)&quot;</span><span class="p">,</span> <span class="n">source_count</span> <span class="o">+</span> <span class="n">destination_count</span><span class="p">)</span>
+<a id="__codelineno-0-341" name="__codelineno-0-341"></a>
+<a id="__codelineno-0-342" name="__codelineno-0-342"></a>    <span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-0-343" name="__codelineno-0-343"></a>        <span class="c1"># Get any initial required relationship objects errors (i.e. non-existent required objects)</span>
+<a id="__codelineno-0-344" name="__codelineno-0-344"></a>        <span class="n">required_objects_errors</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">required_related_objects_errors</span><span class="p">(</span><span class="n">output_for</span><span class="o">=</span><span class="s2">&quot;ui&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-345" name="__codelineno-0-345"></a>        <span class="n">already_invalidated_keys</span> <span class="o">=</span> <span class="p">[]</span>
+<a id="__codelineno-0-346" name="__codelineno-0-346"></a>        <span class="k">for</span> <span class="n">field</span><span class="p">,</span> <span class="n">errors</span> <span class="ow">in</span> <span class="n">required_objects_errors</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-347" name="__codelineno-0-347"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">add_error</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="n">errors</span><span class="p">)</span>
+<a id="__codelineno-0-348" name="__codelineno-0-348"></a>            <span class="c1"># rindex() find the last occurrence of &quot;__&quot; which is</span>
+<a id="__codelineno-0-349" name="__codelineno-0-349"></a>            <span class="c1"># guaranteed to be cr_{key}__source, cr_{key}__destination, or cr_{key}__peer</span>
+<a id="__codelineno-0-350" name="__codelineno-0-350"></a>            <span class="c1"># regardless of how {key} is formatted</span>
+<a id="__codelineno-0-351" name="__codelineno-0-351"></a>            <span class="n">relationship_key</span> <span class="o">=</span> <span class="n">field</span><span class="p">[:</span> <span class="n">field</span><span class="o">.</span><span class="n">rindex</span><span class="p">(</span><span class="s2">&quot;__&quot;</span><span class="p">)][</span><span class="mi">3</span><span class="p">:]</span>
+<a id="__codelineno-0-352" name="__codelineno-0-352"></a>            <span class="n">already_invalidated_keys</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">relationship_key</span><span class="p">)</span>
+<a id="__codelineno-0-353" name="__codelineno-0-353"></a>
+<a id="__codelineno-0-354" name="__codelineno-0-354"></a>        <span class="n">required_relationships</span> <span class="o">=</span> <span class="p">[]</span>
+<a id="__codelineno-0-355" name="__codelineno-0-355"></a>        <span class="c1"># The following query excludes already invalidated relationships (this happened above</span>
+<a id="__codelineno-0-356" name="__codelineno-0-356"></a>        <span class="c1"># by checking for the existence of required objects</span>
+<a id="__codelineno-0-357" name="__codelineno-0-357"></a>        <span class="c1"># with the call to self.Meta().model.required_related_objects_errors(output_for=&quot;ui&quot;))</span>
+<a id="__codelineno-0-358" name="__codelineno-0-358"></a>        <span class="k">for</span> <span class="n">relationship</span> <span class="ow">in</span> <span class="n">Relationship</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_required_for_model</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="p">)</span><span class="o">.</span><span class="n">exclude</span><span class="p">(</span>
+<a id="__codelineno-0-359" name="__codelineno-0-359"></a>            <span class="n">key__in</span><span class="o">=</span><span class="n">already_invalidated_keys</span>
+<a id="__codelineno-0-360" name="__codelineno-0-360"></a>        <span class="p">):</span>
+<a id="__codelineno-0-361" name="__codelineno-0-361"></a>            <span class="n">required_relationships</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+<a id="__codelineno-0-362" name="__codelineno-0-362"></a>                <span class="p">{</span>
+<a id="__codelineno-0-363" name="__codelineno-0-363"></a>                    <span class="s2">&quot;key&quot;</span><span class="p">:</span> <span class="n">relationship</span><span class="o">.</span><span class="n">key</span><span class="p">,</span>
+<a id="__codelineno-0-364" name="__codelineno-0-364"></a>                    <span class="s2">&quot;required_side&quot;</span><span class="p">:</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">relationship</span><span class="o">.</span><span class="n">required_on</span><span class="p">],</span>
+<a id="__codelineno-0-365" name="__codelineno-0-365"></a>                    <span class="s2">&quot;relationship&quot;</span><span class="p">:</span> <span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-366" name="__codelineno-0-366"></a>                <span class="p">}</span>
+<a id="__codelineno-0-367" name="__codelineno-0-367"></a>            <span class="p">)</span>
+<a id="__codelineno-0-368" name="__codelineno-0-368"></a>
+<a id="__codelineno-0-369" name="__codelineno-0-369"></a>        <span class="c1"># Get difference of add/remove objects for each required relationship:</span>
+<a id="__codelineno-0-370" name="__codelineno-0-370"></a>        <span class="n">required_relationships_to_check</span> <span class="o">=</span> <span class="p">[]</span>
+<a id="__codelineno-0-371" name="__codelineno-0-371"></a>        <span class="k">for</span> <span class="n">required_relationship</span> <span class="ow">in</span> <span class="n">required_relationships</span><span class="p">:</span>
+<a id="__codelineno-0-372" name="__codelineno-0-372"></a>            <span class="n">required_field</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">required_relationship</span><span class="p">[</span><span class="s1">&#39;key&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">required_relationship</span><span class="p">[</span><span class="s1">&#39;required_side&#39;</span><span class="p">]</span><span class="si">}</span><span class="s2">&quot;</span>
+<a id="__codelineno-0-373" name="__codelineno-0-373"></a>
+<a id="__codelineno-0-374" name="__codelineno-0-374"></a>            <span class="n">add_list</span> <span class="o">=</span> <span class="p">[]</span>
+<a id="__codelineno-0-375" name="__codelineno-0-375"></a>            <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">required_field</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
+<a id="__codelineno-0-376" name="__codelineno-0-376"></a>                <span class="n">add_list</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">required_field</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span>
+<a id="__codelineno-0-377" name="__codelineno-0-377"></a>
+<a id="__codelineno-0-378" name="__codelineno-0-378"></a>            <span class="n">remove_list</span> <span class="o">=</span> <span class="p">[]</span>
+<a id="__codelineno-0-379" name="__codelineno-0-379"></a>            <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">required_field</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
+<a id="__codelineno-0-380" name="__codelineno-0-380"></a>                <span class="n">remove_list</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">required_field</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">]</span>
+<a id="__codelineno-0-381" name="__codelineno-0-381"></a>
+<a id="__codelineno-0-382" name="__codelineno-0-382"></a>            <span class="c1"># Determine difference of add/remove inputs</span>
+<a id="__codelineno-0-383" name="__codelineno-0-383"></a>            <span class="n">to_add</span> <span class="o">=</span> <span class="p">[</span><span class="n">obj</span> <span class="k">for</span> <span class="n">obj</span> <span class="ow">in</span> <span class="n">add_list</span> <span class="k">if</span> <span class="n">obj</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">remove_list</span><span class="p">]</span>
+<a id="__codelineno-0-384" name="__codelineno-0-384"></a>
+<a id="__codelineno-0-385" name="__codelineno-0-385"></a>            <span class="c1"># If we are adding at least one relationship association (and also not removing it), further validation is</span>
+<a id="__codelineno-0-386" name="__codelineno-0-386"></a>            <span class="c1"># not necessary because at least one object is required for every type of required relationship (one-to-one,</span>
+<a id="__codelineno-0-387" name="__codelineno-0-387"></a>            <span class="c1"># one-to-many and many-to-many)</span>
+<a id="__codelineno-0-388" name="__codelineno-0-388"></a>            <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">to_add</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">0</span><span class="p">:</span>
+<a id="__codelineno-0-389" name="__codelineno-0-389"></a>                <span class="k">continue</span>
+<a id="__codelineno-0-390" name="__codelineno-0-390"></a>
+<a id="__codelineno-0-391" name="__codelineno-0-391"></a>            <span class="n">to_remove</span> <span class="o">=</span> <span class="p">[</span><span class="n">obj</span> <span class="k">for</span> <span class="n">obj</span> <span class="ow">in</span> <span class="n">remove_list</span> <span class="k">if</span> <span class="n">obj</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">add_list</span><span class="p">]</span>
 <a id="__codelineno-0-392" name="__codelineno-0-392"></a>
-<a id="__codelineno-0-393" name="__codelineno-0-393"></a>            <span class="n">to_remove</span> <span class="o">=</span> <span class="p">[</span><span class="n">obj</span> <span class="k">for</span> <span class="n">obj</span> <span class="ow">in</span> <span class="n">remove_list</span> <span class="k">if</span> <span class="n">obj</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">add_list</span><span class="p">]</span>
-<a id="__codelineno-0-394" name="__codelineno-0-394"></a>
-<a id="__codelineno-0-395" name="__codelineno-0-395"></a>            <span class="c1"># Add to list of required relationships to enforce on each object being bulk-edited</span>
-<a id="__codelineno-0-396" name="__codelineno-0-396"></a>            <span class="n">required_relationships_to_check</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
-<a id="__codelineno-0-397" name="__codelineno-0-397"></a>                <span class="p">{</span>
-<a id="__codelineno-0-398" name="__codelineno-0-398"></a>                    <span class="s2">&quot;field&quot;</span><span class="p">:</span> <span class="n">required_field</span><span class="p">,</span>
-<a id="__codelineno-0-399" name="__codelineno-0-399"></a>                    <span class="s2">&quot;to_add&quot;</span><span class="p">:</span> <span class="n">to_add</span><span class="p">,</span>
-<a id="__codelineno-0-400" name="__codelineno-0-400"></a>                    <span class="s2">&quot;to_remove&quot;</span><span class="p">:</span> <span class="n">to_remove</span><span class="p">,</span>
-<a id="__codelineno-0-401" name="__codelineno-0-401"></a>                    <span class="s2">&quot;relationship&quot;</span><span class="p">:</span> <span class="n">required_relationship</span><span class="p">[</span><span class="s2">&quot;relationship&quot;</span><span class="p">],</span>
-<a id="__codelineno-0-402" name="__codelineno-0-402"></a>                <span class="p">}</span>
-<a id="__codelineno-0-403" name="__codelineno-0-403"></a>            <span class="p">)</span>
+<a id="__codelineno-0-393" name="__codelineno-0-393"></a>            <span class="c1"># Add to list of required relationships to enforce on each object being bulk-edited</span>
+<a id="__codelineno-0-394" name="__codelineno-0-394"></a>            <span class="n">required_relationships_to_check</span><span class="o">.</span><span class="n">append</span><span class="p">(</span>
+<a id="__codelineno-0-395" name="__codelineno-0-395"></a>                <span class="p">{</span>
+<a id="__codelineno-0-396" name="__codelineno-0-396"></a>                    <span class="s2">&quot;field&quot;</span><span class="p">:</span> <span class="n">required_field</span><span class="p">,</span>
+<a id="__codelineno-0-397" name="__codelineno-0-397"></a>                    <span class="s2">&quot;to_add&quot;</span><span class="p">:</span> <span class="n">to_add</span><span class="p">,</span>
+<a id="__codelineno-0-398" name="__codelineno-0-398"></a>                    <span class="s2">&quot;to_remove&quot;</span><span class="p">:</span> <span class="n">to_remove</span><span class="p">,</span>
+<a id="__codelineno-0-399" name="__codelineno-0-399"></a>                    <span class="s2">&quot;relationship&quot;</span><span class="p">:</span> <span class="n">required_relationship</span><span class="p">[</span><span class="s2">&quot;relationship&quot;</span><span class="p">],</span>
+<a id="__codelineno-0-400" name="__codelineno-0-400"></a>                <span class="p">}</span>
+<a id="__codelineno-0-401" name="__codelineno-0-401"></a>            <span class="p">)</span>
+<a id="__codelineno-0-402" name="__codelineno-0-402"></a>
+<a id="__codelineno-0-403" name="__codelineno-0-403"></a>        <span class="n">relationship_data_errors</span> <span class="o">=</span> <span class="p">{}</span>
 <a id="__codelineno-0-404" name="__codelineno-0-404"></a>
-<a id="__codelineno-0-405" name="__codelineno-0-405"></a>        <span class="n">relationship_data_errors</span> <span class="o">=</span> <span class="p">{}</span>
-<a id="__codelineno-0-406" name="__codelineno-0-406"></a>
-<a id="__codelineno-0-407" name="__codelineno-0-407"></a>        <span class="k">for</span> <span class="n">relationship_to_check</span> <span class="ow">in</span> <span class="n">required_relationships_to_check</span><span class="p">:</span>
-<a id="__codelineno-0-408" name="__codelineno-0-408"></a>            <span class="n">relationship</span> <span class="o">=</span> <span class="n">relationship_to_check</span><span class="p">[</span><span class="s2">&quot;relationship&quot;</span><span class="p">]</span>
-<a id="__codelineno-0-409" name="__codelineno-0-409"></a>            <span class="k">for</span> <span class="n">editing</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="s2">&quot;pk&quot;</span><span class="p">]:</span>
-<a id="__codelineno-0-410" name="__codelineno-0-410"></a>                <span class="n">required_target_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">relationship</span><span class="o">.</span><span class="n">required_on</span><span class="p">]</span>
-<a id="__codelineno-0-411" name="__codelineno-0-411"></a>                <span class="n">required_target_type</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">relationship</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">required_target_side</span><span class="si">}</span><span class="s2">_type&quot;</span><span class="p">)</span>
-<a id="__codelineno-0-412" name="__codelineno-0-412"></a>                <span class="n">required_type_verbose_name</span> <span class="o">=</span> <span class="n">required_target_type</span><span class="o">.</span><span class="n">model_class</span><span class="p">()</span><span class="o">.</span><span class="n">_meta</span><span class="o">.</span><span class="n">verbose_name</span>
-<a id="__codelineno-0-413" name="__codelineno-0-413"></a>                <span class="n">filter_kwargs</span> <span class="o">=</span> <span class="p">{</span>
-<a id="__codelineno-0-414" name="__codelineno-0-414"></a>                    <span class="s2">&quot;relationship&quot;</span><span class="p">:</span> <span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-415" name="__codelineno-0-415"></a>                    <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">required_on</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">editing</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-416" name="__codelineno-0-416"></a>                <span class="p">}</span>
-<a id="__codelineno-0-417" name="__codelineno-0-417"></a>                <span class="n">existing_objects</span> <span class="o">=</span> <span class="p">[</span>
-<a id="__codelineno-0-418" name="__codelineno-0-418"></a>                    <span class="nb">getattr</span><span class="p">(</span><span class="n">association</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;get_</span><span class="si">{</span><span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">relationship</span><span class="o">.</span><span class="n">required_on</span><span class="p">]</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)()</span>
-<a id="__codelineno-0-419" name="__codelineno-0-419"></a>                    <span class="k">for</span> <span class="n">association</span> <span class="ow">in</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">**</span><span class="n">filter_kwargs</span><span class="p">)</span>
-<a id="__codelineno-0-420" name="__codelineno-0-420"></a>                <span class="p">]</span>
-<a id="__codelineno-0-421" name="__codelineno-0-421"></a>                <span class="n">requires_message</span> <span class="o">=</span> <span class="p">(</span>
-<a id="__codelineno-0-422" name="__codelineno-0-422"></a>                    <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">editing</span><span class="o">.</span><span class="n">_meta</span><span class="o">.</span><span class="n">verbose_name_plural</span><span class="si">}</span><span class="s2"> require a </span><span class="si">{</span><span class="n">required_type_verbose_name</span><span class="si">}</span><span class="s2"> &quot;</span>
-<a id="__codelineno-0-423" name="__codelineno-0-423"></a>                    <span class="sa">f</span><span class="s1">&#39;for the required relationship &quot;</span><span class="si">{</span><span class="nb">str</span><span class="p">(</span><span class="n">relationship</span><span class="p">)</span><span class="si">}</span><span class="s1">&quot;&#39;</span>
-<a id="__codelineno-0-424" name="__codelineno-0-424"></a>                <span class="p">)</span>
-<a id="__codelineno-0-425" name="__codelineno-0-425"></a>                <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">existing_objects</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">len</span><span class="p">(</span><span class="n">relationship_to_check</span><span class="p">[</span><span class="s2">&quot;to_add&quot;</span><span class="p">])</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-<a id="__codelineno-0-426" name="__codelineno-0-426"></a>                    <span class="n">relationship_data_errors</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">requires_message</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">editing</span><span class="p">))</span>
-<a id="__codelineno-0-427" name="__codelineno-0-427"></a>                <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-428" name="__codelineno-0-428"></a>                    <span class="n">removed</span> <span class="o">=</span> <span class="n">relationship_to_check</span><span class="p">[</span><span class="s2">&quot;to_remove&quot;</span><span class="p">]</span>
-<a id="__codelineno-0-429" name="__codelineno-0-429"></a>                    <span class="n">difference</span> <span class="o">=</span> <span class="p">[</span><span class="n">obj</span> <span class="k">for</span> <span class="n">obj</span> <span class="ow">in</span> <span class="n">existing_objects</span> <span class="k">if</span> <span class="n">obj</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">removed</span><span class="p">]</span>
-<a id="__codelineno-0-430" name="__codelineno-0-430"></a>                    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">difference</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
-<a id="__codelineno-0-431" name="__codelineno-0-431"></a>                        <span class="n">relationship_data_errors</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">requires_message</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">editing</span><span class="p">))</span>
-<a id="__codelineno-0-432" name="__codelineno-0-432"></a>
-<a id="__codelineno-0-433" name="__codelineno-0-433"></a>        <span class="k">for</span> <span class="n">relationship_message</span><span class="p">,</span> <span class="n">object_list</span> <span class="ow">in</span> <span class="n">relationship_data_errors</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-434" name="__codelineno-0-434"></a>            <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">object_list</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">5</span><span class="p">:</span>
-<a id="__codelineno-0-435" name="__codelineno-0-435"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">add_error</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="n">object_list</span><span class="p">)</span><span class="si">}</span><span class="s2"> </span><span class="si">{</span><span class="n">relationship_message</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-<a id="__codelineno-0-436" name="__codelineno-0-436"></a>            <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-437" name="__codelineno-0-437"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">add_error</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;These </span><span class="si">{</span><span class="n">relationship_message</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="s1">&#39;, &#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">object_list</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-<a id="__codelineno-0-438" name="__codelineno-0-438"></a>
-<a id="__codelineno-0-439" name="__codelineno-0-439"></a>        <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">()</span>
+<a id="__codelineno-0-405" name="__codelineno-0-405"></a>        <span class="k">for</span> <span class="n">relationship_to_check</span> <span class="ow">in</span> <span class="n">required_relationships_to_check</span><span class="p">:</span>
+<a id="__codelineno-0-406" name="__codelineno-0-406"></a>            <span class="n">relationship</span> <span class="o">=</span> <span class="n">relationship_to_check</span><span class="p">[</span><span class="s2">&quot;relationship&quot;</span><span class="p">]</span>
+<a id="__codelineno-0-407" name="__codelineno-0-407"></a>            <span class="k">for</span> <span class="n">editing</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="s2">&quot;pk&quot;</span><span class="p">]:</span>
+<a id="__codelineno-0-408" name="__codelineno-0-408"></a>                <span class="n">required_target_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">relationship</span><span class="o">.</span><span class="n">required_on</span><span class="p">]</span>
+<a id="__codelineno-0-409" name="__codelineno-0-409"></a>                <span class="n">required_target_type</span> <span class="o">=</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">relationship</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">required_target_side</span><span class="si">}</span><span class="s2">_type&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-410" name="__codelineno-0-410"></a>                <span class="n">required_type_verbose_name</span> <span class="o">=</span> <span class="n">required_target_type</span><span class="o">.</span><span class="n">model_class</span><span class="p">()</span><span class="o">.</span><span class="n">_meta</span><span class="o">.</span><span class="n">verbose_name</span>
+<a id="__codelineno-0-411" name="__codelineno-0-411"></a>                <span class="n">filter_kwargs</span> <span class="o">=</span> <span class="p">{</span>
+<a id="__codelineno-0-412" name="__codelineno-0-412"></a>                    <span class="s2">&quot;relationship&quot;</span><span class="p">:</span> <span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-413" name="__codelineno-0-413"></a>                    <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">required_on</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">editing</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-414" name="__codelineno-0-414"></a>                <span class="p">}</span>
+<a id="__codelineno-0-415" name="__codelineno-0-415"></a>                <span class="n">existing_objects</span> <span class="o">=</span> <span class="p">[</span>
+<a id="__codelineno-0-416" name="__codelineno-0-416"></a>                    <span class="nb">getattr</span><span class="p">(</span><span class="n">association</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;get_</span><span class="si">{</span><span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">relationship</span><span class="o">.</span><span class="n">required_on</span><span class="p">]</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)()</span>
+<a id="__codelineno-0-417" name="__codelineno-0-417"></a>                    <span class="k">for</span> <span class="n">association</span> <span class="ow">in</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">**</span><span class="n">filter_kwargs</span><span class="p">)</span>
+<a id="__codelineno-0-418" name="__codelineno-0-418"></a>                <span class="p">]</span>
+<a id="__codelineno-0-419" name="__codelineno-0-419"></a>                <span class="n">requires_message</span> <span class="o">=</span> <span class="p">(</span>
+<a id="__codelineno-0-420" name="__codelineno-0-420"></a>                    <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">editing</span><span class="o">.</span><span class="n">_meta</span><span class="o">.</span><span class="n">verbose_name_plural</span><span class="si">}</span><span class="s2"> require a </span><span class="si">{</span><span class="n">required_type_verbose_name</span><span class="si">}</span><span class="s2"> &quot;</span>
+<a id="__codelineno-0-421" name="__codelineno-0-421"></a>                    <span class="sa">f</span><span class="s1">&#39;for the required relationship &quot;</span><span class="si">{</span><span class="nb">str</span><span class="p">(</span><span class="n">relationship</span><span class="p">)</span><span class="si">}</span><span class="s1">&quot;&#39;</span>
+<a id="__codelineno-0-422" name="__codelineno-0-422"></a>                <span class="p">)</span>
+<a id="__codelineno-0-423" name="__codelineno-0-423"></a>                <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">existing_objects</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span> <span class="ow">and</span> <span class="nb">len</span><span class="p">(</span><span class="n">relationship_to_check</span><span class="p">[</span><span class="s2">&quot;to_add&quot;</span><span class="p">])</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+<a id="__codelineno-0-424" name="__codelineno-0-424"></a>                    <span class="n">relationship_data_errors</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">requires_message</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">editing</span><span class="p">))</span>
+<a id="__codelineno-0-425" name="__codelineno-0-425"></a>                <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-426" name="__codelineno-0-426"></a>                    <span class="n">removed</span> <span class="o">=</span> <span class="n">relationship_to_check</span><span class="p">[</span><span class="s2">&quot;to_remove&quot;</span><span class="p">]</span>
+<a id="__codelineno-0-427" name="__codelineno-0-427"></a>                    <span class="n">difference</span> <span class="o">=</span> <span class="p">[</span><span class="n">obj</span> <span class="k">for</span> <span class="n">obj</span> <span class="ow">in</span> <span class="n">existing_objects</span> <span class="k">if</span> <span class="n">obj</span> <span class="ow">not</span> <span class="ow">in</span> <span class="n">removed</span><span class="p">]</span>
+<a id="__codelineno-0-428" name="__codelineno-0-428"></a>                    <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">difference</span><span class="p">)</span> <span class="o">==</span> <span class="mi">0</span><span class="p">:</span>
+<a id="__codelineno-0-429" name="__codelineno-0-429"></a>                        <span class="n">relationship_data_errors</span><span class="o">.</span><span class="n">setdefault</span><span class="p">(</span><span class="n">requires_message</span><span class="p">,</span> <span class="p">[])</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="nb">str</span><span class="p">(</span><span class="n">editing</span><span class="p">))</span>
+<a id="__codelineno-0-430" name="__codelineno-0-430"></a>
+<a id="__codelineno-0-431" name="__codelineno-0-431"></a>        <span class="k">for</span> <span class="n">relationship_message</span><span class="p">,</span> <span class="n">object_list</span> <span class="ow">in</span> <span class="n">relationship_data_errors</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-432" name="__codelineno-0-432"></a>            <span class="k">if</span> <span class="nb">len</span><span class="p">(</span><span class="n">object_list</span><span class="p">)</span> <span class="o">&gt;</span> <span class="mi">5</span><span class="p">:</span>
+<a id="__codelineno-0-433" name="__codelineno-0-433"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">add_error</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="nb">len</span><span class="p">(</span><span class="n">object_list</span><span class="p">)</span><span class="si">}</span><span class="s2"> </span><span class="si">{</span><span class="n">relationship_message</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-434" name="__codelineno-0-434"></a>            <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-435" name="__codelineno-0-435"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">add_error</span><span class="p">(</span><span class="kc">None</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;These </span><span class="si">{</span><span class="n">relationship_message</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="s1">&#39;, &#39;</span><span class="o">.</span><span class="n">join</span><span class="p">(</span><span class="n">object_list</span><span class="p">)</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-436" name="__codelineno-0-436"></a>
+<a id="__codelineno-0-437" name="__codelineno-0-437"></a>        <span class="k">return</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
         </details>
@@ -4562,7 +5753,12 @@ NoteModelFormMixin are needed.</p>
       <details class="quote">
         <summary>Source code in <code>nautobot/extras/forms/mixins.py</code></summary>
-        <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-250">250</a></span>
+        <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-245">245</a></span>
+<span class="normal"><a href="#__codelineno-0-246">246</a></span>
+<span class="normal"><a href="#__codelineno-0-247">247</a></span>
+<span class="normal"><a href="#__codelineno-0-248">248</a></span>
+<span class="normal"><a href="#__codelineno-0-249">249</a></span>
+<span class="normal"><a href="#__codelineno-0-250">250</a></span>
 <span class="normal"><a href="#__codelineno-0-251">251</a></span>
 <span class="normal"><a href="#__codelineno-0-252">252</a></span>
 <span class="normal"><a href="#__codelineno-0-253">253</a></span>
@@ -4652,107 +5848,102 @@ NoteModelFormMixin are needed.</p>
 <span class="normal"><a href="#__codelineno-0-337">337</a></span>
 <span class="normal"><a href="#__codelineno-0-338">338</a></span>
 <span class="normal"><a href="#__codelineno-0-339">339</a></span>
-<span class="normal"><a href="#__codelineno-0-340">340</a></span>
-<span class="normal"><a href="#__codelineno-0-341">341</a></span>
-<span class="normal"><a href="#__codelineno-0-342">342</a></span>
-<span class="normal"><a href="#__codelineno-0-343">343</a></span>
-<span class="normal"><a href="#__codelineno-0-344">344</a></span>
-<span class="normal"><a href="#__codelineno-0-345">345</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-250" name="__codelineno-0-250"></a><span class="k">def</span> <span class="nf">save_relationships</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">instance</span><span class="p">,</span> <span class="n">nullified_fields</span><span class="p">):</span>
-<a id="__codelineno-0-251" name="__codelineno-0-251"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Helper method to be called from BulkEditView.post().&quot;&quot;&quot;</span>
-<a id="__codelineno-0-252" name="__codelineno-0-252"></a>    <span class="c1"># The below may seem inefficient as it re-loads the Relationship objects afresh for each instance;</span>
-<a id="__codelineno-0-253" name="__codelineno-0-253"></a>    <span class="c1"># however this is necessary as it applies the source/destination filters (if any) to determine</span>
-<a id="__codelineno-0-254" name="__codelineno-0-254"></a>    <span class="c1"># whether each relationship actually applies to the given instance.</span>
-<a id="__codelineno-0-255" name="__codelineno-0-255"></a>    <span class="n">instance_relationships</span> <span class="o">=</span> <span class="n">instance</span><span class="o">.</span><span class="n">get_relationships</span><span class="p">(</span><span class="n">include_hidden</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
-<a id="__codelineno-0-256" name="__codelineno-0-256"></a>
-<a id="__codelineno-0-257" name="__codelineno-0-257"></a>    <span class="k">for</span> <span class="n">side</span><span class="p">,</span> <span class="n">relationships_data</span> <span class="ow">in</span> <span class="n">instance_relationships</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-258" name="__codelineno-0-258"></a>        <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
-<a id="__codelineno-0-259" name="__codelineno-0-259"></a>        <span class="k">for</span> <span class="n">relationship</span><span class="p">,</span> <span class="n">relationshipassociation_queryset</span> <span class="ow">in</span> <span class="n">relationships_data</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-260" name="__codelineno-0-260"></a>            <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">slug</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
-<a id="__codelineno-0-261" name="__codelineno-0-261"></a>            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
-<a id="__codelineno-0-262" name="__codelineno-0-262"></a>                <span class="s2">&quot;Processing relationship </span><span class="si">%s</span><span class="s2"> </span><span class="si">%s</span><span class="s2"> (field </span><span class="si">%s</span><span class="s2">) for instance </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span>
-<a id="__codelineno-0-263" name="__codelineno-0-263"></a>                <span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-264" name="__codelineno-0-264"></a>                <span class="n">side</span><span class="p">,</span>
-<a id="__codelineno-0-265" name="__codelineno-0-265"></a>                <span class="n">field_name</span><span class="p">,</span>
-<a id="__codelineno-0-266" name="__codelineno-0-266"></a>                <span class="n">instance</span><span class="p">,</span>
-<a id="__codelineno-0-267" name="__codelineno-0-267"></a>            <span class="p">)</span>
-<a id="__codelineno-0-268" name="__codelineno-0-268"></a>            <span class="k">if</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">nullable_fields</span> <span class="ow">and</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="n">nullified_fields</span><span class="p">:</span>
-<a id="__codelineno-0-269" name="__codelineno-0-269"></a>                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Deleting existing relationship associations for </span><span class="si">%s</span><span class="s2"> on </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">relationship</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>
-<a id="__codelineno-0-270" name="__codelineno-0-270"></a>                <span class="n">relationshipassociation_queryset</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
-<a id="__codelineno-0-271" name="__codelineno-0-271"></a>            <span class="k">elif</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
-<a id="__codelineno-0-272" name="__codelineno-0-272"></a>                <span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
-<a id="__codelineno-0-273" name="__codelineno-0-273"></a>                <span class="k">if</span> <span class="n">value</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">peer_side</span><span class="p">):</span>
-<a id="__codelineno-0-274" name="__codelineno-0-274"></a>                    <span class="n">ra</span><span class="p">,</span> <span class="n">created</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">update_or_create</span><span class="p">(</span>
-<a id="__codelineno-0-275" name="__codelineno-0-275"></a>                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-276" name="__codelineno-0-276"></a>                        <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
-<a id="__codelineno-0-277" name="__codelineno-0-277"></a>                        <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
-<a id="__codelineno-0-278" name="__codelineno-0-278"></a>                        <span class="n">defaults</span><span class="o">=</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">value</span><span class="o">.</span><span class="n">pk</span><span class="p">},</span>
-<a id="__codelineno-0-279" name="__codelineno-0-279"></a>                        <span class="o">**</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">},</span>
-<a id="__codelineno-0-280" name="__codelineno-0-280"></a>                    <span class="p">)</span>
-<a id="__codelineno-0-281" name="__codelineno-0-281"></a>                    <span class="k">if</span> <span class="n">created</span><span class="p">:</span>
-<a id="__codelineno-0-282" name="__codelineno-0-282"></a>                        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Created </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
-<a id="__codelineno-0-283" name="__codelineno-0-283"></a>                    <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-284" name="__codelineno-0-284"></a>                        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Updated </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
-<a id="__codelineno-0-285" name="__codelineno-0-285"></a>            <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-286" name="__codelineno-0-286"></a>                <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
-<a id="__codelineno-0-287" name="__codelineno-0-287"></a>                    <span class="n">added</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-<a id="__codelineno-0-288" name="__codelineno-0-288"></a>                    <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">added</span><span class="p">:</span>
-<a id="__codelineno-0-289" name="__codelineno-0-289"></a>                        <span class="k">if</span> <span class="n">peer_side</span> <span class="o">!=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">:</span>
-<a id="__codelineno-0-290" name="__codelineno-0-290"></a>                            <span class="n">ra</span><span class="p">,</span> <span class="n">created</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_or_create</span><span class="p">(</span>
-<a id="__codelineno-0-291" name="__codelineno-0-291"></a>                                <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-292" name="__codelineno-0-292"></a>                                <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
-<a id="__codelineno-0-293" name="__codelineno-0-293"></a>                                <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
-<a id="__codelineno-0-294" name="__codelineno-0-294"></a>                                <span class="o">**</span><span class="p">{</span>
-<a id="__codelineno-0-295" name="__codelineno-0-295"></a>                                    <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-296" name="__codelineno-0-296"></a>                                    <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-297" name="__codelineno-0-297"></a>                                <span class="p">},</span>
-<a id="__codelineno-0-298" name="__codelineno-0-298"></a>                            <span class="p">)</span>
-<a id="__codelineno-0-299" name="__codelineno-0-299"></a>                        <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-300" name="__codelineno-0-300"></a>                            <span class="k">if</span> <span class="p">(</span>
-<a id="__codelineno-0-301" name="__codelineno-0-301"></a>                                <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<span class="normal"><a href="#__codelineno-0-340">340</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-245" name="__codelineno-0-245"></a><span class="k">def</span> <span class="nf">save_relationships</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">instance</span><span class="p">,</span> <span class="n">nullified_fields</span><span class="p">):</span>
+<a id="__codelineno-0-246" name="__codelineno-0-246"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Helper method to be called from BulkEditView.post().&quot;&quot;&quot;</span>
+<a id="__codelineno-0-247" name="__codelineno-0-247"></a>    <span class="c1"># The below may seem inefficient as it re-loads the Relationship objects afresh for each instance;</span>
+<a id="__codelineno-0-248" name="__codelineno-0-248"></a>    <span class="c1"># however this is necessary as it applies the source/destination filters (if any) to determine</span>
+<a id="__codelineno-0-249" name="__codelineno-0-249"></a>    <span class="c1"># whether each relationship actually applies to the given instance.</span>
+<a id="__codelineno-0-250" name="__codelineno-0-250"></a>    <span class="n">instance_relationships</span> <span class="o">=</span> <span class="n">instance</span><span class="o">.</span><span class="n">get_relationships</span><span class="p">(</span><span class="n">include_hidden</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>
+<a id="__codelineno-0-251" name="__codelineno-0-251"></a>
+<a id="__codelineno-0-252" name="__codelineno-0-252"></a>    <span class="k">for</span> <span class="n">side</span><span class="p">,</span> <span class="n">relationships_data</span> <span class="ow">in</span> <span class="n">instance_relationships</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-253" name="__codelineno-0-253"></a>        <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
+<a id="__codelineno-0-254" name="__codelineno-0-254"></a>        <span class="k">for</span> <span class="n">relationship</span><span class="p">,</span> <span class="n">relationshipassociation_queryset</span> <span class="ow">in</span> <span class="n">relationships_data</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-255" name="__codelineno-0-255"></a>            <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">key</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
+<a id="__codelineno-0-256" name="__codelineno-0-256"></a>            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span>
+<a id="__codelineno-0-257" name="__codelineno-0-257"></a>                <span class="s2">&quot;Processing relationship </span><span class="si">%s</span><span class="s2"> </span><span class="si">%s</span><span class="s2"> (field </span><span class="si">%s</span><span class="s2">) for instance </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span>
+<a id="__codelineno-0-258" name="__codelineno-0-258"></a>                <span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-259" name="__codelineno-0-259"></a>                <span class="n">side</span><span class="p">,</span>
+<a id="__codelineno-0-260" name="__codelineno-0-260"></a>                <span class="n">field_name</span><span class="p">,</span>
+<a id="__codelineno-0-261" name="__codelineno-0-261"></a>                <span class="n">instance</span><span class="p">,</span>
+<a id="__codelineno-0-262" name="__codelineno-0-262"></a>            <span class="p">)</span>
+<a id="__codelineno-0-263" name="__codelineno-0-263"></a>            <span class="k">if</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">nullable_fields</span> <span class="ow">and</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="n">nullified_fields</span><span class="p">:</span>
+<a id="__codelineno-0-264" name="__codelineno-0-264"></a>                <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Deleting existing relationship associations for </span><span class="si">%s</span><span class="s2"> on </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">relationship</span><span class="p">,</span> <span class="n">instance</span><span class="p">)</span>
+<a id="__codelineno-0-265" name="__codelineno-0-265"></a>                <span class="n">relationshipassociation_queryset</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
+<a id="__codelineno-0-266" name="__codelineno-0-266"></a>            <span class="k">elif</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
+<a id="__codelineno-0-267" name="__codelineno-0-267"></a>                <span class="n">value</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
+<a id="__codelineno-0-268" name="__codelineno-0-268"></a>                <span class="k">if</span> <span class="n">value</span> <span class="ow">and</span> <span class="ow">not</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">peer_side</span><span class="p">):</span>
+<a id="__codelineno-0-269" name="__codelineno-0-269"></a>                    <span class="n">ra</span><span class="p">,</span> <span class="n">created</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">update_or_create</span><span class="p">(</span>
+<a id="__codelineno-0-270" name="__codelineno-0-270"></a>                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-271" name="__codelineno-0-271"></a>                        <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
+<a id="__codelineno-0-272" name="__codelineno-0-272"></a>                        <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
+<a id="__codelineno-0-273" name="__codelineno-0-273"></a>                        <span class="n">defaults</span><span class="o">=</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">value</span><span class="o">.</span><span class="n">pk</span><span class="p">},</span>
+<a id="__codelineno-0-274" name="__codelineno-0-274"></a>                        <span class="o">**</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">},</span>
+<a id="__codelineno-0-275" name="__codelineno-0-275"></a>                    <span class="p">)</span>
+<a id="__codelineno-0-276" name="__codelineno-0-276"></a>                    <span class="k">if</span> <span class="n">created</span><span class="p">:</span>
+<a id="__codelineno-0-277" name="__codelineno-0-277"></a>                        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Created </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
+<a id="__codelineno-0-278" name="__codelineno-0-278"></a>                    <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-279" name="__codelineno-0-279"></a>                        <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Updated </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
+<a id="__codelineno-0-280" name="__codelineno-0-280"></a>            <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-281" name="__codelineno-0-281"></a>                <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
+<a id="__codelineno-0-282" name="__codelineno-0-282"></a>                    <span class="n">added</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;add_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-283" name="__codelineno-0-283"></a>                    <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">added</span><span class="p">:</span>
+<a id="__codelineno-0-284" name="__codelineno-0-284"></a>                        <span class="k">if</span> <span class="n">peer_side</span> <span class="o">!=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">:</span>
+<a id="__codelineno-0-285" name="__codelineno-0-285"></a>                            <span class="n">ra</span><span class="p">,</span> <span class="n">created</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_or_create</span><span class="p">(</span>
+<a id="__codelineno-0-286" name="__codelineno-0-286"></a>                                <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-287" name="__codelineno-0-287"></a>                                <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
+<a id="__codelineno-0-288" name="__codelineno-0-288"></a>                                <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
+<a id="__codelineno-0-289" name="__codelineno-0-289"></a>                                <span class="o">**</span><span class="p">{</span>
+<a id="__codelineno-0-290" name="__codelineno-0-290"></a>                                    <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-291" name="__codelineno-0-291"></a>                                    <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-292" name="__codelineno-0-292"></a>                                <span class="p">},</span>
+<a id="__codelineno-0-293" name="__codelineno-0-293"></a>                            <span class="p">)</span>
+<a id="__codelineno-0-294" name="__codelineno-0-294"></a>                        <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-295" name="__codelineno-0-295"></a>                            <span class="k">if</span> <span class="p">(</span>
+<a id="__codelineno-0-296" name="__codelineno-0-296"></a>                                <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-297" name="__codelineno-0-297"></a>                                    <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-298" name="__codelineno-0-298"></a>                                    <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-299" name="__codelineno-0-299"></a>                                    <span class="n">destination_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-300" name="__codelineno-0-300"></a>                                <span class="p">)</span><span class="o">.</span><span class="n">exists</span><span class="p">()</span>
+<a id="__codelineno-0-301" name="__codelineno-0-301"></a>                                <span class="ow">or</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
 <a id="__codelineno-0-302" name="__codelineno-0-302"></a>                                    <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-303" name="__codelineno-0-303"></a>                                    <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-304" name="__codelineno-0-304"></a>                                    <span class="n">destination_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-303" name="__codelineno-0-303"></a>                                    <span class="n">source_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-304" name="__codelineno-0-304"></a>                                    <span class="n">destination_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
 <a id="__codelineno-0-305" name="__codelineno-0-305"></a>                                <span class="p">)</span><span class="o">.</span><span class="n">exists</span><span class="p">()</span>
-<a id="__codelineno-0-306" name="__codelineno-0-306"></a>                                <span class="ow">or</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
-<a id="__codelineno-0-307" name="__codelineno-0-307"></a>                                    <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-308" name="__codelineno-0-308"></a>                                    <span class="n">source_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-309" name="__codelineno-0-309"></a>                                    <span class="n">destination_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-310" name="__codelineno-0-310"></a>                                <span class="p">)</span><span class="o">.</span><span class="n">exists</span><span class="p">()</span>
-<a id="__codelineno-0-311" name="__codelineno-0-311"></a>                            <span class="p">):</span>
-<a id="__codelineno-0-312" name="__codelineno-0-312"></a>                                <span class="n">ra</span> <span class="o">=</span> <span class="kc">None</span>
-<a id="__codelineno-0-313" name="__codelineno-0-313"></a>                                <span class="n">created</span> <span class="o">=</span> <span class="kc">False</span>
-<a id="__codelineno-0-314" name="__codelineno-0-314"></a>                            <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-315" name="__codelineno-0-315"></a>                                <span class="n">ra</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
-<a id="__codelineno-0-316" name="__codelineno-0-316"></a>                                    <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-317" name="__codelineno-0-317"></a>                                    <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
-<a id="__codelineno-0-318" name="__codelineno-0-318"></a>                                    <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-319" name="__codelineno-0-319"></a>                                    <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
-<a id="__codelineno-0-320" name="__codelineno-0-320"></a>                                    <span class="n">destination_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-321" name="__codelineno-0-321"></a>                                <span class="p">)</span>
-<a id="__codelineno-0-322" name="__codelineno-0-322"></a>                                <span class="n">created</span> <span class="o">=</span> <span class="kc">True</span>
-<a id="__codelineno-0-323" name="__codelineno-0-323"></a>
-<a id="__codelineno-0-324" name="__codelineno-0-324"></a>                        <span class="k">if</span> <span class="n">created</span><span class="p">:</span>
-<a id="__codelineno-0-325" name="__codelineno-0-325"></a>                            <span class="n">ra</span><span class="o">.</span><span class="n">validated_save</span><span class="p">()</span>
-<a id="__codelineno-0-326" name="__codelineno-0-326"></a>                            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Created </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
-<a id="__codelineno-0-327" name="__codelineno-0-327"></a>
-<a id="__codelineno-0-328" name="__codelineno-0-328"></a>                <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
-<a id="__codelineno-0-329" name="__codelineno-0-329"></a>                    <span class="n">removed</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
-<a id="__codelineno-0-330" name="__codelineno-0-330"></a>
-<a id="__codelineno-0-331" name="__codelineno-0-331"></a>                    <span class="n">source_count</span> <span class="o">=</span> <span class="mi">0</span>
-<a id="__codelineno-0-332" name="__codelineno-0-332"></a>                    <span class="n">destination_count</span> <span class="o">=</span> <span class="mi">0</span>
-<a id="__codelineno-0-333" name="__codelineno-0-333"></a>                    <span class="k">if</span> <span class="n">side</span> <span class="ow">in</span> <span class="p">[</span><span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_SOURCE</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">]:</span>
-<a id="__codelineno-0-334" name="__codelineno-0-334"></a>                        <span class="n">source_count</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
-<a id="__codelineno-0-335" name="__codelineno-0-335"></a>                            <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-336" name="__codelineno-0-336"></a>                            <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-337" name="__codelineno-0-337"></a>                            <span class="n">destination_id__in</span><span class="o">=</span><span class="p">[</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span> <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">removed</span><span class="p">],</span>
-<a id="__codelineno-0-338" name="__codelineno-0-338"></a>                        <span class="p">)</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
-<a id="__codelineno-0-339" name="__codelineno-0-339"></a>                    <span class="k">if</span> <span class="n">side</span> <span class="ow">in</span> <span class="p">[</span><span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_DESTINATION</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">]:</span>
-<a id="__codelineno-0-340" name="__codelineno-0-340"></a>                        <span class="n">destination_count</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
-<a id="__codelineno-0-341" name="__codelineno-0-341"></a>                            <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-342" name="__codelineno-0-342"></a>                            <span class="n">source_id__in</span><span class="o">=</span><span class="p">[</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span> <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">removed</span><span class="p">],</span>
-<a id="__codelineno-0-343" name="__codelineno-0-343"></a>                            <span class="n">destination_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-344" name="__codelineno-0-344"></a>                        <span class="p">)</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
-<a id="__codelineno-0-345" name="__codelineno-0-345"></a>                    <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Deleted </span><span class="si">%s</span><span class="s2"> RelationshipAssociation(s)&quot;</span><span class="p">,</span> <span class="n">source_count</span> <span class="o">+</span> <span class="n">destination_count</span><span class="p">)</span>
+<a id="__codelineno-0-306" name="__codelineno-0-306"></a>                            <span class="p">):</span>
+<a id="__codelineno-0-307" name="__codelineno-0-307"></a>                                <span class="n">ra</span> <span class="o">=</span> <span class="kc">None</span>
+<a id="__codelineno-0-308" name="__codelineno-0-308"></a>                                <span class="n">created</span> <span class="o">=</span> <span class="kc">False</span>
+<a id="__codelineno-0-309" name="__codelineno-0-309"></a>                            <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-310" name="__codelineno-0-310"></a>                                <span class="n">ra</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">create</span><span class="p">(</span>
+<a id="__codelineno-0-311" name="__codelineno-0-311"></a>                                    <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-312" name="__codelineno-0-312"></a>                                    <span class="n">source_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">source_type</span><span class="p">,</span>
+<a id="__codelineno-0-313" name="__codelineno-0-313"></a>                                    <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-314" name="__codelineno-0-314"></a>                                    <span class="n">destination_type</span><span class="o">=</span><span class="n">relationship</span><span class="o">.</span><span class="n">destination_type</span><span class="p">,</span>
+<a id="__codelineno-0-315" name="__codelineno-0-315"></a>                                    <span class="n">destination_id</span><span class="o">=</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-316" name="__codelineno-0-316"></a>                                <span class="p">)</span>
+<a id="__codelineno-0-317" name="__codelineno-0-317"></a>                                <span class="n">created</span> <span class="o">=</span> <span class="kc">True</span>
+<a id="__codelineno-0-318" name="__codelineno-0-318"></a>
+<a id="__codelineno-0-319" name="__codelineno-0-319"></a>                        <span class="k">if</span> <span class="n">created</span><span class="p">:</span>
+<a id="__codelineno-0-320" name="__codelineno-0-320"></a>                            <span class="n">ra</span><span class="o">.</span><span class="n">validated_save</span><span class="p">()</span>
+<a id="__codelineno-0-321" name="__codelineno-0-321"></a>                            <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Created </span><span class="si">%s</span><span class="s2">&quot;</span><span class="p">,</span> <span class="n">ra</span><span class="p">)</span>
+<a id="__codelineno-0-322" name="__codelineno-0-322"></a>
+<a id="__codelineno-0-323" name="__codelineno-0-323"></a>                <span class="k">if</span> <span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">:</span>
+<a id="__codelineno-0-324" name="__codelineno-0-324"></a>                    <span class="n">removed</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="sa">f</span><span class="s2">&quot;remove_</span><span class="si">{</span><span class="n">field_name</span><span class="si">}</span><span class="s2">&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-325" name="__codelineno-0-325"></a>
+<a id="__codelineno-0-326" name="__codelineno-0-326"></a>                    <span class="n">source_count</span> <span class="o">=</span> <span class="mi">0</span>
+<a id="__codelineno-0-327" name="__codelineno-0-327"></a>                    <span class="n">destination_count</span> <span class="o">=</span> <span class="mi">0</span>
+<a id="__codelineno-0-328" name="__codelineno-0-328"></a>                    <span class="k">if</span> <span class="n">side</span> <span class="ow">in</span> <span class="p">[</span><span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_SOURCE</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">]:</span>
+<a id="__codelineno-0-329" name="__codelineno-0-329"></a>                        <span class="n">source_count</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-330" name="__codelineno-0-330"></a>                            <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-331" name="__codelineno-0-331"></a>                            <span class="n">source_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-332" name="__codelineno-0-332"></a>                            <span class="n">destination_id__in</span><span class="o">=</span><span class="p">[</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span> <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">removed</span><span class="p">],</span>
+<a id="__codelineno-0-333" name="__codelineno-0-333"></a>                        <span class="p">)</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
+<a id="__codelineno-0-334" name="__codelineno-0-334"></a>                    <span class="k">if</span> <span class="n">side</span> <span class="ow">in</span> <span class="p">[</span><span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_DESTINATION</span><span class="p">,</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">]:</span>
+<a id="__codelineno-0-335" name="__codelineno-0-335"></a>                        <span class="n">destination_count</span><span class="p">,</span> <span class="n">_</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-336" name="__codelineno-0-336"></a>                            <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-337" name="__codelineno-0-337"></a>                            <span class="n">source_id__in</span><span class="o">=</span><span class="p">[</span><span class="n">target</span><span class="o">.</span><span class="n">pk</span> <span class="k">for</span> <span class="n">target</span> <span class="ow">in</span> <span class="n">removed</span><span class="p">],</span>
+<a id="__codelineno-0-338" name="__codelineno-0-338"></a>                            <span class="n">destination_id</span><span class="o">=</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-339" name="__codelineno-0-339"></a>                        <span class="p">)</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
+<a id="__codelineno-0-340" name="__codelineno-0-340"></a>                    <span class="n">logger</span><span class="o">.</span><span class="n">debug</span><span class="p">(</span><span class="s2">&quot;Deleted </span><span class="si">%s</span><span class="s2"> RelationshipAssociation(s)&quot;</span><span class="p">,</span> <span class="n">source_count</span> <span class="o">+</span> <span class="n">destination_count</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
       </details>
   </div>
@@ -4786,7 +5977,9 @@ NoteModelFormMixin are needed.</p>
         <details class="quote">
           <summary>Source code in <code>nautobot/extras/forms/mixins.py</code></summary>
-          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-442">442</a></span>
+          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-440">440</a></span>
+<span class="normal"><a href="#__codelineno-0-441">441</a></span>
+<span class="normal"><a href="#__codelineno-0-442">442</a></span>
 <span class="normal"><a href="#__codelineno-0-443">443</a></span>
 <span class="normal"><a href="#__codelineno-0-444">444</a></span>
 <span class="normal"><a href="#__codelineno-0-445">445</a></span>
@@ -4980,205 +6173,203 @@ NoteModelFormMixin are needed.</p>
 <span class="normal"><a href="#__codelineno-0-633">633</a></span>
 <span class="normal"><a href="#__codelineno-0-634">634</a></span>
 <span class="normal"><a href="#__codelineno-0-635">635</a></span>
-<span class="normal"><a href="#__codelineno-0-636">636</a></span>
-<span class="normal"><a href="#__codelineno-0-637">637</a></span>
-<span class="normal"><a href="#__codelineno-0-638">638</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-442" name="__codelineno-0-442"></a><span class="k">class</span> <span class="nc">RelationshipModelFormMixin</span><span class="p">(</span><span class="n">forms</span><span class="o">.</span><span class="n">ModelForm</span><span class="p">):</span>
-<a id="__codelineno-0-443" name="__codelineno-0-443"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-<a id="__codelineno-0-444" name="__codelineno-0-444"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span> <span class="o">=</span> <span class="n">ContentType</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_for_model</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_meta</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
-<a id="__codelineno-0-445" name="__codelineno-0-445"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span> <span class="o">=</span> <span class="p">[]</span>
-<a id="__codelineno-0-446" name="__codelineno-0-446"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+<span class="normal"><a href="#__codelineno-0-636">636</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-440" name="__codelineno-0-440"></a><span class="k">class</span> <span class="nc">RelationshipModelFormMixin</span><span class="p">(</span><span class="n">forms</span><span class="o">.</span><span class="n">ModelForm</span><span class="p">):</span>
+<a id="__codelineno-0-441" name="__codelineno-0-441"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+<a id="__codelineno-0-442" name="__codelineno-0-442"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span> <span class="o">=</span> <span class="n">ContentType</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">get_for_model</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">_meta</span><span class="o">.</span><span class="n">model</span><span class="p">)</span>
+<a id="__codelineno-0-443" name="__codelineno-0-443"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span> <span class="o">=</span> <span class="p">[]</span>
+<a id="__codelineno-0-444" name="__codelineno-0-444"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+<a id="__codelineno-0-445" name="__codelineno-0-445"></a>
+<a id="__codelineno-0-446" name="__codelineno-0-446"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_append_relationships</span><span class="p">()</span>
 <a id="__codelineno-0-447" name="__codelineno-0-447"></a>
-<a id="__codelineno-0-448" name="__codelineno-0-448"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">_append_relationships</span><span class="p">()</span>
-<a id="__codelineno-0-449" name="__codelineno-0-449"></a>
-<a id="__codelineno-0-450" name="__codelineno-0-450"></a>    <span class="k">def</span> <span class="nf">_append_relationships</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-0-451" name="__codelineno-0-451"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-452" name="__codelineno-0-452"></a><span class="sd">        Append form fields for all Relationships assigned to this model.</span>
-<a id="__codelineno-0-453" name="__codelineno-0-453"></a><span class="sd">        One form field per side will be added to the list.</span>
-<a id="__codelineno-0-454" name="__codelineno-0-454"></a><span class="sd">        &quot;&quot;&quot;</span>
-<a id="__codelineno-0-455" name="__codelineno-0-455"></a>        <span class="k">for</span> <span class="n">side</span><span class="p">,</span> <span class="n">relationships</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">get_relationships</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-456" name="__codelineno-0-456"></a>            <span class="k">for</span> <span class="n">relationship</span><span class="p">,</span> <span class="n">queryset</span> <span class="ow">in</span> <span class="n">relationships</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-457" name="__codelineno-0-457"></a>                <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
-<a id="__codelineno-0-458" name="__codelineno-0-458"></a>                <span class="c1"># If this model is on the &quot;source&quot; side of the relationship, then the field will be named</span>
-<a id="__codelineno-0-459" name="__codelineno-0-459"></a>                <span class="c1"># cr_&lt;relationship-slug&gt;__destination since it&#39;s used to pick the destination object(s).</span>
-<a id="__codelineno-0-460" name="__codelineno-0-460"></a>                <span class="c1"># If we&#39;re on the &quot;destination&quot; side, the field will be cr_&lt;relationship-slug&gt;__source.</span>
-<a id="__codelineno-0-461" name="__codelineno-0-461"></a>                <span class="c1"># For a symmetric relationship, both sides are &quot;peer&quot;, so the field will be cr_&lt;relationship-slug&gt;__peer</span>
-<a id="__codelineno-0-462" name="__codelineno-0-462"></a>                <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">slug</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
-<a id="__codelineno-0-463" name="__codelineno-0-463"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">relationship</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">side</span><span class="o">=</span><span class="n">side</span><span class="p">)</span>
-<a id="__codelineno-0-464" name="__codelineno-0-464"></a>
-<a id="__codelineno-0-465" name="__codelineno-0-465"></a>                <span class="c1"># HTML5 validation for required relationship field:</span>
-<a id="__codelineno-0-466" name="__codelineno-0-466"></a>                <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">required_on</span> <span class="o">==</span> <span class="n">side</span><span class="p">:</span>
-<a id="__codelineno-0-467" name="__codelineno-0-467"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">required</span> <span class="o">=</span> <span class="kc">True</span>
-<a id="__codelineno-0-468" name="__codelineno-0-468"></a>
-<a id="__codelineno-0-469" name="__codelineno-0-469"></a>                <span class="c1"># if the object already exists, populate the field with existing values</span>
-<a id="__codelineno-0-470" name="__codelineno-0-470"></a>                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">present_in_database</span><span class="p">:</span>
-<a id="__codelineno-0-471" name="__codelineno-0-471"></a>                    <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">peer_side</span><span class="p">):</span>
-<a id="__codelineno-0-472" name="__codelineno-0-472"></a>                        <span class="n">initial</span> <span class="o">=</span> <span class="p">[</span><span class="n">association</span><span class="o">.</span><span class="n">get_peer</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="p">)</span> <span class="k">for</span> <span class="n">association</span> <span class="ow">in</span> <span class="n">queryset</span><span class="o">.</span><span class="n">all</span><span class="p">()]</span>
-<a id="__codelineno-0-473" name="__codelineno-0-473"></a>                        <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">initial</span> <span class="o">=</span> <span class="n">initial</span>
-<a id="__codelineno-0-474" name="__codelineno-0-474"></a>                    <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-475" name="__codelineno-0-475"></a>                        <span class="n">association</span> <span class="o">=</span> <span class="n">queryset</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
-<a id="__codelineno-0-476" name="__codelineno-0-476"></a>                        <span class="k">if</span> <span class="n">association</span><span class="p">:</span>
-<a id="__codelineno-0-477" name="__codelineno-0-477"></a>                            <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">initial</span> <span class="o">=</span> <span class="n">association</span><span class="o">.</span><span class="n">get_peer</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="p">)</span>
-<a id="__codelineno-0-478" name="__codelineno-0-478"></a>
-<a id="__codelineno-0-479" name="__codelineno-0-479"></a>                <span class="c1"># Annotate the field in the list of Relationship form fields</span>
-<a id="__codelineno-0-480" name="__codelineno-0-480"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
-<a id="__codelineno-0-481" name="__codelineno-0-481"></a>
-<a id="__codelineno-0-482" name="__codelineno-0-482"></a>    <span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-0-483" name="__codelineno-0-483"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-484" name="__codelineno-0-484"></a><span class="sd">        First check for any required relationships errors and if there are any, add them via form field errors.</span>
-<a id="__codelineno-0-485" name="__codelineno-0-485"></a><span class="sd">        Then verify that any requested RelationshipAssociations do not violate relationship cardinality restrictions.</span>
-<a id="__codelineno-0-486" name="__codelineno-0-486"></a>
-<a id="__codelineno-0-487" name="__codelineno-0-487"></a><span class="sd">        - For TYPE_ONE_TO_MANY and TYPE_ONE_TO_ONE relations, if the form&#39;s object is on the &quot;source&quot; side of</span>
-<a id="__codelineno-0-488" name="__codelineno-0-488"></a><span class="sd">          the relationship, verify that the requested &quot;destination&quot; object(s) do not already have any existing</span>
-<a id="__codelineno-0-489" name="__codelineno-0-489"></a><span class="sd">          RelationshipAssociation to a different source object.</span>
-<a id="__codelineno-0-490" name="__codelineno-0-490"></a><span class="sd">        - For TYPE_ONE_TO_ONE relations, if the form&#39;s object is on the &quot;destination&quot; side of the relationship,</span>
-<a id="__codelineno-0-491" name="__codelineno-0-491"></a><span class="sd">          verify that the requested &quot;source&quot; object does not have an existing RelationshipAssociation to</span>
-<a id="__codelineno-0-492" name="__codelineno-0-492"></a><span class="sd">          a different destination object.</span>
-<a id="__codelineno-0-493" name="__codelineno-0-493"></a><span class="sd">        &quot;&quot;&quot;</span>
-<a id="__codelineno-0-494" name="__codelineno-0-494"></a>        <span class="n">required_relationships_errors</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">Meta</span><span class="p">()</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">required_related_objects_errors</span><span class="p">(</span>
-<a id="__codelineno-0-495" name="__codelineno-0-495"></a>            <span class="n">output_for</span><span class="o">=</span><span class="s2">&quot;ui&quot;</span><span class="p">,</span> <span class="n">initial_data</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">,</span> <span class="n">instance</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span>
-<a id="__codelineno-0-496" name="__codelineno-0-496"></a>        <span class="p">)</span>
-<a id="__codelineno-0-497" name="__codelineno-0-497"></a>        <span class="k">for</span> <span class="n">field</span><span class="p">,</span> <span class="n">errors</span> <span class="ow">in</span> <span class="n">required_relationships_errors</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-498" name="__codelineno-0-498"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">add_error</span><span class="p">(</span><span class="n">field</span><span class="p">,</span> <span class="n">errors</span><span class="p">)</span>
-<a id="__codelineno-0-499" name="__codelineno-0-499"></a>
-<a id="__codelineno-0-500" name="__codelineno-0-500"></a>        <span class="k">for</span> <span class="n">side</span><span class="p">,</span> <span class="n">relationships</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">get_relationships</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-501" name="__codelineno-0-501"></a>            <span class="k">for</span> <span class="n">relationship</span> <span class="ow">in</span> <span class="n">relationships</span><span class="p">:</span>
-<a id="__codelineno-0-502" name="__codelineno-0-502"></a>                <span class="c1"># The form field name reflects what it provides, i.e. the peer object(s) to link via this relationship.</span>
-<a id="__codelineno-0-503" name="__codelineno-0-503"></a>                <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
-<a id="__codelineno-0-504" name="__codelineno-0-504"></a>                <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">slug</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
-<a id="__codelineno-0-505" name="__codelineno-0-505"></a>
-<a id="__codelineno-0-506" name="__codelineno-0-506"></a>                <span class="c1"># Is the form trying to set this field (create/update a RelationshipAssociation(s))?</span>
-<a id="__codelineno-0-507" name="__codelineno-0-507"></a>                <span class="c1"># If not (that is, clearing the field / deleting RelationshipAssociation(s)), we don&#39;t need to check.</span>
-<a id="__codelineno-0-508" name="__codelineno-0-508"></a>                <span class="k">if</span> <span class="n">field_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]:</span>
-<a id="__codelineno-0-509" name="__codelineno-0-509"></a>                    <span class="k">continue</span>
-<a id="__codelineno-0-510" name="__codelineno-0-510"></a>
-<a id="__codelineno-0-511" name="__codelineno-0-511"></a>                <span class="c1"># Are any of the objects we want a relationship with already entangled with another object?</span>
-<a id="__codelineno-0-512" name="__codelineno-0-512"></a>                <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">peer_side</span><span class="p">):</span>
-<a id="__codelineno-0-513" name="__codelineno-0-513"></a>                    <span class="n">target_peers</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">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">])</span>
-<a id="__codelineno-0-514" name="__codelineno-0-514"></a>                <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-515" name="__codelineno-0-515"></a>                    <span class="n">target_peers</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]]</span>
-<a id="__codelineno-0-516" name="__codelineno-0-516"></a>
-<a id="__codelineno-0-517" name="__codelineno-0-517"></a>                <span class="k">for</span> <span class="n">target_peer</span> <span class="ow">in</span> <span class="n">target_peers</span><span class="p">:</span>
-<a id="__codelineno-0-518" name="__codelineno-0-518"></a>                    <span class="k">if</span> <span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span> <span class="o">==</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">:</span>
-<a id="__codelineno-0-519" name="__codelineno-0-519"></a>                        <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">(</span>
-<a id="__codelineno-0-520" name="__codelineno-0-520"></a>                            <span class="p">{</span><span class="n">field_name</span><span class="p">:</span> <span class="sa">f</span><span class="s2">&quot;Object </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="si">}</span><span class="s2"> cannot form a relationship to itself!&quot;</span><span class="p">}</span>
-<a id="__codelineno-0-521" name="__codelineno-0-521"></a>                        <span class="p">)</span>
-<a id="__codelineno-0-522" name="__codelineno-0-522"></a>
-<a id="__codelineno-0-523" name="__codelineno-0-523"></a>                    <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">side</span><span class="p">):</span>
-<a id="__codelineno-0-524" name="__codelineno-0-524"></a>                        <span class="c1"># No need to check for existing RelationshipAssociations since this is a &quot;many&quot; relationship</span>
-<a id="__codelineno-0-525" name="__codelineno-0-525"></a>                        <span class="k">continue</span>
-<a id="__codelineno-0-526" name="__codelineno-0-526"></a>
-<a id="__codelineno-0-527" name="__codelineno-0-527"></a>                    <span class="k">if</span> <span class="ow">not</span> <span class="n">relationship</span><span class="o">.</span><span class="n">symmetric</span><span class="p">:</span>
-<a id="__codelineno-0-528" name="__codelineno-0-528"></a>                        <span class="n">existing_peer_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
-<a id="__codelineno-0-529" name="__codelineno-0-529"></a>                            <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-530" name="__codelineno-0-530"></a>                            <span class="o">**</span><span class="p">{</span>
-<a id="__codelineno-0-531" name="__codelineno-0-531"></a>                                <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-532" name="__codelineno-0-532"></a>                            <span class="p">},</span>
-<a id="__codelineno-0-533" name="__codelineno-0-533"></a>                        <span class="p">)</span><span class="o">.</span><span class="n">exclude</span><span class="p">(</span><span class="o">**</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">})</span>
-<a id="__codelineno-0-534" name="__codelineno-0-534"></a>                    <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-535" name="__codelineno-0-535"></a>                        <span class="n">existing_peer_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
-<a id="__codelineno-0-536" name="__codelineno-0-536"></a>                            <span class="p">(</span>
-<a id="__codelineno-0-537" name="__codelineno-0-537"></a>                                <span class="p">(</span><span class="n">Q</span><span class="p">(</span><span class="n">source_id</span><span class="o">=</span><span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span> <span class="o">&amp;</span> <span class="o">~</span><span class="n">Q</span><span class="p">(</span><span class="n">destination_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">))</span>
-<a id="__codelineno-0-538" name="__codelineno-0-538"></a>                                <span class="o">|</span> <span class="p">(</span><span class="n">Q</span><span class="p">(</span><span class="n">destination_id</span><span class="o">=</span><span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span> <span class="o">&amp;</span> <span class="o">~</span><span class="n">Q</span><span class="p">(</span><span class="n">source_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">))</span>
-<a id="__codelineno-0-539" name="__codelineno-0-539"></a>                            <span class="p">),</span>
-<a id="__codelineno-0-540" name="__codelineno-0-540"></a>                            <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-541" name="__codelineno-0-541"></a>                        <span class="p">)</span>
-<a id="__codelineno-0-542" name="__codelineno-0-542"></a>
-<a id="__codelineno-0-543" name="__codelineno-0-543"></a>                    <span class="k">if</span> <span class="n">existing_peer_associations</span><span class="o">.</span><span class="n">exists</span><span class="p">():</span>
-<a id="__codelineno-0-544" name="__codelineno-0-544"></a>                        <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">(</span>
-<a id="__codelineno-0-545" name="__codelineno-0-545"></a>                            <span class="p">{</span><span class="n">field_name</span><span class="p">:</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">target_peer</span><span class="si">}</span><span class="s2"> is already involved in a </span><span class="si">{</span><span class="n">relationship</span><span class="si">}</span><span class="s2"> relationship&quot;</span><span class="p">}</span>
-<a id="__codelineno-0-546" name="__codelineno-0-546"></a>                        <span class="p">)</span>
+<a id="__codelineno-0-448" name="__codelineno-0-448"></a>    <span class="k">def</span> <span class="nf">_append_relationships</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-0-449" name="__codelineno-0-449"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-450" name="__codelineno-0-450"></a><span class="sd">        Append form fields for all Relationships assigned to this model.</span>
+<a id="__codelineno-0-451" name="__codelineno-0-451"></a><span class="sd">        One form field per side will be added to the list.</span>
+<a id="__codelineno-0-452" name="__codelineno-0-452"></a><span class="sd">        &quot;&quot;&quot;</span>
+<a id="__codelineno-0-453" name="__codelineno-0-453"></a>        <span class="k">for</span> <span class="n">side</span><span class="p">,</span> <span class="n">relationships</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">get_relationships</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-454" name="__codelineno-0-454"></a>            <span class="k">for</span> <span class="n">relationship</span><span class="p">,</span> <span class="n">queryset</span> <span class="ow">in</span> <span class="n">relationships</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-455" name="__codelineno-0-455"></a>                <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
+<a id="__codelineno-0-456" name="__codelineno-0-456"></a>                <span class="c1"># If this model is on the &quot;source&quot; side of the relationship, then the field will be named</span>
+<a id="__codelineno-0-457" name="__codelineno-0-457"></a>                <span class="c1"># cr_&lt;relationship_key&gt;__destination since it&#39;s used to pick the destination object(s).</span>
+<a id="__codelineno-0-458" name="__codelineno-0-458"></a>                <span class="c1"># If we&#39;re on the &quot;destination&quot; side, the field will be cr_&lt;relationship_key&gt;__source.</span>
+<a id="__codelineno-0-459" name="__codelineno-0-459"></a>                <span class="c1"># For a symmetric relationship, both sides are &quot;peer&quot;, so the field will be cr_&lt;relationship_key&gt;__peer</span>
+<a id="__codelineno-0-460" name="__codelineno-0-460"></a>                <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">key</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
+<a id="__codelineno-0-461" name="__codelineno-0-461"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span> <span class="o">=</span> <span class="n">relationship</span><span class="o">.</span><span class="n">to_form_field</span><span class="p">(</span><span class="n">side</span><span class="o">=</span><span class="n">side</span><span class="p">)</span>
+<a id="__codelineno-0-462" name="__codelineno-0-462"></a>
+<a id="__codelineno-0-463" name="__codelineno-0-463"></a>                <span class="c1"># HTML5 validation for required relationship field:</span>
+<a id="__codelineno-0-464" name="__codelineno-0-464"></a>                <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">required_on</span> <span class="o">==</span> <span class="n">side</span><span class="p">:</span>
+<a id="__codelineno-0-465" name="__codelineno-0-465"></a>                    <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">required</span> <span class="o">=</span> <span class="kc">True</span>
+<a id="__codelineno-0-466" name="__codelineno-0-466"></a>
+<a id="__codelineno-0-467" name="__codelineno-0-467"></a>                <span class="c1"># if the object already exists, populate the field with existing values</span>
+<a id="__codelineno-0-468" name="__codelineno-0-468"></a>                <span class="k">if</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">present_in_database</span><span class="p">:</span>
+<a id="__codelineno-0-469" name="__codelineno-0-469"></a>                    <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">peer_side</span><span class="p">):</span>
+<a id="__codelineno-0-470" name="__codelineno-0-470"></a>                        <span class="n">initial</span> <span class="o">=</span> <span class="p">[</span><span class="n">association</span><span class="o">.</span><span class="n">get_peer</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="p">)</span> <span class="k">for</span> <span class="n">association</span> <span class="ow">in</span> <span class="n">queryset</span><span class="o">.</span><span class="n">all</span><span class="p">()]</span>
+<a id="__codelineno-0-471" name="__codelineno-0-471"></a>                        <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">initial</span> <span class="o">=</span> <span class="n">initial</span>
+<a id="__codelineno-0-472" name="__codelineno-0-472"></a>                    <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-473" name="__codelineno-0-473"></a>                        <span class="n">association</span> <span class="o">=</span> <span class="n">queryset</span><span class="o">.</span><span class="n">first</span><span class="p">()</span>
+<a id="__codelineno-0-474" name="__codelineno-0-474"></a>                        <span class="k">if</span> <span class="n">association</span><span class="p">:</span>
+<a id="__codelineno-0-475" name="__codelineno-0-475"></a>                            <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">initial</span> <span class="o">=</span> <span class="n">association</span><span class="o">.</span><span class="n">get_peer</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="p">)</span>
+<a id="__codelineno-0-476" name="__codelineno-0-476"></a>
+<a id="__codelineno-0-477" name="__codelineno-0-477"></a>                <span class="c1"># Annotate the field in the list of Relationship form fields</span>
+<a id="__codelineno-0-478" name="__codelineno-0-478"></a>                <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span><span class="o">.</span><span class="n">append</span><span class="p">(</span><span class="n">field_name</span><span class="p">)</span>
+<a id="__codelineno-0-479" name="__codelineno-0-479"></a>
+<a id="__codelineno-0-480" name="__codelineno-0-480"></a>    <span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-0-481" name="__codelineno-0-481"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-482" name="__codelineno-0-482"></a><span class="sd">        First check for any required relationships errors and if there are any, add them via form field errors.</span>
+<a id="__codelineno-0-483" name="__codelineno-0-483"></a><span class="sd">        Then verify that any requested RelationshipAssociations do not violate relationship cardinality restrictions.</span>
+<a id="__codelineno-0-484" name="__codelineno-0-484"></a>
+<a id="__codelineno-0-485" name="__codelineno-0-485"></a><span class="sd">        - For TYPE_ONE_TO_MANY and TYPE_ONE_TO_ONE relations, if the form&#39;s object is on the &quot;source&quot; side of</span>
+<a id="__codelineno-0-486" name="__codelineno-0-486"></a><span class="sd">          the relationship, verify that the requested &quot;destination&quot; object(s) do not already have any existing</span>
+<a id="__codelineno-0-487" name="__codelineno-0-487"></a><span class="sd">          RelationshipAssociation to a different source object.</span>
+<a id="__codelineno-0-488" name="__codelineno-0-488"></a><span class="sd">        - For TYPE_ONE_TO_ONE relations, if the form&#39;s object is on the &quot;destination&quot; side of the relationship,</span>
+<a id="__codelineno-0-489" name="__codelineno-0-489"></a><span class="sd">          verify that the requested &quot;source&quot; object does not have an existing RelationshipAssociation to</span>
+<a id="__codelineno-0-490" name="__codelineno-0-490"></a><span class="sd">          a different destination object.</span>
+<a id="__codelineno-0-491" name="__codelineno-0-491"></a><span class="sd">        &quot;&quot;&quot;</span>
+<a id="__codelineno-0-492" name="__codelineno-0-492"></a>        <span class="n">required_relationships_errors</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">Meta</span><span class="p">()</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">required_related_objects_errors</span><span class="p">(</span>
+<a id="__codelineno-0-493" name="__codelineno-0-493"></a>            <span class="n">output_for</span><span class="o">=</span><span class="s2">&quot;ui&quot;</span><span class="p">,</span> <span class="n">initial_data</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">,</span> <span class="n">instance</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span>
+<a id="__codelineno-0-494" name="__codelineno-0-494"></a>        <span class="p">)</span>
+<a id="__codelineno-0-495" name="__codelineno-0-495"></a>        <span class="k">for</span> <span class="n">field</span><span class="p">,</span> <span class="n">errors</span> <span class="ow">in</span> <span class="n">required_relationships_errors</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-496" name="__codelineno-0-496"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">add_error</span><span class="p">(</span><span class="n">field</span><span class="p">,</span> <span class="n">errors</span><span class="p">)</span>
+<a id="__codelineno-0-497" name="__codelineno-0-497"></a>
+<a id="__codelineno-0-498" name="__codelineno-0-498"></a>        <span class="k">for</span> <span class="n">side</span><span class="p">,</span> <span class="n">relationships</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">get_relationships</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-499" name="__codelineno-0-499"></a>            <span class="k">for</span> <span class="n">relationship</span> <span class="ow">in</span> <span class="n">relationships</span><span class="p">:</span>
+<a id="__codelineno-0-500" name="__codelineno-0-500"></a>                <span class="c1"># The form field name reflects what it provides, i.e. the peer object(s) to link via this relationship.</span>
+<a id="__codelineno-0-501" name="__codelineno-0-501"></a>                <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
+<a id="__codelineno-0-502" name="__codelineno-0-502"></a>                <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">key</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
+<a id="__codelineno-0-503" name="__codelineno-0-503"></a>
+<a id="__codelineno-0-504" name="__codelineno-0-504"></a>                <span class="c1"># Is the form trying to set this field (create/update a RelationshipAssociation(s))?</span>
+<a id="__codelineno-0-505" name="__codelineno-0-505"></a>                <span class="c1"># If not (that is, clearing the field / deleting RelationshipAssociation(s)), we don&#39;t need to check.</span>
+<a id="__codelineno-0-506" name="__codelineno-0-506"></a>                <span class="k">if</span> <span class="n">field_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]:</span>
+<a id="__codelineno-0-507" name="__codelineno-0-507"></a>                    <span class="k">continue</span>
+<a id="__codelineno-0-508" name="__codelineno-0-508"></a>
+<a id="__codelineno-0-509" name="__codelineno-0-509"></a>                <span class="c1"># Are any of the objects we want a relationship with already entangled with another object?</span>
+<a id="__codelineno-0-510" name="__codelineno-0-510"></a>                <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">peer_side</span><span class="p">):</span>
+<a id="__codelineno-0-511" name="__codelineno-0-511"></a>                    <span class="n">target_peers</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">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">])</span>
+<a id="__codelineno-0-512" name="__codelineno-0-512"></a>                <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-513" name="__codelineno-0-513"></a>                    <span class="n">target_peers</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]]</span>
+<a id="__codelineno-0-514" name="__codelineno-0-514"></a>
+<a id="__codelineno-0-515" name="__codelineno-0-515"></a>                <span class="k">for</span> <span class="n">target_peer</span> <span class="ow">in</span> <span class="n">target_peers</span><span class="p">:</span>
+<a id="__codelineno-0-516" name="__codelineno-0-516"></a>                    <span class="k">if</span> <span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span> <span class="o">==</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">:</span>
+<a id="__codelineno-0-517" name="__codelineno-0-517"></a>                        <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">(</span>
+<a id="__codelineno-0-518" name="__codelineno-0-518"></a>                            <span class="p">{</span><span class="n">field_name</span><span class="p">:</span> <span class="sa">f</span><span class="s2">&quot;Object </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="si">}</span><span class="s2"> cannot form a relationship to itself!&quot;</span><span class="p">}</span>
+<a id="__codelineno-0-519" name="__codelineno-0-519"></a>                        <span class="p">)</span>
+<a id="__codelineno-0-520" name="__codelineno-0-520"></a>
+<a id="__codelineno-0-521" name="__codelineno-0-521"></a>                    <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">side</span><span class="p">):</span>
+<a id="__codelineno-0-522" name="__codelineno-0-522"></a>                        <span class="c1"># No need to check for existing RelationshipAssociations since this is a &quot;many&quot; relationship</span>
+<a id="__codelineno-0-523" name="__codelineno-0-523"></a>                        <span class="k">continue</span>
+<a id="__codelineno-0-524" name="__codelineno-0-524"></a>
+<a id="__codelineno-0-525" name="__codelineno-0-525"></a>                    <span class="k">if</span> <span class="ow">not</span> <span class="n">relationship</span><span class="o">.</span><span class="n">symmetric</span><span class="p">:</span>
+<a id="__codelineno-0-526" name="__codelineno-0-526"></a>                        <span class="n">existing_peer_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-527" name="__codelineno-0-527"></a>                            <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-528" name="__codelineno-0-528"></a>                            <span class="o">**</span><span class="p">{</span>
+<a id="__codelineno-0-529" name="__codelineno-0-529"></a>                                <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-530" name="__codelineno-0-530"></a>                            <span class="p">},</span>
+<a id="__codelineno-0-531" name="__codelineno-0-531"></a>                        <span class="p">)</span><span class="o">.</span><span class="n">exclude</span><span class="p">(</span><span class="o">**</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">})</span>
+<a id="__codelineno-0-532" name="__codelineno-0-532"></a>                    <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-533" name="__codelineno-0-533"></a>                        <span class="n">existing_peer_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-534" name="__codelineno-0-534"></a>                            <span class="p">(</span>
+<a id="__codelineno-0-535" name="__codelineno-0-535"></a>                                <span class="p">(</span><span class="n">Q</span><span class="p">(</span><span class="n">source_id</span><span class="o">=</span><span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span> <span class="o">&amp;</span> <span class="o">~</span><span class="n">Q</span><span class="p">(</span><span class="n">destination_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">))</span>
+<a id="__codelineno-0-536" name="__codelineno-0-536"></a>                                <span class="o">|</span> <span class="p">(</span><span class="n">Q</span><span class="p">(</span><span class="n">destination_id</span><span class="o">=</span><span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span> <span class="o">&amp;</span> <span class="o">~</span><span class="n">Q</span><span class="p">(</span><span class="n">source_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">))</span>
+<a id="__codelineno-0-537" name="__codelineno-0-537"></a>                            <span class="p">),</span>
+<a id="__codelineno-0-538" name="__codelineno-0-538"></a>                            <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-539" name="__codelineno-0-539"></a>                        <span class="p">)</span>
+<a id="__codelineno-0-540" name="__codelineno-0-540"></a>
+<a id="__codelineno-0-541" name="__codelineno-0-541"></a>                    <span class="k">if</span> <span class="n">existing_peer_associations</span><span class="o">.</span><span class="n">exists</span><span class="p">():</span>
+<a id="__codelineno-0-542" name="__codelineno-0-542"></a>                        <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">(</span>
+<a id="__codelineno-0-543" name="__codelineno-0-543"></a>                            <span class="p">{</span><span class="n">field_name</span><span class="p">:</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">target_peer</span><span class="si">}</span><span class="s2"> is already involved in a </span><span class="si">{</span><span class="n">relationship</span><span class="si">}</span><span class="s2"> relationship&quot;</span><span class="p">}</span>
+<a id="__codelineno-0-544" name="__codelineno-0-544"></a>                        <span class="p">)</span>
+<a id="__codelineno-0-545" name="__codelineno-0-545"></a>
+<a id="__codelineno-0-546" name="__codelineno-0-546"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">()</span>
 <a id="__codelineno-0-547" name="__codelineno-0-547"></a>
-<a id="__codelineno-0-548" name="__codelineno-0-548"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">()</span>
-<a id="__codelineno-0-549" name="__codelineno-0-549"></a>
-<a id="__codelineno-0-550" name="__codelineno-0-550"></a>    <span class="k">def</span> <span class="nf">_save_relationships</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-0-551" name="__codelineno-0-551"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Update RelationshipAssociations for all Relationships on form save.&quot;&quot;&quot;</span>
-<a id="__codelineno-0-552" name="__codelineno-0-552"></a>
-<a id="__codelineno-0-553" name="__codelineno-0-553"></a>        <span class="k">for</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span><span class="p">:</span>
-<a id="__codelineno-0-554" name="__codelineno-0-554"></a>            <span class="c1"># The field name tells us the side of the relationship that it is providing peer objects(s) to link into.</span>
-<a id="__codelineno-0-555" name="__codelineno-0-555"></a>            <span class="n">peer_side</span> <span class="o">=</span> <span class="n">field_name</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;__&quot;</span><span class="p">)[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
-<a id="__codelineno-0-556" name="__codelineno-0-556"></a>            <span class="c1"># Based on the side of the relationship that our local object represents,</span>
-<a id="__codelineno-0-557" name="__codelineno-0-557"></a>            <span class="c1"># find the list of existing RelationshipAssociations it already has for this Relationship.</span>
-<a id="__codelineno-0-558" name="__codelineno-0-558"></a>            <span class="n">side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">peer_side</span><span class="p">]</span>
-<a id="__codelineno-0-559" name="__codelineno-0-559"></a>            <span class="n">filters</span> <span class="o">=</span> <span class="p">{</span>
-<a id="__codelineno-0-560" name="__codelineno-0-560"></a>                <span class="s2">&quot;relationship&quot;</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="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">model</span><span class="p">,</span>
-<a id="__codelineno-0-561" name="__codelineno-0-561"></a>            <span class="p">}</span>
-<a id="__codelineno-0-562" name="__codelineno-0-562"></a>            <span class="k">if</span> <span class="n">side</span> <span class="o">!=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">:</span>
-<a id="__codelineno-0-563" name="__codelineno-0-563"></a>                <span class="n">filters</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_type&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">})</span>
-<a id="__codelineno-0-564" name="__codelineno-0-564"></a>                <span class="n">existing_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">**</span><span class="n">filters</span><span class="p">)</span>
-<a id="__codelineno-0-565" name="__codelineno-0-565"></a>            <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-566" name="__codelineno-0-566"></a>                <span class="n">existing_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
-<a id="__codelineno-0-567" name="__codelineno-0-567"></a>                    <span class="p">(</span>
-<a id="__codelineno-0-568" name="__codelineno-0-568"></a>                        <span class="n">Q</span><span class="p">(</span><span class="n">source_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span> <span class="n">source_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span>
-<a id="__codelineno-0-569" name="__codelineno-0-569"></a>                        <span class="o">|</span> <span class="n">Q</span><span class="p">(</span><span class="n">destination_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span> <span class="n">destination_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span>
-<a id="__codelineno-0-570" name="__codelineno-0-570"></a>                    <span class="p">),</span>
-<a id="__codelineno-0-571" name="__codelineno-0-571"></a>                    <span class="o">**</span><span class="n">filters</span><span class="p">,</span>
-<a id="__codelineno-0-572" name="__codelineno-0-572"></a>                <span class="p">)</span>
-<a id="__codelineno-0-573" name="__codelineno-0-573"></a>
-<a id="__codelineno-0-574" name="__codelineno-0-574"></a>            <span class="c1"># Get the list of target peer ids (PKs) that are specified in the form</span>
-<a id="__codelineno-0-575" name="__codelineno-0-575"></a>            <span class="n">target_peer_ids</span> <span class="o">=</span> <span class="p">[]</span>
-<a id="__codelineno-0-576" name="__codelineno-0-576"></a>            <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">],</span> <span class="s2">&quot;__iter__&quot;</span><span class="p">):</span>
-<a id="__codelineno-0-577" name="__codelineno-0-577"></a>                <span class="c1"># One-to-many or many-to-many association</span>
-<a id="__codelineno-0-578" name="__codelineno-0-578"></a>                <span class="n">target_peer_ids</span> <span class="o">=</span> <span class="p">[</span><span class="n">item</span><span class="o">.</span><span class="n">pk</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">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]]</span>
-<a id="__codelineno-0-579" name="__codelineno-0-579"></a>            <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]:</span>
-<a id="__codelineno-0-580" name="__codelineno-0-580"></a>                <span class="c1"># Many-to-one or one-to-one association</span>
-<a id="__codelineno-0-581" name="__codelineno-0-581"></a>                <span class="n">target_peer_ids</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">pk</span><span class="p">]</span>
-<a id="__codelineno-0-582" name="__codelineno-0-582"></a>            <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-583" name="__codelineno-0-583"></a>                <span class="c1"># Unset/delete case</span>
-<a id="__codelineno-0-584" name="__codelineno-0-584"></a>                <span class="n">target_peer_ids</span> <span class="o">=</span> <span class="p">[]</span>
+<a id="__codelineno-0-548" name="__codelineno-0-548"></a>    <span class="k">def</span> <span class="nf">_save_relationships</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-0-549" name="__codelineno-0-549"></a><span class="w">        </span><span class="sd">&quot;&quot;&quot;Update RelationshipAssociations for all Relationships on form save.&quot;&quot;&quot;</span>
+<a id="__codelineno-0-550" name="__codelineno-0-550"></a>
+<a id="__codelineno-0-551" name="__codelineno-0-551"></a>        <span class="k">for</span> <span class="n">field_name</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">relationships</span><span class="p">:</span>
+<a id="__codelineno-0-552" name="__codelineno-0-552"></a>            <span class="c1"># The field name tells us the side of the relationship that it is providing peer objects(s) to link into.</span>
+<a id="__codelineno-0-553" name="__codelineno-0-553"></a>            <span class="n">peer_side</span> <span class="o">=</span> <span class="n">field_name</span><span class="o">.</span><span class="n">split</span><span class="p">(</span><span class="s2">&quot;__&quot;</span><span class="p">)[</span><span class="o">-</span><span class="mi">1</span><span class="p">]</span>
+<a id="__codelineno-0-554" name="__codelineno-0-554"></a>            <span class="c1"># Based on the side of the relationship that our local object represents,</span>
+<a id="__codelineno-0-555" name="__codelineno-0-555"></a>            <span class="c1"># find the list of existing RelationshipAssociations it already has for this Relationship.</span>
+<a id="__codelineno-0-556" name="__codelineno-0-556"></a>            <span class="n">side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">peer_side</span><span class="p">]</span>
+<a id="__codelineno-0-557" name="__codelineno-0-557"></a>            <span class="n">filters</span> <span class="o">=</span> <span class="p">{</span>
+<a id="__codelineno-0-558" name="__codelineno-0-558"></a>                <span class="s2">&quot;relationship&quot;</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="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">model</span><span class="p">,</span>
+<a id="__codelineno-0-559" name="__codelineno-0-559"></a>            <span class="p">}</span>
+<a id="__codelineno-0-560" name="__codelineno-0-560"></a>            <span class="k">if</span> <span class="n">side</span> <span class="o">!=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">:</span>
+<a id="__codelineno-0-561" name="__codelineno-0-561"></a>                <span class="n">filters</span><span class="o">.</span><span class="n">update</span><span class="p">({</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_type&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">})</span>
+<a id="__codelineno-0-562" name="__codelineno-0-562"></a>                <span class="n">existing_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span><span class="o">**</span><span class="n">filters</span><span class="p">)</span>
+<a id="__codelineno-0-563" name="__codelineno-0-563"></a>            <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-564" name="__codelineno-0-564"></a>                <span class="n">existing_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-565" name="__codelineno-0-565"></a>                    <span class="p">(</span>
+<a id="__codelineno-0-566" name="__codelineno-0-566"></a>                        <span class="n">Q</span><span class="p">(</span><span class="n">source_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span> <span class="n">source_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span>
+<a id="__codelineno-0-567" name="__codelineno-0-567"></a>                        <span class="o">|</span> <span class="n">Q</span><span class="p">(</span><span class="n">destination_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span> <span class="n">destination_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span>
+<a id="__codelineno-0-568" name="__codelineno-0-568"></a>                    <span class="p">),</span>
+<a id="__codelineno-0-569" name="__codelineno-0-569"></a>                    <span class="o">**</span><span class="n">filters</span><span class="p">,</span>
+<a id="__codelineno-0-570" name="__codelineno-0-570"></a>                <span class="p">)</span>
+<a id="__codelineno-0-571" name="__codelineno-0-571"></a>
+<a id="__codelineno-0-572" name="__codelineno-0-572"></a>            <span class="c1"># Get the list of target peer ids (PKs) that are specified in the form</span>
+<a id="__codelineno-0-573" name="__codelineno-0-573"></a>            <span class="n">target_peer_ids</span> <span class="o">=</span> <span class="p">[]</span>
+<a id="__codelineno-0-574" name="__codelineno-0-574"></a>            <span class="k">if</span> <span class="nb">hasattr</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">],</span> <span class="s2">&quot;__iter__&quot;</span><span class="p">):</span>
+<a id="__codelineno-0-575" name="__codelineno-0-575"></a>                <span class="c1"># One-to-many or many-to-many association</span>
+<a id="__codelineno-0-576" name="__codelineno-0-576"></a>                <span class="n">target_peer_ids</span> <span class="o">=</span> <span class="p">[</span><span class="n">item</span><span class="o">.</span><span class="n">pk</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">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]]</span>
+<a id="__codelineno-0-577" name="__codelineno-0-577"></a>            <span class="k">elif</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]:</span>
+<a id="__codelineno-0-578" name="__codelineno-0-578"></a>                <span class="c1"># Many-to-one or one-to-one association</span>
+<a id="__codelineno-0-579" name="__codelineno-0-579"></a>                <span class="n">target_peer_ids</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">pk</span><span class="p">]</span>
+<a id="__codelineno-0-580" name="__codelineno-0-580"></a>            <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-581" name="__codelineno-0-581"></a>                <span class="c1"># Unset/delete case</span>
+<a id="__codelineno-0-582" name="__codelineno-0-582"></a>                <span class="n">target_peer_ids</span> <span class="o">=</span> <span class="p">[]</span>
+<a id="__codelineno-0-583" name="__codelineno-0-583"></a>
+<a id="__codelineno-0-584" name="__codelineno-0-584"></a>            <span class="c1"># Create/delete RelationshipAssociations as needed to match the target_peer_ids list</span>
 <a id="__codelineno-0-585" name="__codelineno-0-585"></a>
-<a id="__codelineno-0-586" name="__codelineno-0-586"></a>            <span class="c1"># Create/delete RelationshipAssociations as needed to match the target_peer_ids list</span>
-<a id="__codelineno-0-587" name="__codelineno-0-587"></a>
-<a id="__codelineno-0-588" name="__codelineno-0-588"></a>            <span class="c1"># First, for each existing association, if it&#39;s one that&#39;s already in target_peer_ids,</span>
-<a id="__codelineno-0-589" name="__codelineno-0-589"></a>            <span class="c1"># we can discard it from target_peer_ids (no update needed to this association).</span>
-<a id="__codelineno-0-590" name="__codelineno-0-590"></a>            <span class="c1"># Conversely, if it&#39;s *not* in target_peer_ids, we should delete it.</span>
-<a id="__codelineno-0-591" name="__codelineno-0-591"></a>            <span class="k">for</span> <span class="n">association</span> <span class="ow">in</span> <span class="n">existing_associations</span><span class="p">:</span>
-<a id="__codelineno-0-592" name="__codelineno-0-592"></a>                <span class="k">for</span> <span class="n">peer_id</span> <span class="ow">in</span> <span class="n">target_peer_ids</span><span class="p">:</span>
-<a id="__codelineno-0-593" name="__codelineno-0-593"></a>                    <span class="k">if</span> <span class="n">peer_side</span> <span class="o">!=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">:</span>
-<a id="__codelineno-0-594" name="__codelineno-0-594"></a>                        <span class="k">if</span> <span class="n">peer_id</span> <span class="o">==</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">association</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">):</span>
-<a id="__codelineno-0-595" name="__codelineno-0-595"></a>                            <span class="c1"># This association already exists, so we can ignore it</span>
-<a id="__codelineno-0-596" name="__codelineno-0-596"></a>                            <span class="n">target_peer_ids</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">peer_id</span><span class="p">)</span>
-<a id="__codelineno-0-597" name="__codelineno-0-597"></a>                            <span class="k">break</span>
-<a id="__codelineno-0-598" name="__codelineno-0-598"></a>                    <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-599" name="__codelineno-0-599"></a>                        <span class="k">if</span> <span class="n">peer_id</span> <span class="o">==</span> <span class="n">association</span><span class="o">.</span><span class="n">source_id</span> <span class="ow">or</span> <span class="n">peer_id</span> <span class="o">==</span> <span class="n">association</span><span class="o">.</span><span class="n">destination_id</span><span class="p">:</span>
-<a id="__codelineno-0-600" name="__codelineno-0-600"></a>                            <span class="c1"># This association already exists, so we can ignore it</span>
-<a id="__codelineno-0-601" name="__codelineno-0-601"></a>                            <span class="n">target_peer_ids</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">peer_id</span><span class="p">)</span>
-<a id="__codelineno-0-602" name="__codelineno-0-602"></a>                            <span class="k">break</span>
-<a id="__codelineno-0-603" name="__codelineno-0-603"></a>                <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-604" name="__codelineno-0-604"></a>                    <span class="c1"># This association is not in target_peer_ids, so delete it</span>
-<a id="__codelineno-0-605" name="__codelineno-0-605"></a>                    <span class="n">association</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
-<a id="__codelineno-0-606" name="__codelineno-0-606"></a>
-<a id="__codelineno-0-607" name="__codelineno-0-607"></a>            <span class="c1"># Anything remaining in target_peer_ids now does not exist yet and needs to be created.</span>
-<a id="__codelineno-0-608" name="__codelineno-0-608"></a>            <span class="k">for</span> <span class="n">peer_id</span> <span class="ow">in</span> <span class="n">target_peer_ids</span><span class="p">:</span>
-<a id="__codelineno-0-609" name="__codelineno-0-609"></a>                <span class="n">relationship</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">model</span>
-<a id="__codelineno-0-610" name="__codelineno-0-610"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">relationship</span><span class="o">.</span><span class="n">symmetric</span><span class="p">:</span>
-<a id="__codelineno-0-611" name="__codelineno-0-611"></a>                    <span class="n">association</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="p">(</span>
-<a id="__codelineno-0-612" name="__codelineno-0-612"></a>                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-613" name="__codelineno-0-613"></a>                        <span class="o">**</span><span class="p">{</span>
-<a id="__codelineno-0-614" name="__codelineno-0-614"></a>                            <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_type&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span>
-<a id="__codelineno-0-615" name="__codelineno-0-615"></a>                            <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-616" name="__codelineno-0-616"></a>                            <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_type&quot;</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">relationship</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_type&quot;</span><span class="p">),</span>
-<a id="__codelineno-0-617" name="__codelineno-0-617"></a>                            <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">peer_id</span><span class="p">,</span>
-<a id="__codelineno-0-618" name="__codelineno-0-618"></a>                        <span class="p">},</span>
-<a id="__codelineno-0-619" name="__codelineno-0-619"></a>                    <span class="p">)</span>
-<a id="__codelineno-0-620" name="__codelineno-0-620"></a>                <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-621" name="__codelineno-0-621"></a>                    <span class="c1"># Symmetric association - source/destination are interchangeable</span>
-<a id="__codelineno-0-622" name="__codelineno-0-622"></a>                    <span class="n">association</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="p">(</span>
-<a id="__codelineno-0-623" name="__codelineno-0-623"></a>                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-624" name="__codelineno-0-624"></a>                        <span class="n">source_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span>
-<a id="__codelineno-0-625" name="__codelineno-0-625"></a>                        <span class="n">source_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-626" name="__codelineno-0-626"></a>                        <span class="n">destination_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span>  <span class="c1"># since this is a symmetric relationship this is OK</span>
-<a id="__codelineno-0-627" name="__codelineno-0-627"></a>                        <span class="n">destination_id</span><span class="o">=</span><span class="n">peer_id</span><span class="p">,</span>
-<a id="__codelineno-0-628" name="__codelineno-0-628"></a>                    <span class="p">)</span>
-<a id="__codelineno-0-629" name="__codelineno-0-629"></a>
-<a id="__codelineno-0-630" name="__codelineno-0-630"></a>                <span class="n">association</span><span class="o">.</span><span class="n">clean</span><span class="p">()</span>
-<a id="__codelineno-0-631" name="__codelineno-0-631"></a>                <span class="n">association</span><span class="o">.</span><span class="n">save</span><span class="p">()</span>
-<a id="__codelineno-0-632" name="__codelineno-0-632"></a>
-<a id="__codelineno-0-633" name="__codelineno-0-633"></a>    <span class="k">def</span> <span class="nf">save</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">commit</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
-<a id="__codelineno-0-634" name="__codelineno-0-634"></a>        <span class="n">obj</span> <span class="o">=</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="n">commit</span><span class="p">)</span>
-<a id="__codelineno-0-635" name="__codelineno-0-635"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
-<a id="__codelineno-0-636" name="__codelineno-0-636"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_save_relationships</span><span class="p">()</span>
-<a id="__codelineno-0-637" name="__codelineno-0-637"></a>
-<a id="__codelineno-0-638" name="__codelineno-0-638"></a>        <span class="k">return</span> <span class="n">obj</span>
+<a id="__codelineno-0-586" name="__codelineno-0-586"></a>            <span class="c1"># First, for each existing association, if it&#39;s one that&#39;s already in target_peer_ids,</span>
+<a id="__codelineno-0-587" name="__codelineno-0-587"></a>            <span class="c1"># we can discard it from target_peer_ids (no update needed to this association).</span>
+<a id="__codelineno-0-588" name="__codelineno-0-588"></a>            <span class="c1"># Conversely, if it&#39;s *not* in target_peer_ids, we should delete it.</span>
+<a id="__codelineno-0-589" name="__codelineno-0-589"></a>            <span class="k">for</span> <span class="n">association</span> <span class="ow">in</span> <span class="n">existing_associations</span><span class="p">:</span>
+<a id="__codelineno-0-590" name="__codelineno-0-590"></a>                <span class="k">for</span> <span class="n">peer_id</span> <span class="ow">in</span> <span class="n">target_peer_ids</span><span class="p">:</span>
+<a id="__codelineno-0-591" name="__codelineno-0-591"></a>                    <span class="k">if</span> <span class="n">peer_side</span> <span class="o">!=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">SIDE_PEER</span><span class="p">:</span>
+<a id="__codelineno-0-592" name="__codelineno-0-592"></a>                        <span class="k">if</span> <span class="n">peer_id</span> <span class="o">==</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">association</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">):</span>
+<a id="__codelineno-0-593" name="__codelineno-0-593"></a>                            <span class="c1"># This association already exists, so we can ignore it</span>
+<a id="__codelineno-0-594" name="__codelineno-0-594"></a>                            <span class="n">target_peer_ids</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">peer_id</span><span class="p">)</span>
+<a id="__codelineno-0-595" name="__codelineno-0-595"></a>                            <span class="k">break</span>
+<a id="__codelineno-0-596" name="__codelineno-0-596"></a>                    <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-597" name="__codelineno-0-597"></a>                        <span class="k">if</span> <span class="n">peer_id</span> <span class="o">==</span> <span class="n">association</span><span class="o">.</span><span class="n">source_id</span> <span class="ow">or</span> <span class="n">peer_id</span> <span class="o">==</span> <span class="n">association</span><span class="o">.</span><span class="n">destination_id</span><span class="p">:</span>
+<a id="__codelineno-0-598" name="__codelineno-0-598"></a>                            <span class="c1"># This association already exists, so we can ignore it</span>
+<a id="__codelineno-0-599" name="__codelineno-0-599"></a>                            <span class="n">target_peer_ids</span><span class="o">.</span><span class="n">remove</span><span class="p">(</span><span class="n">peer_id</span><span class="p">)</span>
+<a id="__codelineno-0-600" name="__codelineno-0-600"></a>                            <span class="k">break</span>
+<a id="__codelineno-0-601" name="__codelineno-0-601"></a>                <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-602" name="__codelineno-0-602"></a>                    <span class="c1"># This association is not in target_peer_ids, so delete it</span>
+<a id="__codelineno-0-603" name="__codelineno-0-603"></a>                    <span class="n">association</span><span class="o">.</span><span class="n">delete</span><span class="p">()</span>
+<a id="__codelineno-0-604" name="__codelineno-0-604"></a>
+<a id="__codelineno-0-605" name="__codelineno-0-605"></a>            <span class="c1"># Anything remaining in target_peer_ids now does not exist yet and needs to be created.</span>
+<a id="__codelineno-0-606" name="__codelineno-0-606"></a>            <span class="k">for</span> <span class="n">peer_id</span> <span class="ow">in</span> <span class="n">target_peer_ids</span><span class="p">:</span>
+<a id="__codelineno-0-607" name="__codelineno-0-607"></a>                <span class="n">relationship</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="n">field_name</span><span class="p">]</span><span class="o">.</span><span class="n">model</span>
+<a id="__codelineno-0-608" name="__codelineno-0-608"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">relationship</span><span class="o">.</span><span class="n">symmetric</span><span class="p">:</span>
+<a id="__codelineno-0-609" name="__codelineno-0-609"></a>                    <span class="n">association</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="p">(</span>
+<a id="__codelineno-0-610" name="__codelineno-0-610"></a>                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-611" name="__codelineno-0-611"></a>                        <span class="o">**</span><span class="p">{</span>
+<a id="__codelineno-0-612" name="__codelineno-0-612"></a>                            <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_type&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span>
+<a id="__codelineno-0-613" name="__codelineno-0-613"></a>                            <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-614" name="__codelineno-0-614"></a>                            <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_type&quot;</span><span class="p">:</span> <span class="nb">getattr</span><span class="p">(</span><span class="n">relationship</span><span class="p">,</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_type&quot;</span><span class="p">),</span>
+<a id="__codelineno-0-615" name="__codelineno-0-615"></a>                            <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">peer_id</span><span class="p">,</span>
+<a id="__codelineno-0-616" name="__codelineno-0-616"></a>                        <span class="p">},</span>
+<a id="__codelineno-0-617" name="__codelineno-0-617"></a>                    <span class="p">)</span>
+<a id="__codelineno-0-618" name="__codelineno-0-618"></a>                <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-619" name="__codelineno-0-619"></a>                    <span class="c1"># Symmetric association - source/destination are interchangeable</span>
+<a id="__codelineno-0-620" name="__codelineno-0-620"></a>                    <span class="n">association</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="p">(</span>
+<a id="__codelineno-0-621" name="__codelineno-0-621"></a>                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-622" name="__codelineno-0-622"></a>                        <span class="n">source_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span>
+<a id="__codelineno-0-623" name="__codelineno-0-623"></a>                        <span class="n">source_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-624" name="__codelineno-0-624"></a>                        <span class="n">destination_type</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">obj_type</span><span class="p">,</span>  <span class="c1"># since this is a symmetric relationship this is OK</span>
+<a id="__codelineno-0-625" name="__codelineno-0-625"></a>                        <span class="n">destination_id</span><span class="o">=</span><span class="n">peer_id</span><span class="p">,</span>
+<a id="__codelineno-0-626" name="__codelineno-0-626"></a>                    <span class="p">)</span>
+<a id="__codelineno-0-627" name="__codelineno-0-627"></a>
+<a id="__codelineno-0-628" name="__codelineno-0-628"></a>                <span class="n">association</span><span class="o">.</span><span class="n">clean</span><span class="p">()</span>
+<a id="__codelineno-0-629" name="__codelineno-0-629"></a>                <span class="n">association</span><span class="o">.</span><span class="n">save</span><span class="p">()</span>
+<a id="__codelineno-0-630" name="__codelineno-0-630"></a>
+<a id="__codelineno-0-631" name="__codelineno-0-631"></a>    <span class="k">def</span> <span class="nf">save</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">commit</span><span class="o">=</span><span class="kc">True</span><span class="p">):</span>
+<a id="__codelineno-0-632" name="__codelineno-0-632"></a>        <span class="n">obj</span> <span class="o">=</span> <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">save</span><span class="p">(</span><span class="n">commit</span><span class="p">)</span>
+<a id="__codelineno-0-633" name="__codelineno-0-633"></a>        <span class="k">if</span> <span class="n">commit</span><span class="p">:</span>
+<a id="__codelineno-0-634" name="__codelineno-0-634"></a>            <span class="bp">self</span><span class="o">.</span><span class="n">_save_relationships</span><span class="p">()</span>
+<a id="__codelineno-0-635" name="__codelineno-0-635"></a>
+<a id="__codelineno-0-636" name="__codelineno-0-636"></a>        <span class="k">return</span> <span class="n">obj</span>
 </code></pre></div></td></tr></table></div>
         </details>
@@ -5219,7 +6410,9 @@ Then verify that any requested RelationshipAssociations do not violate relations
       <details class="quote">
         <summary>Source code in <code>nautobot/extras/forms/mixins.py</code></summary>
-        <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-482">482</a></span>
+        <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-480">480</a></span>
+<span class="normal"><a href="#__codelineno-0-481">481</a></span>
+<span class="normal"><a href="#__codelineno-0-482">482</a></span>
 <span class="normal"><a href="#__codelineno-0-483">483</a></span>
 <span class="normal"><a href="#__codelineno-0-484">484</a></span>
 <span class="normal"><a href="#__codelineno-0-485">485</a></span>
@@ -5283,75 +6476,73 @@ Then verify that any requested RelationshipAssociations do not violate relations
 <span class="normal"><a href="#__codelineno-0-543">543</a></span>
 <span class="normal"><a href="#__codelineno-0-544">544</a></span>
 <span class="normal"><a href="#__codelineno-0-545">545</a></span>
-<span class="normal"><a href="#__codelineno-0-546">546</a></span>
-<span class="normal"><a href="#__codelineno-0-547">547</a></span>
-<span class="normal"><a href="#__codelineno-0-548">548</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-482" name="__codelineno-0-482"></a><span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
-<a id="__codelineno-0-483" name="__codelineno-0-483"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-484" name="__codelineno-0-484"></a><span class="sd">    First check for any required relationships errors and if there are any, add them via form field errors.</span>
-<a id="__codelineno-0-485" name="__codelineno-0-485"></a><span class="sd">    Then verify that any requested RelationshipAssociations do not violate relationship cardinality restrictions.</span>
-<a id="__codelineno-0-486" name="__codelineno-0-486"></a>
-<a id="__codelineno-0-487" name="__codelineno-0-487"></a><span class="sd">    - For TYPE_ONE_TO_MANY and TYPE_ONE_TO_ONE relations, if the form&#39;s object is on the &quot;source&quot; side of</span>
-<a id="__codelineno-0-488" name="__codelineno-0-488"></a><span class="sd">      the relationship, verify that the requested &quot;destination&quot; object(s) do not already have any existing</span>
-<a id="__codelineno-0-489" name="__codelineno-0-489"></a><span class="sd">      RelationshipAssociation to a different source object.</span>
-<a id="__codelineno-0-490" name="__codelineno-0-490"></a><span class="sd">    - For TYPE_ONE_TO_ONE relations, if the form&#39;s object is on the &quot;destination&quot; side of the relationship,</span>
-<a id="__codelineno-0-491" name="__codelineno-0-491"></a><span class="sd">      verify that the requested &quot;source&quot; object does not have an existing RelationshipAssociation to</span>
-<a id="__codelineno-0-492" name="__codelineno-0-492"></a><span class="sd">      a different destination object.</span>
-<a id="__codelineno-0-493" name="__codelineno-0-493"></a><span class="sd">    &quot;&quot;&quot;</span>
-<a id="__codelineno-0-494" name="__codelineno-0-494"></a>    <span class="n">required_relationships_errors</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">Meta</span><span class="p">()</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">required_related_objects_errors</span><span class="p">(</span>
-<a id="__codelineno-0-495" name="__codelineno-0-495"></a>        <span class="n">output_for</span><span class="o">=</span><span class="s2">&quot;ui&quot;</span><span class="p">,</span> <span class="n">initial_data</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">,</span> <span class="n">instance</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span>
-<a id="__codelineno-0-496" name="__codelineno-0-496"></a>    <span class="p">)</span>
-<a id="__codelineno-0-497" name="__codelineno-0-497"></a>    <span class="k">for</span> <span class="n">field</span><span class="p">,</span> <span class="n">errors</span> <span class="ow">in</span> <span class="n">required_relationships_errors</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-498" name="__codelineno-0-498"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">add_error</span><span class="p">(</span><span class="n">field</span><span class="p">,</span> <span class="n">errors</span><span class="p">)</span>
-<a id="__codelineno-0-499" name="__codelineno-0-499"></a>
-<a id="__codelineno-0-500" name="__codelineno-0-500"></a>    <span class="k">for</span> <span class="n">side</span><span class="p">,</span> <span class="n">relationships</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">get_relationships</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
-<a id="__codelineno-0-501" name="__codelineno-0-501"></a>        <span class="k">for</span> <span class="n">relationship</span> <span class="ow">in</span> <span class="n">relationships</span><span class="p">:</span>
-<a id="__codelineno-0-502" name="__codelineno-0-502"></a>            <span class="c1"># The form field name reflects what it provides, i.e. the peer object(s) to link via this relationship.</span>
-<a id="__codelineno-0-503" name="__codelineno-0-503"></a>            <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
-<a id="__codelineno-0-504" name="__codelineno-0-504"></a>            <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">slug</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
-<a id="__codelineno-0-505" name="__codelineno-0-505"></a>
-<a id="__codelineno-0-506" name="__codelineno-0-506"></a>            <span class="c1"># Is the form trying to set this field (create/update a RelationshipAssociation(s))?</span>
-<a id="__codelineno-0-507" name="__codelineno-0-507"></a>            <span class="c1"># If not (that is, clearing the field / deleting RelationshipAssociation(s)), we don&#39;t need to check.</span>
-<a id="__codelineno-0-508" name="__codelineno-0-508"></a>            <span class="k">if</span> <span class="n">field_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]:</span>
-<a id="__codelineno-0-509" name="__codelineno-0-509"></a>                <span class="k">continue</span>
-<a id="__codelineno-0-510" name="__codelineno-0-510"></a>
-<a id="__codelineno-0-511" name="__codelineno-0-511"></a>            <span class="c1"># Are any of the objects we want a relationship with already entangled with another object?</span>
-<a id="__codelineno-0-512" name="__codelineno-0-512"></a>            <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">peer_side</span><span class="p">):</span>
-<a id="__codelineno-0-513" name="__codelineno-0-513"></a>                <span class="n">target_peers</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">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">])</span>
-<a id="__codelineno-0-514" name="__codelineno-0-514"></a>            <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-515" name="__codelineno-0-515"></a>                <span class="n">target_peers</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]]</span>
-<a id="__codelineno-0-516" name="__codelineno-0-516"></a>
-<a id="__codelineno-0-517" name="__codelineno-0-517"></a>            <span class="k">for</span> <span class="n">target_peer</span> <span class="ow">in</span> <span class="n">target_peers</span><span class="p">:</span>
-<a id="__codelineno-0-518" name="__codelineno-0-518"></a>                <span class="k">if</span> <span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span> <span class="o">==</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">:</span>
-<a id="__codelineno-0-519" name="__codelineno-0-519"></a>                    <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">(</span>
-<a id="__codelineno-0-520" name="__codelineno-0-520"></a>                        <span class="p">{</span><span class="n">field_name</span><span class="p">:</span> <span class="sa">f</span><span class="s2">&quot;Object </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="si">}</span><span class="s2"> cannot form a relationship to itself!&quot;</span><span class="p">}</span>
-<a id="__codelineno-0-521" name="__codelineno-0-521"></a>                    <span class="p">)</span>
-<a id="__codelineno-0-522" name="__codelineno-0-522"></a>
-<a id="__codelineno-0-523" name="__codelineno-0-523"></a>                <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">side</span><span class="p">):</span>
-<a id="__codelineno-0-524" name="__codelineno-0-524"></a>                    <span class="c1"># No need to check for existing RelationshipAssociations since this is a &quot;many&quot; relationship</span>
-<a id="__codelineno-0-525" name="__codelineno-0-525"></a>                    <span class="k">continue</span>
-<a id="__codelineno-0-526" name="__codelineno-0-526"></a>
-<a id="__codelineno-0-527" name="__codelineno-0-527"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">relationship</span><span class="o">.</span><span class="n">symmetric</span><span class="p">:</span>
-<a id="__codelineno-0-528" name="__codelineno-0-528"></a>                    <span class="n">existing_peer_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
-<a id="__codelineno-0-529" name="__codelineno-0-529"></a>                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-530" name="__codelineno-0-530"></a>                        <span class="o">**</span><span class="p">{</span>
-<a id="__codelineno-0-531" name="__codelineno-0-531"></a>                            <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
-<a id="__codelineno-0-532" name="__codelineno-0-532"></a>                        <span class="p">},</span>
-<a id="__codelineno-0-533" name="__codelineno-0-533"></a>                    <span class="p">)</span><span class="o">.</span><span class="n">exclude</span><span class="p">(</span><span class="o">**</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">})</span>
-<a id="__codelineno-0-534" name="__codelineno-0-534"></a>                <span class="k">else</span><span class="p">:</span>
-<a id="__codelineno-0-535" name="__codelineno-0-535"></a>                    <span class="n">existing_peer_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
-<a id="__codelineno-0-536" name="__codelineno-0-536"></a>                        <span class="p">(</span>
-<a id="__codelineno-0-537" name="__codelineno-0-537"></a>                            <span class="p">(</span><span class="n">Q</span><span class="p">(</span><span class="n">source_id</span><span class="o">=</span><span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span> <span class="o">&amp;</span> <span class="o">~</span><span class="n">Q</span><span class="p">(</span><span class="n">destination_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">))</span>
-<a id="__codelineno-0-538" name="__codelineno-0-538"></a>                            <span class="o">|</span> <span class="p">(</span><span class="n">Q</span><span class="p">(</span><span class="n">destination_id</span><span class="o">=</span><span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span> <span class="o">&amp;</span> <span class="o">~</span><span class="n">Q</span><span class="p">(</span><span class="n">source_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">))</span>
-<a id="__codelineno-0-539" name="__codelineno-0-539"></a>                        <span class="p">),</span>
-<a id="__codelineno-0-540" name="__codelineno-0-540"></a>                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
-<a id="__codelineno-0-541" name="__codelineno-0-541"></a>                    <span class="p">)</span>
-<a id="__codelineno-0-542" name="__codelineno-0-542"></a>
-<a id="__codelineno-0-543" name="__codelineno-0-543"></a>                <span class="k">if</span> <span class="n">existing_peer_associations</span><span class="o">.</span><span class="n">exists</span><span class="p">():</span>
-<a id="__codelineno-0-544" name="__codelineno-0-544"></a>                    <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">(</span>
-<a id="__codelineno-0-545" name="__codelineno-0-545"></a>                        <span class="p">{</span><span class="n">field_name</span><span class="p">:</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">target_peer</span><span class="si">}</span><span class="s2"> is already involved in a </span><span class="si">{</span><span class="n">relationship</span><span class="si">}</span><span class="s2"> relationship&quot;</span><span class="p">}</span>
-<a id="__codelineno-0-546" name="__codelineno-0-546"></a>                    <span class="p">)</span>
-<a id="__codelineno-0-547" name="__codelineno-0-547"></a>
-<a id="__codelineno-0-548" name="__codelineno-0-548"></a>    <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">()</span>
+<span class="normal"><a href="#__codelineno-0-546">546</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-480" name="__codelineno-0-480"></a><span class="k">def</span> <span class="nf">clean</span><span class="p">(</span><span class="bp">self</span><span class="p">):</span>
+<a id="__codelineno-0-481" name="__codelineno-0-481"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-482" name="__codelineno-0-482"></a><span class="sd">    First check for any required relationships errors and if there are any, add them via form field errors.</span>
+<a id="__codelineno-0-483" name="__codelineno-0-483"></a><span class="sd">    Then verify that any requested RelationshipAssociations do not violate relationship cardinality restrictions.</span>
+<a id="__codelineno-0-484" name="__codelineno-0-484"></a>
+<a id="__codelineno-0-485" name="__codelineno-0-485"></a><span class="sd">    - For TYPE_ONE_TO_MANY and TYPE_ONE_TO_ONE relations, if the form&#39;s object is on the &quot;source&quot; side of</span>
+<a id="__codelineno-0-486" name="__codelineno-0-486"></a><span class="sd">      the relationship, verify that the requested &quot;destination&quot; object(s) do not already have any existing</span>
+<a id="__codelineno-0-487" name="__codelineno-0-487"></a><span class="sd">      RelationshipAssociation to a different source object.</span>
+<a id="__codelineno-0-488" name="__codelineno-0-488"></a><span class="sd">    - For TYPE_ONE_TO_ONE relations, if the form&#39;s object is on the &quot;destination&quot; side of the relationship,</span>
+<a id="__codelineno-0-489" name="__codelineno-0-489"></a><span class="sd">      verify that the requested &quot;source&quot; object does not have an existing RelationshipAssociation to</span>
+<a id="__codelineno-0-490" name="__codelineno-0-490"></a><span class="sd">      a different destination object.</span>
+<a id="__codelineno-0-491" name="__codelineno-0-491"></a><span class="sd">    &quot;&quot;&quot;</span>
+<a id="__codelineno-0-492" name="__codelineno-0-492"></a>    <span class="n">required_relationships_errors</span> <span class="o">=</span> <span class="bp">self</span><span class="o">.</span><span class="n">Meta</span><span class="p">()</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">required_related_objects_errors</span><span class="p">(</span>
+<a id="__codelineno-0-493" name="__codelineno-0-493"></a>        <span class="n">output_for</span><span class="o">=</span><span class="s2">&quot;ui&quot;</span><span class="p">,</span> <span class="n">initial_data</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">,</span> <span class="n">instance</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span>
+<a id="__codelineno-0-494" name="__codelineno-0-494"></a>    <span class="p">)</span>
+<a id="__codelineno-0-495" name="__codelineno-0-495"></a>    <span class="k">for</span> <span class="n">field</span><span class="p">,</span> <span class="n">errors</span> <span class="ow">in</span> <span class="n">required_relationships_errors</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-496" name="__codelineno-0-496"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">add_error</span><span class="p">(</span><span class="n">field</span><span class="p">,</span> <span class="n">errors</span><span class="p">)</span>
+<a id="__codelineno-0-497" name="__codelineno-0-497"></a>
+<a id="__codelineno-0-498" name="__codelineno-0-498"></a>    <span class="k">for</span> <span class="n">side</span><span class="p">,</span> <span class="n">relationships</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">get_relationships</span><span class="p">()</span><span class="o">.</span><span class="n">items</span><span class="p">():</span>
+<a id="__codelineno-0-499" name="__codelineno-0-499"></a>        <span class="k">for</span> <span class="n">relationship</span> <span class="ow">in</span> <span class="n">relationships</span><span class="p">:</span>
+<a id="__codelineno-0-500" name="__codelineno-0-500"></a>            <span class="c1"># The form field name reflects what it provides, i.e. the peer object(s) to link via this relationship.</span>
+<a id="__codelineno-0-501" name="__codelineno-0-501"></a>            <span class="n">peer_side</span> <span class="o">=</span> <span class="n">RelationshipSideChoices</span><span class="o">.</span><span class="n">OPPOSITE</span><span class="p">[</span><span class="n">side</span><span class="p">]</span>
+<a id="__codelineno-0-502" name="__codelineno-0-502"></a>            <span class="n">field_name</span> <span class="o">=</span> <span class="sa">f</span><span class="s2">&quot;cr_</span><span class="si">{</span><span class="n">relationship</span><span class="o">.</span><span class="n">key</span><span class="si">}</span><span class="s2">__</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">&quot;</span>
+<a id="__codelineno-0-503" name="__codelineno-0-503"></a>
+<a id="__codelineno-0-504" name="__codelineno-0-504"></a>            <span class="c1"># Is the form trying to set this field (create/update a RelationshipAssociation(s))?</span>
+<a id="__codelineno-0-505" name="__codelineno-0-505"></a>            <span class="c1"># If not (that is, clearing the field / deleting RelationshipAssociation(s)), we don&#39;t need to check.</span>
+<a id="__codelineno-0-506" name="__codelineno-0-506"></a>            <span class="k">if</span> <span class="n">field_name</span> <span class="ow">not</span> <span class="ow">in</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span> <span class="ow">or</span> <span class="ow">not</span> <span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]:</span>
+<a id="__codelineno-0-507" name="__codelineno-0-507"></a>                <span class="k">continue</span>
+<a id="__codelineno-0-508" name="__codelineno-0-508"></a>
+<a id="__codelineno-0-509" name="__codelineno-0-509"></a>            <span class="c1"># Are any of the objects we want a relationship with already entangled with another object?</span>
+<a id="__codelineno-0-510" name="__codelineno-0-510"></a>            <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">peer_side</span><span class="p">):</span>
+<a id="__codelineno-0-511" name="__codelineno-0-511"></a>                <span class="n">target_peers</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">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">])</span>
+<a id="__codelineno-0-512" name="__codelineno-0-512"></a>            <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-513" name="__codelineno-0-513"></a>                <span class="n">target_peers</span> <span class="o">=</span> <span class="p">[</span><span class="bp">self</span><span class="o">.</span><span class="n">cleaned_data</span><span class="p">[</span><span class="n">field_name</span><span class="p">]]</span>
+<a id="__codelineno-0-514" name="__codelineno-0-514"></a>
+<a id="__codelineno-0-515" name="__codelineno-0-515"></a>            <span class="k">for</span> <span class="n">target_peer</span> <span class="ow">in</span> <span class="n">target_peers</span><span class="p">:</span>
+<a id="__codelineno-0-516" name="__codelineno-0-516"></a>                <span class="k">if</span> <span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span> <span class="o">==</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">:</span>
+<a id="__codelineno-0-517" name="__codelineno-0-517"></a>                    <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">(</span>
+<a id="__codelineno-0-518" name="__codelineno-0-518"></a>                        <span class="p">{</span><span class="n">field_name</span><span class="p">:</span> <span class="sa">f</span><span class="s2">&quot;Object </span><span class="si">{</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="si">}</span><span class="s2"> cannot form a relationship to itself!&quot;</span><span class="p">}</span>
+<a id="__codelineno-0-519" name="__codelineno-0-519"></a>                    <span class="p">)</span>
+<a id="__codelineno-0-520" name="__codelineno-0-520"></a>
+<a id="__codelineno-0-521" name="__codelineno-0-521"></a>                <span class="k">if</span> <span class="n">relationship</span><span class="o">.</span><span class="n">has_many</span><span class="p">(</span><span class="n">side</span><span class="p">):</span>
+<a id="__codelineno-0-522" name="__codelineno-0-522"></a>                    <span class="c1"># No need to check for existing RelationshipAssociations since this is a &quot;many&quot; relationship</span>
+<a id="__codelineno-0-523" name="__codelineno-0-523"></a>                    <span class="k">continue</span>
+<a id="__codelineno-0-524" name="__codelineno-0-524"></a>
+<a id="__codelineno-0-525" name="__codelineno-0-525"></a>                <span class="k">if</span> <span class="ow">not</span> <span class="n">relationship</span><span class="o">.</span><span class="n">symmetric</span><span class="p">:</span>
+<a id="__codelineno-0-526" name="__codelineno-0-526"></a>                    <span class="n">existing_peer_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-527" name="__codelineno-0-527"></a>                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-528" name="__codelineno-0-528"></a>                        <span class="o">**</span><span class="p">{</span>
+<a id="__codelineno-0-529" name="__codelineno-0-529"></a>                            <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">peer_side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">,</span>
+<a id="__codelineno-0-530" name="__codelineno-0-530"></a>                        <span class="p">},</span>
+<a id="__codelineno-0-531" name="__codelineno-0-531"></a>                    <span class="p">)</span><span class="o">.</span><span class="n">exclude</span><span class="p">(</span><span class="o">**</span><span class="p">{</span><span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">side</span><span class="si">}</span><span class="s2">_id&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">})</span>
+<a id="__codelineno-0-532" name="__codelineno-0-532"></a>                <span class="k">else</span><span class="p">:</span>
+<a id="__codelineno-0-533" name="__codelineno-0-533"></a>                    <span class="n">existing_peer_associations</span> <span class="o">=</span> <span class="n">RelationshipAssociation</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">filter</span><span class="p">(</span>
+<a id="__codelineno-0-534" name="__codelineno-0-534"></a>                        <span class="p">(</span>
+<a id="__codelineno-0-535" name="__codelineno-0-535"></a>                            <span class="p">(</span><span class="n">Q</span><span class="p">(</span><span class="n">source_id</span><span class="o">=</span><span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span> <span class="o">&amp;</span> <span class="o">~</span><span class="n">Q</span><span class="p">(</span><span class="n">destination_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">))</span>
+<a id="__codelineno-0-536" name="__codelineno-0-536"></a>                            <span class="o">|</span> <span class="p">(</span><span class="n">Q</span><span class="p">(</span><span class="n">destination_id</span><span class="o">=</span><span class="n">target_peer</span><span class="o">.</span><span class="n">pk</span><span class="p">)</span> <span class="o">&amp;</span> <span class="o">~</span><span class="n">Q</span><span class="p">(</span><span class="n">source_id</span><span class="o">=</span><span class="bp">self</span><span class="o">.</span><span class="n">instance</span><span class="o">.</span><span class="n">pk</span><span class="p">))</span>
+<a id="__codelineno-0-537" name="__codelineno-0-537"></a>                        <span class="p">),</span>
+<a id="__codelineno-0-538" name="__codelineno-0-538"></a>                        <span class="n">relationship</span><span class="o">=</span><span class="n">relationship</span><span class="p">,</span>
+<a id="__codelineno-0-539" name="__codelineno-0-539"></a>                    <span class="p">)</span>
+<a id="__codelineno-0-540" name="__codelineno-0-540"></a>
+<a id="__codelineno-0-541" name="__codelineno-0-541"></a>                <span class="k">if</span> <span class="n">existing_peer_associations</span><span class="o">.</span><span class="n">exists</span><span class="p">():</span>
+<a id="__codelineno-0-542" name="__codelineno-0-542"></a>                    <span class="k">raise</span> <span class="n">ValidationError</span><span class="p">(</span>
+<a id="__codelineno-0-543" name="__codelineno-0-543"></a>                        <span class="p">{</span><span class="n">field_name</span><span class="p">:</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">target_peer</span><span class="si">}</span><span class="s2"> is already involved in a </span><span class="si">{</span><span class="n">relationship</span><span class="si">}</span><span class="s2"> relationship&quot;</span><span class="p">}</span>
+<a id="__codelineno-0-544" name="__codelineno-0-544"></a>                    <span class="p">)</span>
+<a id="__codelineno-0-545" name="__codelineno-0-545"></a>
+<a id="__codelineno-0-546" name="__codelineno-0-546"></a>    <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="n">clean</span><span class="p">()</span>
 </code></pre></div></td></tr></table></div>
       </details>
   </div>
@@ -5387,86 +6578,27 @@ Then verify that any requested RelationshipAssociations do not violate relations
         <details class="quote">
           <summary>Source code in <code>nautobot/extras/forms/mixins.py</code></summary>
-          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-739">739</a></span>
-<span class="normal"><a href="#__codelineno-0-740">740</a></span>
-<span class="normal"><a href="#__codelineno-0-741">741</a></span>
-<span class="normal"><a href="#__codelineno-0-742">742</a></span>
-<span class="normal"><a href="#__codelineno-0-743">743</a></span>
-<span class="normal"><a href="#__codelineno-0-744">744</a></span>
-<span class="normal"><a href="#__codelineno-0-745">745</a></span>
-<span class="normal"><a href="#__codelineno-0-746">746</a></span>
-<span class="normal"><a href="#__codelineno-0-747">747</a></span>
-<span class="normal"><a href="#__codelineno-0-748">748</a></span>
-<span class="normal"><a href="#__codelineno-0-749">749</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-739" name="__codelineno-0-739"></a><span class="k">class</span> <span class="nc">StatusModelBulkEditFormMixin</span><span class="p">(</span><span class="n">forms</span><span class="o">.</span><span class="n">Form</span><span class="p">):</span>
-<a id="__codelineno-0-740" name="__codelineno-0-740"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Mixin to add non-required `status` choice field to forms.&quot;&quot;&quot;</span>
-<a id="__codelineno-0-741" name="__codelineno-0-741"></a>
-<a id="__codelineno-0-742" name="__codelineno-0-742"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-<a id="__codelineno-0-743" name="__codelineno-0-743"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
-<a id="__codelineno-0-744" name="__codelineno-0-744"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="s2">&quot;status&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">DynamicModelChoiceField</span><span class="p">(</span>
-<a id="__codelineno-0-745" name="__codelineno-0-745"></a>            <span class="n">required</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
-<a id="__codelineno-0-746" name="__codelineno-0-746"></a>            <span class="n">queryset</span><span class="o">=</span><span class="n">Status</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">all</span><span class="p">(),</span>
-<a id="__codelineno-0-747" name="__codelineno-0-747"></a>            <span class="n">query_params</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;content_types&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">_meta</span><span class="o">.</span><span class="n">label_lower</span><span class="p">},</span>
-<a id="__codelineno-0-748" name="__codelineno-0-748"></a>        <span class="p">)</span>
-<a id="__codelineno-0-749" name="__codelineno-0-749"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">order_fields</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">field_order</span><span class="p">)</span>  <span class="c1"># Reorder fields again</span>
-</code></pre></div></td></tr></table></div>
-        </details>
-  <div class="doc doc-children">
-  </div>
-  </div>
-</div>
-<div class="doc doc-object doc-class">
-<h2 id="nautobot.apps.forms.StatusModelCSVFormMixin" class="doc doc-heading">
-        <code>nautobot.apps.forms.StatusModelCSVFormMixin</code>
-<a href="#nautobot.apps.forms.StatusModelCSVFormMixin" class="headerlink" title="Permanent link">&para;</a></h2>
-  <div class="doc doc-contents ">
-      <p class="doc doc-class-bases">
-        Bases: <code><a class="autorefs autorefs-internal" title="nautobot.core.forms.CSVModelForm" href="#nautobot.apps.forms.CSVModelForm">CSVModelForm</a></code></p>
-      <p>Mixin to add a required <code>status</code> choice field to CSV import forms.</p>
-        <details class="quote">
-          <summary>Source code in <code>nautobot/extras/forms/mixins.py</code></summary>
-          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-768">768</a></span>
-<span class="normal"><a href="#__codelineno-0-769">769</a></span>
-<span class="normal"><a href="#__codelineno-0-770">770</a></span>
-<span class="normal"><a href="#__codelineno-0-771">771</a></span>
-<span class="normal"><a href="#__codelineno-0-772">772</a></span>
-<span class="normal"><a href="#__codelineno-0-773">773</a></span>
-<span class="normal"><a href="#__codelineno-0-774">774</a></span>
-<span class="normal"><a href="#__codelineno-0-775">775</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-768" name="__codelineno-0-768"></a><span class="k">class</span> <span class="nc">StatusModelCSVFormMixin</span><span class="p">(</span><span class="n">CSVModelForm</span><span class="p">):</span>
-<a id="__codelineno-0-769" name="__codelineno-0-769"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Mixin to add a required `status` choice field to CSV import forms.&quot;&quot;&quot;</span>
-<a id="__codelineno-0-770" name="__codelineno-0-770"></a>
-<a id="__codelineno-0-771" name="__codelineno-0-771"></a>    <span class="n">status</span> <span class="o">=</span> <span class="n">CSVModelChoiceField</span><span class="p">(</span>
-<a id="__codelineno-0-772" name="__codelineno-0-772"></a>        <span class="n">queryset</span><span class="o">=</span><span class="n">Status</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">all</span><span class="p">(),</span>
-<a id="__codelineno-0-773" name="__codelineno-0-773"></a>        <span class="n">to_field_name</span><span class="o">=</span><span class="s2">&quot;name&quot;</span><span class="p">,</span>
-<a id="__codelineno-0-774" name="__codelineno-0-774"></a>        <span class="n">help_text</span><span class="o">=</span><span class="s2">&quot;Operational status&quot;</span><span class="p">,</span>
-<a id="__codelineno-0-775" name="__codelineno-0-775"></a>    <span class="p">)</span>
+          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-721">721</a></span>
+<span class="normal"><a href="#__codelineno-0-722">722</a></span>
+<span class="normal"><a href="#__codelineno-0-723">723</a></span>
+<span class="normal"><a href="#__codelineno-0-724">724</a></span>
+<span class="normal"><a href="#__codelineno-0-725">725</a></span>
+<span class="normal"><a href="#__codelineno-0-726">726</a></span>
+<span class="normal"><a href="#__codelineno-0-727">727</a></span>
+<span class="normal"><a href="#__codelineno-0-728">728</a></span>
+<span class="normal"><a href="#__codelineno-0-729">729</a></span>
+<span class="normal"><a href="#__codelineno-0-730">730</a></span>
+<span class="normal"><a href="#__codelineno-0-731">731</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-721" name="__codelineno-0-721"></a><span class="k">class</span> <span class="nc">StatusModelBulkEditFormMixin</span><span class="p">(</span><span class="n">forms</span><span class="o">.</span><span class="n">Form</span><span class="p">):</span>
+<a id="__codelineno-0-722" name="__codelineno-0-722"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;Mixin to add non-required `status` choice field to forms.&quot;&quot;&quot;</span>
+<a id="__codelineno-0-723" name="__codelineno-0-723"></a>
+<a id="__codelineno-0-724" name="__codelineno-0-724"></a>    <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">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+<a id="__codelineno-0-725" name="__codelineno-0-725"></a>        <span class="nb">super</span><span class="p">()</span><span class="o">.</span><span class="fm">__init__</span><span class="p">(</span><span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+<a id="__codelineno-0-726" name="__codelineno-0-726"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">fields</span><span class="p">[</span><span class="s2">&quot;status&quot;</span><span class="p">]</span> <span class="o">=</span> <span class="n">DynamicModelChoiceField</span><span class="p">(</span>
+<a id="__codelineno-0-727" name="__codelineno-0-727"></a>            <span class="n">required</span><span class="o">=</span><span class="kc">False</span><span class="p">,</span>
+<a id="__codelineno-0-728" name="__codelineno-0-728"></a>            <span class="n">queryset</span><span class="o">=</span><span class="n">Status</span><span class="o">.</span><span class="n">objects</span><span class="o">.</span><span class="n">all</span><span class="p">(),</span>
+<a id="__codelineno-0-729" name="__codelineno-0-729"></a>            <span class="n">query_params</span><span class="o">=</span><span class="p">{</span><span class="s2">&quot;content_types&quot;</span><span class="p">:</span> <span class="bp">self</span><span class="o">.</span><span class="n">model</span><span class="o">.</span><span class="n">_meta</span><span class="o">.</span><span class="n">label_lower</span><span class="p">},</span>
+<a id="__codelineno-0-730" name="__codelineno-0-730"></a>        <span class="p">)</span>
+<a id="__codelineno-0-731" name="__codelineno-0-731"></a>        <span class="bp">self</span><span class="o">.</span><span class="n">order_fields</span><span class="p">(</span><span class="bp">self</span><span class="o">.</span><span class="n">field_order</span><span class="p">)</span>  <span class="c1"># Reorder fields again</span>
 </code></pre></div></td></tr></table></div>
         </details>
@@ -5512,37 +6644,37 @@ Then verify that any requested RelationshipAssociations do not violate relations
         <details class="quote">
           <summary>Source code in <code>nautobot/core/forms/fields.py</code></summary>
-          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-460">460</a></span>
-<span class="normal"><a href="#__codelineno-0-461">461</a></span>
-<span class="normal"><a href="#__codelineno-0-462">462</a></span>
-<span class="normal"><a href="#__codelineno-0-463">463</a></span>
-<span class="normal"><a href="#__codelineno-0-464">464</a></span>
-<span class="normal"><a href="#__codelineno-0-465">465</a></span>
-<span class="normal"><a href="#__codelineno-0-466">466</a></span>
-<span class="normal"><a href="#__codelineno-0-467">467</a></span>
-<span class="normal"><a href="#__codelineno-0-468">468</a></span>
-<span class="normal"><a href="#__codelineno-0-469">469</a></span>
-<span class="normal"><a href="#__codelineno-0-470">470</a></span>
-<span class="normal"><a href="#__codelineno-0-471">471</a></span>
-<span class="normal"><a href="#__codelineno-0-472">472</a></span>
-<span class="normal"><a href="#__codelineno-0-473">473</a></span>
-<span class="normal"><a href="#__codelineno-0-474">474</a></span>
-<span class="normal"><a href="#__codelineno-0-475">475</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-460" name="__codelineno-0-460"></a><span class="k">class</span> <span class="nc">TagFilterField</span><span class="p">(</span><span class="n">django_forms</span><span class="o">.</span><span class="n">MultipleChoiceField</span><span class="p">):</span>
-<a id="__codelineno-0-461" name="__codelineno-0-461"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-462" name="__codelineno-0-462"></a><span class="sd">    A filter field for the tags of a model. Only the tags used by a model are displayed.</span>
-<a id="__codelineno-0-463" name="__codelineno-0-463"></a>
-<a id="__codelineno-0-464" name="__codelineno-0-464"></a><span class="sd">    :param model: The model of the filter</span>
-<a id="__codelineno-0-465" name="__codelineno-0-465"></a><span class="sd">    &quot;&quot;&quot;</span>
-<a id="__codelineno-0-466" name="__codelineno-0-466"></a>
-<a id="__codelineno-0-467" name="__codelineno-0-467"></a>    <span class="n">widget</span> <span class="o">=</span> <span class="n">widgets</span><span class="o">.</span><span class="n">StaticSelect2Multiple</span>
-<a id="__codelineno-0-468" name="__codelineno-0-468"></a>
-<a id="__codelineno-0-469" name="__codelineno-0-469"></a>    <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">model</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
-<a id="__codelineno-0-470" name="__codelineno-0-470"></a>        <span class="k">def</span> <span class="nf">get_choices</span><span class="p">():</span>
-<a id="__codelineno-0-471" name="__codelineno-0-471"></a>            <span class="n">tags</span> <span class="o">=</span> <span class="n">model</span><span class="o">.</span><span class="n">tags</span><span class="o">.</span><span class="n">annotate</span><span class="p">(</span><span class="n">count</span><span class="o">=</span><span class="n">Count</span><span class="p">(</span><span class="s2">&quot;extras_taggeditem_items&quot;</span><span class="p">))</span><span class="o">.</span><span class="n">order_by</span><span class="p">(</span><span class="s2">&quot;name&quot;</span><span class="p">)</span>
-<a id="__codelineno-0-472" name="__codelineno-0-472"></a>            <span class="k">return</span> <span class="p">[(</span><span class="nb">str</span><span class="p">(</span><span class="n">tag</span><span class="o">.</span><span class="n">slug</span><span class="p">),</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">tag</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2"> (</span><span class="si">{</span><span class="n">tag</span><span class="o">.</span><span class="n">count</span><span class="si">}</span><span class="s2">)&quot;</span><span class="p">)</span> <span class="k">for</span> <span class="n">tag</span> <span class="ow">in</span> <span class="n">tags</span><span class="p">]</span>
-<a id="__codelineno-0-473" name="__codelineno-0-473"></a>
-<a id="__codelineno-0-474" name="__codelineno-0-474"></a>        <span class="c1"># Choices are fetched each time the form is initialized</span>
-<a id="__codelineno-0-475" name="__codelineno-0-475"></a>        <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">label</span><span class="o">=</span><span class="s2">&quot;Tags&quot;</span><span class="p">,</span> <span class="n">choices</span><span class="o">=</span><span class="n">get_choices</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="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
+          <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-434">434</a></span>
+<span class="normal"><a href="#__codelineno-0-435">435</a></span>
+<span class="normal"><a href="#__codelineno-0-436">436</a></span>
+<span class="normal"><a href="#__codelineno-0-437">437</a></span>
+<span class="normal"><a href="#__codelineno-0-438">438</a></span>
+<span class="normal"><a href="#__codelineno-0-439">439</a></span>
+<span class="normal"><a href="#__codelineno-0-440">440</a></span>
+<span class="normal"><a href="#__codelineno-0-441">441</a></span>
+<span class="normal"><a href="#__codelineno-0-442">442</a></span>
+<span class="normal"><a href="#__codelineno-0-443">443</a></span>
+<span class="normal"><a href="#__codelineno-0-444">444</a></span>
+<span class="normal"><a href="#__codelineno-0-445">445</a></span>
+<span class="normal"><a href="#__codelineno-0-446">446</a></span>
+<span class="normal"><a href="#__codelineno-0-447">447</a></span>
+<span class="normal"><a href="#__codelineno-0-448">448</a></span>
+<span class="normal"><a href="#__codelineno-0-449">449</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-434" name="__codelineno-0-434"></a><span class="k">class</span> <span class="nc">TagFilterField</span><span class="p">(</span><span class="n">django_forms</span><span class="o">.</span><span class="n">MultipleChoiceField</span><span class="p">):</span>
+<a id="__codelineno-0-435" name="__codelineno-0-435"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-436" name="__codelineno-0-436"></a><span class="sd">    A filter field for the tags of a model. Only the tags used by a model are displayed.</span>
+<a id="__codelineno-0-437" name="__codelineno-0-437"></a>
+<a id="__codelineno-0-438" name="__codelineno-0-438"></a><span class="sd">    :param model: The model of the filter</span>
+<a id="__codelineno-0-439" name="__codelineno-0-439"></a><span class="sd">    &quot;&quot;&quot;</span>
+<a id="__codelineno-0-440" name="__codelineno-0-440"></a>
+<a id="__codelineno-0-441" name="__codelineno-0-441"></a>    <span class="n">widget</span> <span class="o">=</span> <span class="n">widgets</span><span class="o">.</span><span class="n">StaticSelect2Multiple</span>
+<a id="__codelineno-0-442" name="__codelineno-0-442"></a>
+<a id="__codelineno-0-443" name="__codelineno-0-443"></a>    <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">model</span><span class="p">,</span> <span class="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">):</span>
+<a id="__codelineno-0-444" name="__codelineno-0-444"></a>        <span class="k">def</span> <span class="nf">get_choices</span><span class="p">():</span>
+<a id="__codelineno-0-445" name="__codelineno-0-445"></a>            <span class="n">tags</span> <span class="o">=</span> <span class="n">model</span><span class="o">.</span><span class="n">tags</span><span class="o">.</span><span class="n">annotate</span><span class="p">(</span><span class="n">count</span><span class="o">=</span><span class="n">Count</span><span class="p">(</span><span class="s2">&quot;extras_taggeditem_items&quot;</span><span class="p">))</span><span class="o">.</span><span class="n">order_by</span><span class="p">(</span><span class="s2">&quot;name&quot;</span><span class="p">)</span>
+<a id="__codelineno-0-446" name="__codelineno-0-446"></a>            <span class="k">return</span> <span class="p">[(</span><span class="nb">str</span><span class="p">(</span><span class="n">tag</span><span class="o">.</span><span class="n">slug</span><span class="p">),</span> <span class="sa">f</span><span class="s2">&quot;</span><span class="si">{</span><span class="n">tag</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2"> (</span><span class="si">{</span><span class="n">tag</span><span class="o">.</span><span class="n">count</span><span class="si">}</span><span class="s2">)&quot;</span><span class="p">)</span> <span class="k">for</span> <span class="n">tag</span> <span class="ow">in</span> <span class="n">tags</span><span class="p">]</span>
+<a id="__codelineno-0-447" name="__codelineno-0-447"></a>
+<a id="__codelineno-0-448" name="__codelineno-0-448"></a>        <span class="c1"># Choices are fetched each time the form is initialized</span>
+<a id="__codelineno-0-449" name="__codelineno-0-449"></a>        <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">label</span><span class="o">=</span><span class="s2">&quot;Tags&quot;</span><span class="p">,</span> <span class="n">choices</span><span class="o">=</span><span class="n">get_choices</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="o">*</span><span class="n">args</span><span class="p">,</span> <span class="o">**</span><span class="n">kwargs</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
         </details>
@@ -5644,15 +6776,15 @@ Then verify that any requested RelationshipAssociations do not violate relations
       <details class="quote">
         <summary>Source code in <code>nautobot/core/forms/utils.py</code></summary>
-        <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-112">112</a></span>
+        <div class="highlight"><table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre><span></span><span class="normal"><a href="#__codelineno-0-110">110</a></span>
+<span class="normal"><a href="#__codelineno-0-111">111</a></span>
+<span class="normal"><a href="#__codelineno-0-112">112</a></span>
 <span class="normal"><a href="#__codelineno-0-113">113</a></span>
-<span class="normal"><a href="#__codelineno-0-114">114</a></span>
-<span class="normal"><a href="#__codelineno-0-115">115</a></span>
-<span class="normal"><a href="#__codelineno-0-116">116</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-112" name="__codelineno-0-112"></a><span class="k">def</span> <span class="nf">add_blank_choice</span><span class="p">(</span><span class="n">choices</span><span class="p">):</span>
-<a id="__codelineno-0-113" name="__codelineno-0-113"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
-<a id="__codelineno-0-114" name="__codelineno-0-114"></a><span class="sd">    Add a blank choice to the beginning of a choices list.</span>
-<a id="__codelineno-0-115" name="__codelineno-0-115"></a><span class="sd">    &quot;&quot;&quot;</span>
-<a id="__codelineno-0-116" name="__codelineno-0-116"></a>    <span class="k">return</span> <span class="p">((</span><span class="kc">None</span><span class="p">,</span> <span class="s2">&quot;---------&quot;</span><span class="p">),)</span> <span class="o">+</span> <span class="nb">tuple</span><span class="p">(</span><span class="n">choices</span><span class="p">)</span>
+<span class="normal"><a href="#__codelineno-0-114">114</a></span></pre></div></td><td class="code"><div><pre><span></span><code><a id="__codelineno-0-110" name="__codelineno-0-110"></a><span class="k">def</span> <span class="nf">add_blank_choice</span><span class="p">(</span><span class="n">choices</span><span class="p">):</span>
+<a id="__codelineno-0-111" name="__codelineno-0-111"></a><span class="w">    </span><span class="sd">&quot;&quot;&quot;</span>
+<a id="__codelineno-0-112" name="__codelineno-0-112"></a><span class="sd">    Add a blank choice to the beginning of a choices list.</span>
+<a id="__codelineno-0-113" name="__codelineno-0-113"></a><span class="sd">    &quot;&quot;&quot;</span>
+<a id="__codelineno-0-114" name="__codelineno-0-114"></a>    <span class="k">return</span> <span class="p">((</span><span class="kc">None</span><span class="p">,</span> <span class="s2">&quot;---------&quot;</span><span class="p">),)</span> <span class="o">+</span> <span class="nb">tuple</span><span class="p">(</span><span class="n">choices</span><span class="p">)</span>
 </code></pre></div></td></tr></table></div>
       </details>
   </div>

nautobot 2.0.0a3__py3-none-any.whl → 2.0.0b1__py3-none-any.whl

nautobot 2.0.0a3py3-none-any.whl → 2.0.0b1py3-none-any.whl