Skip to main content

Templates for Plone projects.

Project description

bobtemplates.migration provides mr.bob templates to generate migration-related packages for Plone projects.

Features

Packages created with bobtemplates.migration use 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 templates

Currently, only a jsonify template is available. This will create a Transmogrifier migration that will work with a collective.jsonify export 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.

Compatibility

Add-ons created with bobtemplates.migration are tested to work in Plone 5. They should also work with older versions but that was not tested. It should work on Linux, Mac and Windows.

Documentation

To get started with Transmogrifier, visit the training at https://training.plone.org/5/transmogrifier

For easy usage of mr.bob see: plonecli

Installation

You can install bobtemplates.migration as every other normal Python package with pip inside a virtualenv or better with pipenv.

Installion with pipenv

pipenv install bobtemplates.migration

Installation with pip in a virtualenv

You can also install bobtemplates.migration with 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/activate

or just use the binaries directly inside the bin folder as below:

./bin/pip install bobtemplates.migration

Use in a buildout

[buildout]
parts += mrbob

[mrbob]
recipe = zc.recipe.egg
eggs =
    mr.bob
    bobtemplates.migration

This creates a mrbob-executable in your bin-directory.

Usage

As bobtemplates.migration is a template for mr.bob, we use mrbob to run the templates.

If you are using buildout or an unactivated virtualenv, you can use mrbob like this:

./bin/mrbob -O bobtemplates.migration:jsonify -O src/collective.foo

If you are using pipenv or an activated virtualenv, you can use mrbob like this:

Activate pipenv shell:

pipenv shell

or activate your virtualenv:

source bin/activate
mrbob -O bobtemplates.migration:jsonify -O src/collective.foo

This will create your Plone package inside the src directory.

See the documentation of mr.bob for further information.

Configuration

You can set all mr.bob configuration parameters in your ~/.mrbob file.

Here is an example:

[mr.bob]
verbose = False

[variables]
author.name = Maik Derstappen
author.email = md@derico.de
author.github.user = MrTango
plone.version = 5.1.4
#package.git.init = y
#package.git.autocommit = n
#package.git.disabled = n

Contribute

Contributors

This package was copied from bits of bobtemplates.plone

  • Chrissy Wainwright [cdw9]

  • Maik Derstappen [MrTango]

  • Alexander Loechel [loechel]

Changelog

0.1 (2018-11-21)

  • Initial package creation [cdw9]

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bobtemplates.migration-0.1.zip (27.1 MB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page