add a starter template

.github/workflows/python-package.yml

@@ -41,9 +41,9 @@ jobs:
                   pip install tox-gh-actions>=3.0.0
             - name: Black-Check
               run: |
-                  tox -r -e black-check
+                  tox -e black-check
             - name: Test with tox
               run: |
-                  tox -r
+                  tox
               env:
                   PLATFORM: ${{ matrix.os }}

CHANGES.rst

@@ -101,6 +101,9 @@ New features:
 6.2 (2022-10-28)
 ----------------
 
+- Add a starter subtemplate to initialize a Plone site with some sane default values
+  [erral]
+
 - Improve namespace support #419
   [mamico]
 

bobtemplates/plone/bobregistry.py

@@ -158,3 +158,11 @@ def plone_form():
     reg.plonecli_alias = "form"
     reg.depend_on = "plone_addon"
     return reg
+
+
+def plone_site_initialization():
+    reg = RegEntry()
+    reg.template = "bobtemplates.plone:site_initialization"
+    reg.plonecli_alias = "site_initialization"
+    reg.depend_on = "plone_addon"
+    return reg

bobtemplates/plone/site_initialization.py

@@ -0,0 +1,16 @@
+from bobtemplates.plone.base import base_prepare_renderer
+from bobtemplates.plone.base import git_commit
+from bobtemplates.plone.base import git_support
+
+
+def prepare_renderer(configurator):
+    """Prepare rendering."""
+    configurator = base_prepare_renderer(configurator)
+
+    configurator.target_directory = configurator.variables["package_folder"]
+
+
+def post_renderer(configurator):
+    """Post rendering."""
+    if git_support(configurator):
+        git_commit(configurator, "Add Plone site initialization configuration")

bobtemplates/plone/site_initialization/.mrbob.ini

@@ -0,0 +1,24 @@
+[questions]
+subtemplate_warning.question = Please commit your changes, before using a sub-template! Continue anyway? [N/y]
+subtemplate_warning.required = True
+subtemplate_warning.default = n
+subtemplate_warning.pre_ask_question = bobtemplates.plone.base:git_clean_state_check
+subtemplate_warning.post_ask_question = mrbob.hooks:validate_choices bobtemplates.plone.base:subtemplate_warning_post_question
+subtemplate_warning.choices = y|n
+subtemplate_warning.choices_delimiter = |
+
+language.question = Enter the 2 letter language code for your site
+language.help = Shold be something like 'en'
+language.required = True
+language.default = 'en'
+
+site_name.question = Enter the name of your site
+site_name.help = Should be something like 'My new site'
+site_name.required = True
+site_name.default = New Plone Site
+
+
+[template]
+post_ask = bobtemplates.plone.base:set_global_vars
+pre_render = bobtemplates.plone.site_initialization:prepare_renderer
+post_render = bobtemplates.plone.site_initialization:post_renderer

bobtemplates/plone/site_initialization/profiles/default/registry/plone.base.interfaces.controlpanel.IMailSchema.xml.bob

@@ -0,0 +1,6 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<registry>
+  <records interface="plone.base.interfaces.controlpanel.IMailSchema" prefix="plone" purge="false">
+    <value key="email_from_name">{{{ site_name }}}</value>
+  </records>
+</registry>

bobtemplates/plone/site_initialization/profiles/default/registry/plone.base.interfaces.controlpanel.ISiteSchema.xml.bob

@@ -0,0 +1,6 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<registry>
+  <records interface="plone.base.interfaces.controlpanel.ISiteSchema" prefix="plone" purge="false">
+    <value key="site_title">{{{ site_name }}}</value>
+  </records>
+</registry>

bobtemplates/plone/site_initialization/profiles/default/registry/plone.i18n.interfaces.ILanguageSchema.xml.bob

@@ -0,0 +1,9 @@
+<?xml version='1.0' encoding='UTF-8'?>
+<registry>
+  <records interface="plone.i18n.interfaces.ILanguageSchema" prefix="plone" purge="false">
+    <value key="available_languages">
+      <element>{{{ language }}}</element>
+    </value>
+    <value key="default_language">{{{ language }}}</value>
+  </records>
+</registry>

constraints.txt

@@ -2,8 +2,8 @@
 # -----------------------------------------------
 # Pin Versions / Version Ranges if necessary.
 setuptools==57.0.0
-tox==4.3.5
-isort>=5
+tox>=4.4.0
+isort>=5.12.0
 flake8==5.0.4
 flake8-html==0.4.2
 black==22.8.0

setup.py

@@ -32,6 +32,7 @@
         "Programming Language :: Python :: 3.8",
         "Programming Language :: Python :: 3.9",
         "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
         "Programming Language :: Python :: Implementation :: CPython",
         "Development Status :: 5 - Production/Stable",
         "Framework :: Plone",
@@ -90,6 +91,7 @@
             "plone_vocabulary = bobtemplates.plone.bobregistry:plone_vocabulary",
             "plone_controlpanel = bobtemplates.plone.bobregistry:plone_controlpanel",
             "plone_form = bobtemplates.plone.bobregistry:plone_form",
+            "plone_site_initialization = bobtemplates.plone.bobregistry:plone_site_initialization",
         ]
     },
 )

tox.ini

@@ -1,16 +1,20 @@
 [tox]
+min_version = 4.4.0
+
+
 envlist =
     py38-lint
     py39-lint
     py310-lint
+    py311-lint
     black-check
     docs
-    py{310,39,38}-packagetests
+    py{311,310,39,38}-packagetests
     py{38}-skeletontests-Plone{52}-template-addon
-    py{310,39}-skeletontests-Plone{60}-template-addon
+    py{311,310,39}-skeletontests-Plone{60}-template-addon
     py{38}-skeletontests-Plone{52}-template-addon_all
-    py{310,39}-skeletontests-Plone{60}-template-addon_all
-    py{310,39}-skeletontests-Plone{60}-template-addon_theme_barceoneta
+    py{311,310,39}-skeletontests-Plone{60}-template-addon_all
+    py{311,310,39}-skeletontests-Plone{60}-template-addon_theme_barceoneta
     py{38,39,310}-skeletontests-Plone{60}-template-addon_mockup_pattern
     coverage-report
 
@@ -21,6 +25,7 @@ python =
     3.8: py38
     3.9: py39
     3.10: py310
+    3.11: py311
 
 [testenv]
 usedevelop = True
@@ -31,6 +36,7 @@ basepython:
     py38: python3.8
     py39: python3.9
     py310: python3.10
+    py311: python3.11
 
 commands =
     mkdir -p {toxinidir}/_build/reports/coverage {toxinidir}/_build/reports/pytest
@@ -63,8 +69,8 @@ allowlist_externals =
     mkdir
 
 depends =
-    {py310}: coverage-clean
-    coverage-report: py310
+    {py311}: coverage-clean
+    coverage-report: py311
 
 
 [testenv:coverage-report]
@@ -167,25 +173,32 @@ deps = {[lint]deps}
 commands = {[lint]commands}
 allowlist_externals = {[lint]allowlist_externals}
 
+[testenv:py311-lint]
+basepython = python3.11
+skip_install = true
+deps = {[lint]deps}
+commands = {[lint]commands}
+allowlist_externals = {[lint]allowlist_externals}
+
 [testenv:black-check]
-basepython = python3.10
+; basepython = python3.11
 skip_install = True
 deps =
     -cconstraints.txt
     black
 
 commands =
-    black --check --diff -v bobtemplates setup.py skeleton-tests package_tests
+    black -t py311 --check --diff -v bobtemplates setup.py skeleton-tests package_tests
 
 [testenv:black-enforce]
-basepython = python3.10
+basepython = python3.11
 skip_install = True
 deps =
     -cconstraints.txt
     black
 
 commands =
-    black -v bobtemplates setup.py skeleton-tests package_tests
+    black -t py311 -v bobtemplates setup.py skeleton-tests package_tests
 
 [testenv:docs]
 basepython = python3.10