diff -r 98a84761634f -r 7e69ecc9fd43 src/source/dev_guide/howto-rename.rst --- a/src/source/dev_guide/howto-rename.rst Fri Dec 14 12:16:12 2018 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,67 +0,0 @@ -.. _renamehowto: - - -How to rename classes of existing objects ? -=========================================== - - -PyAMS provides `zodbupdate` script to update easily update the change in ZODB. Because, when you develop new features -to PyAMS we sometimes have to rename or modify classes of already stored objects and if you do that you will never access -yours objects - - -**1) Include you package in the require resource for you webapp** - - -.. code-block:: python - - requires = [ - 'mypackage', - ... - ] - -**2) Add the Entry points** - - -In the `setup.py` file add 'zodbupdate' params into entry_points where is store zodbupdate directives - -.. code-block:: python - - entry_points={ - 'zodbupdate': [ - 'renames = mypackage.generations:RENAMED_CLASSES' - ] - } - - - -**3) Create a module named** ``generation`` **with the migration directives** - - -.. code-block:: python - - RENAMED_CLASSES = { - 'mypackage.mymodule MyOldClass': 'mypackage.mymodule MyNewClass' - } - - -**4) Run the commands** ``buildout`` . - -.. code-block:: console - - $ mypackage/bin/buildout - $ webapp/bin/buildout - - -The ``buildout`` command going to install correctly the package and add the new entry_points references in entry_points.txt - -**5) Run the commands** ``zodbupdate`` - -To finish run `zodbupdate` to apply the changes describe in `RENAMED_CLASSES` - -.. code-block:: console - - $ bin/zodbupdate --config etc/zodbupdate-zeo.conf - - -Where `zodbupdate-zeo.conf` is the configuration file to access to the ZODB.