Add the ability to create an arbitrary schema for rendering elsewhere

ckanext/scheming/arbitrary_schema_example.yaml

@@ -0,0 +1,27 @@
+scheming_version: 2
+schema_id: ckanext_notifier
+about: An example of a config schema for a fictional extension
+
+fields:
+  - field_name: ckanext.ckanext_notifier.enable_notifications
+    label: Enable notifications
+    validators: default(true) boolean_validator
+    preset: select
+    required: true
+    choices:
+      - value: true
+        label: Enable
+      - value: false
+        label: Disable
+
+  - field_name: ckanext.ckanext_notifier.notify_to_email
+    label: Notification email
+    validators: unicode_safe email_validator
+    required: true
+    help_text: Specify the email address to which the notification will be sent
+
+  - field_name: ckanext.ckanext_notifier.frequency
+    label: Notification frequency in seconds
+    validators: default(3600) int_validator
+    required: true
+    input_type: number

ckanext/scheming/helpers.py

@@ -445,3 +445,28 @@ def scheming_flatten_subfield(subfield, data):
         for k in record:
             flat[prefix + k] = record[k]
     return flat
+
+
+@helper
+def scheming_arbitrary_schemas(expanded=True):
+    """
+    Return the dict of arbitrary schemas. Or if scheming_arbitrary
+    plugin is not loaded return None.
+    """
+    from ckanext.scheming.plugins import SchemingArbitraryPlugin as plugin
+
+    if plugin.instance:
+        if expanded:
+            return plugin.instance._expanded_schemas
+        return plugin.instance._schemas
+
+    return {}
+
+
+@helper
+def scheming_get_arbitrary_schema(schema_id, expanded=True):
+    """
+    Return the schema for the schema_id passed or None if
+    no schema is defined for that schema_id.
+    """
+    return scheming_arbitrary_schemas(expanded).get(schema_id)

ckanext/scheming/plugins.py

@@ -473,6 +473,17 @@ def get_actions(self):
                 logic.scheming_organization_schema_show,
         }
 
+class SchemingArbitraryPlugin(p.SingletonPlugin, _SchemingMixin):
+    p.implements(p.IConfigurer)
+
+    SCHEMA_OPTION = "scheming.arbitrary_schemas"
+    FALLBACK_OPTION = 'scheming.arbitrary_fallback'
+    SCHEMA_TYPE_FIELD = "schema_id"
+
+    @classmethod
+    def _store_instance(cls, self):
+        SchemingArbitraryPlugin.instance = self
+
 
 class SchemingNerfIndexPlugin(p.SingletonPlugin):
     """

ckanext/scheming/templates/scheming/group/group_form.html

@@ -12,13 +12,7 @@
 <form class="dataset-form form-horizontal" method="post" data-module="basic-form" enctype="multipart/form-data">
     {{ h.csrf_input() if 'csrf_input' in h }}
     {%- set schema = h.scheming_get_group_schema(group_type) -%}
-    {%- for field in schema['fields'] -%}
-        {%- if field.form_snippet is not none -%}
-          {%- snippet 'scheming/snippets/form_field.html',
-          field=field, data=data, errors=errors, licenses=licenses,
-          entity_type='group', object_type=group_type -%}
-        {%- endif -%}
-    {%- endfor -%}
+    {% snippet 'scheming/snippets/render_fields.html', fields=schema.fields, data=data, errors=errors, entity_type='group', object_type=group_type %}
 
     <div class="form-actions">
         {% block delete_button %}

ckanext/scheming/templates/scheming/organization/group_form.html

@@ -14,13 +14,7 @@
 <form class="dataset-form form-horizontal" method="post" data-module="basic-form" enctype="multipart/form-data">
     {{ h.csrf_input() if 'csrf_input' in h }}
     {%- set schema = h.scheming_get_organization_schema(group_type) -%}
-    {%- for field in schema['fields'] -%}
-        {%- if field.form_snippet is not none -%}
-          {%- snippet 'scheming/snippets/form_field.html',
-          field=field, data=data, errors=errors, licenses=licenses,
-          entity_type='organization', object_type=group_type -%}
-        {%- endif -%}
-    {%- endfor -%}
+    {% snippet 'scheming/snippets/render_fields.html', fields=schema.fields, data=data, errors=errors, entity_type='organization', object_type=group_type %}
 
     {{ form.required_message() }}
 

ckanext/scheming/templates/scheming/package/snippets/package_form.html

@@ -68,30 +68,8 @@
   {%- else -%}
     {%- set fields = schema.dataset_fields -%}
   {%- endif -%}
-  {%- for field in fields -%}
-    {%- if field.form_snippet is not none -%}
-      {%- if field.field_name not in data %}
-        {# Set the field default value before rendering but only if
-        it doesn't already exist in data which would mean the form
-        has been submitted. #}
-        {% if field.default_jinja2 %}
-          {% do data.__setitem__(
-            field.field_name,
-            h.scheming_render_from_string(field.default_jinja2)) %}
-        {% elif field.default %}
-          {% do data.__setitem__(field.field_name, field.default) %}
-        {% endif %}
-      {% endif -%}
-      {%- snippet 'scheming/snippets/form_field.html',
-        field=field,
-        data=data,
-        errors=errors,
-        licenses=c.licenses,
-        entity_type='dataset',
-        object_type=dataset_type
-      -%}
-    {%- endif -%}
-  {%- endfor -%}
+
+  {% snippet 'scheming/snippets/render_fields.html', fields=schema.dataset_fields, data=data, errors=errors, entity_type='dataset', object_type=dataset_type, set_fields_defaults=true %}
 
   {%- if pages -%}
     <input type="hidden" name="_ckan_phase" value="{{ active_page }}" />

ckanext/scheming/templates/scheming/package/snippets/resource_form.html

@@ -47,34 +47,7 @@
   {%- endif -%}
 
   {%- set schema = h.scheming_get_dataset_schema(dataset_type) -%}
-  {%- for field in schema.resource_fields -%}
-    {%- if field.form_snippet is not none -%}
-      {%- if field.field_name not in data %}
-        {# Set the field default value before rendering but only if
-        it doesn't already exist in data which would mean the form
-        has been submitted. #}
-        {% if field.default_jinja2 %}
-          {% do data.__setitem__(
-            field.field_name,
-            h.scheming_render_from_string(field.default_jinja2)) %}
-        {% elif field.default %}
-          {% do data.__setitem__(field.field_name, field.default) %}
-        {% endif %}
-      {% endif -%}
-      {# We pass pkg_name as the package_id because that's the only
-      variable available in this snippet #}
-      {%- snippet 'scheming/snippets/form_field.html',
-        field=field,
-        data=data,
-        errors=errors,
-        licenses=c.licenses,
-        entity_type='dataset',
-        object_type=dataset_type,
-        package_id=pkg_name
-      -%}
-    {%- endif -%}
-  {%- endfor -%}
-
+  {% snippet 'scheming/snippets/render_fields.html', fields=schema.resource_fields, data=data, errors=errors, entity_type='dataset', object_type=dataset_type, set_fields_defaults=true %}
 {% endblock %}
 
 

ckanext/scheming/templates/scheming/snippets/render_fields.html

@@ -0,0 +1,30 @@
+{#}
+    fields - a list of scheming field dictionaries
+    data - form data fields
+    errors - A dict of errors for the fields
+    entity_type - entity type
+    object_type - object type
+    set_fields_defaults - flag to set the default field values
+{#}
+
+{% for field in fields if field.form_snippet is not none %}
+    {% if field.field_name not in data and set_fields_defaults %}
+        {# Set the field default value before rendering but only if
+        it doesn't already exist in data which would mean the form
+        has been submitted. #}
+        {% if field.default_jinja2 %}
+            {% do data.__setitem__(field.field_name, h.scheming_render_from_string(field.default_jinja2)) %}
+        {% elif field.default %}
+            {% do data.__setitem__(field.field_name, field.default) %}
+        {% endif %}
+    {% endif %}
+
+    {% snippet 'scheming/snippets/form_field.html',
+        field=field,
+        data=data,
+        errors=errors,
+        licenses=licenses,
+        entity_type=entity_type,
+        object_type=object_type
+    %}
+{% endfor %}

ckanext/scheming/tests/test_arbitrary_schema.py

@@ -0,0 +1,30 @@
+import pytest
+from flask import render_template
+from bs4 import BeautifulSoup
+
+from ckanext.scheming.helpers import scheming_get_arbitrary_schema
+
+
+class TestArbitrarySchema:
+    def test_arbitrary_schema_structure(self):
+        schema = scheming_get_arbitrary_schema("ckanext_notifier")
+
+        assert schema["scheming_version"]
+        assert schema["schema_id"] == "ckanext_notifier"
+        assert schema["about"]
+        assert isinstance(schema["fields"], list)
+
+    @pytest.mark.usefixtures("with_request_context")
+    def test_render_arbitrary_schema(self, app):
+        schema = scheming_get_arbitrary_schema("ckanext_notifier")
+
+        result = render_template(
+            "scheming/snippets/render_fields.html",
+            fields=schema["fields"],
+            data={},
+            errors={},
+        )
+
+        soup = BeautifulSoup(result)
+
+        assert len(soup.select("div.form-group")) == 3