Package: bobtemplates.migration
bobtemplates.migrationprovidesmr.bobtemplates to generate migration-related packages for Plone projects.FeaturesPackages created withbobtemplates.migrationuse the current best-practices when creating an add-on. It also supports GIT by default, to keep track of changes one is doing with the package.Provided templatesCurrently, only ajsonifytemplate is available.
This will create a Transmogrifier migration that will work with acollective.jsonifyexport out of the box.Pull requests are welcome if you would like a template that will work with other file types.
Examples would be CSV or a Wordpress export.CompatibilityAdd-ons created withbobtemplates.migrationare tested to work in Plone 5.1 and 5.2.
They should also work with older versions but that was not tested (if you are using this to
migrate to a new Plone site, you should be using the latest version of Plone and Python 3).
It should work on Linux, Mac and Windows.In the buildout this template creates, there are configs for both Plone 5.1 and 5.2.
By default, buildout.cfg points to plone52.cfg.
For use with Python 3 (recommended), you may also need to uncomment the [sources] section
to checkout the unreleased Python 3 fixes for the Transmogrifier add-ons.DocumentationTo get started with Transmogrifier, visit the training athttps://training.plone.org/5/transmogrifierFor easy usage of mr.bob see:plonecliInstallationYou can install bobtemplates.migration as every other normal Python package withpipinside avirtualenvor better withpipenv.Installion with pipenvpipenv install bobtemplates.migrationInstallation with pip in a virtualenvYou can also installbobtemplates.migrationwith pip in a virtualenv.
If you don’t have an active virtualenv, you can create one inside your project directory.virtualenv.Then either activate the virtualenv:source./bin/activateor just use the binaries directly inside the bin folder as below:./bin/pip install bobtemplates.migrationUse in a buildout[buildout]parts +=mrbob[mrbob]recipe=zc.recipe.eggeggs=mr.bobbobtemplates.migrationThis creates a mrbob-executable in your bin-directory.UsageAs bobtemplates.migration is a template formr.bob, we use mrbob to run the templates.If you are usingbuildoutor an unactivatedvirtualenv, you can use mrbob like this:./bin/mrbob bobtemplates.migration:jsonify -O src/collective.fooIf you are using pipenv or an activated virtualenv, you can use mrbob like this:Activate pipenv shell:pipenv shellor activate your virtualenv:source bin/activatemrbob bobtemplates.migration:jsonify -O src/collective.fooThis will create your Plone package inside thesrcdirectory.See the documentation ofmr.bobfor further information.ConfigurationYou can set allmr.bob configurationparameters in your ~/.mrbob file.Here is an example:[mr.bob]verbose=False[variables]author.name=MaikDerstappenauthor.email=md@derico.deauthor.github.user=MrTangoplone.version=5.1.4#package.git.init = y
#package.git.autocommit = n
#package.git.disabled = nContributeIssue Tracker:https://github.com/collective/bobtemplates.migration/issuesSource Code:https://github.com/collective/bobtemplates.migrationDocumentation:https://training.plone.org/5/transmogrifierContributorsThis package was copied from bits ofbobtemplates.ploneChrissy Wainwright [cdw9]Maik Derstappen [MrTango]Alexander Loechel [loechel]Changelog0.3 (2019-08-16)Finalize Python 3 compatibility
[cdw9]0.2 (2019-08-07)Plone 5.2 / Python 3 compatibility
[cdw9]0.1 (2018-11-21)Initial package creation
[cdw9]