Metadata-Version: 1.0

Name: infrae.subversion

Version: 1.4.5

Summary: Buildout recipe for checking out from subversion

Home-page: https://svn.infrae.com/buildout/infrae.subversion/trunk/

Author: Eric Casteleijn, Guido Wesdorp, Daniel Nouri, Sylvain Viollon and Reinout van Rees

Author-email: info@infrae.com

License: ZPL 2.1

Description: infrae.subversion

        =================

        This zc.buildout recipe will check out a *number* of URLs into its

        parts directory.  It won't remove its parts directory if there are any

        changes in the checkout, so it's safe to work with that checkout for

        development.

        This is an example buildout part that uses this recipe::

            [development-products]

            recipe = infrae.subversion

            urls =

                https://svn.plone.org/svn/collective/PDBDebugMode/trunk PDBDebugMode

        This will maintain a working copy of ``PDBDebugMode`` in the

        ``parts/development-products/PDBDebugMode`` directory (*not* in the

        parts directory itself).  Thus, the recipe handles multiple URLs fine.

        You can select a different location with ``location``, for instance::

           location = src

        Will extract ``PDBDebugMode`` in ``src/PDBDebugMode`` instead of

        ``parts``.

        If you have ``pysvn`` installed on the computer, it will be used. This

        implies better performances.

        Update

        ------

        By default, when buildout update the part, an ``svn up`` is done for

        each link. However, when a revision number is specified like this::

           https://svn.infrae.com/buildout/infrae.subversion/trunk@27829

        The SVN link is skipped for update. If you want to prevent update for

        all SVN link of the part even if they do not contain revision number,

        you can add the following option::

           ignore_updates = true

        Export

        ------

        With ``pysvn`` installed, you can specify::

           export = true

        in your buildout part to get an SVN export instead of an SVN checkout.

        Verification

        ------------

        By default, your checkout are checked against local modification

        before any uninstallation step. This can take time on large checkouts,

        and you may don't want it in some case (like when used on buildbot for

        instance). To prevent this step, you can use this option::

          ignore_verification = true

        As well, when the recipe update it can emit some warnings because a

        directory have been removed. You can suppress that warning with::

          no_warnings = true

        The verification will still be done, and the directory will be checked

        out again to replace the missing one.

        Eggs

        ----

        If you set the option ``as_eggs`` in your configuration file,

        checkouted URLs will be registered as development eggs in your

        buildout. This only work for non-recipe development eggs.

        .. warning:: If you add a new egg, this will trigger a new

          uninstall-reinstall cycle. You may want to use that option to setup

          eggs coming from SVN for production, but not for development.

        Exported Variables

        ------------------

        If you set::

          export_info = true

        Two variables will be exported by this recipe:

        - ``revisions`` which gives for each URL the corresponding revision

          number,

        - ``updated`` which gives a list of URLs which have been updated with

          new code.

        Since values to these variables changes each time you run buildout

        (revision number changes), this trigger an uninstall/reinstall of the

        part. We recommand to activate it only if you need it.

        Is always exported a variable ``location`` to say where are done the

        checkouts, and a variable ``eggs`` which contains a list of

        checkouted eggs.

        Sample

        ------

        For an example buildout that uses this recipe, please see the `Silva

        buildout <https://svn.infrae.com/buildout/silva/trunk>`_.

        As well, the `doctest file

        <https://svn.infrae.com/buildout/infrae.subversion/trunk/infrae/subversion/tests/IMPL.txt>`_

        can provide more sample.

        Latest version

        --------------

        The latest version is available in a `Subversion repository

        <https://svn.infrae.com/buildout/infrae.subversion/trunk#egg=infrae.subversion-dev>`_.

        Changes

        -------

        1.4.5 (2009-01-29)

        ~~~~~~~~~~~~~~~~~~

        - Fix an error when some path have been added to the checkout

          path. [eric]

        - Still eggify and export information on update when running as

          non-newest mode. [sylvain]

        1.4.4 (2009-01-28)

        ~~~~~~~~~~~~~~~~~~

        - Add a ``no_warnings`` options which remove some warnings when

          updating a part. [sylvain]

        1.4.3 (2009-01-21)

        ~~~~~~~~~~~~~~~~~~

        - Add a login callback for people using PySVN. This let users

          authenticate to an unauthorized svn. Thanks to Martin Stadler

          (martin at siarp.de) for this fix. [sylvain]

        1.4.2 (2009-01-05)

        ~~~~~~~~~~~~~~~~~~

        - Automatically ignore ``.pyc`` and ``.pyo`` files while checking for

          modified/added/removed files. [sylvain]

        - Fix bug so ``.svn`` directory is really ignored when checking for

          added paths in the checkout directory. [sylvain]

        1.4.1 (2008-10-31)

        ~~~~~~~~~~~~~~~~~~

        Bug fix:

        - Correct typo in README.txt. [sylvain]

        - Ignore ``.svn`` directory when checking for added ones at

          uninstall. [sylvain]

        1.4 (2008-10-31)

        ~~~~~~~~~~~~~~~~

        New features:

        - Added ``location`` option that allows you to override the default

          /parts/partname location. [reinout]

        - Added ``as_eggs`` option that installs the checkouts as development

          eggs. [reinout]

        Bug fix:

        - Don't export revisions information if you're offline with Py. Py

          tries to connect to the SVN repository to do a 'svn info'. [sylvain]

        1.3.1

        ~~~~~

        Bug fix:

        - don't try to collect export information if you have a svn

          export. [sylvain]

        - path were exported instead of URLs in the Native

          implementation. [sylvain]

        1.3

        ~~~

        - Remove the restriction to py 0.9.0, now that py 0.9.2 is out and fix

          problems on svn status with strange userid. [sylvain]

        - Correct an error rendering. [sylvain]

        - Export information only for top level svn URLs in the native

          implementation, this used to inject information from svn:externals

          links included in URL list. [sylvain]

        - Add tests for export information feature. [tlotze]

        - Correct URL in setup.py [sylvain].

        1.2

        ~~~

        - Refactor code, performances should be better at uninstall with Py

          implementation [sylvain].

        - Look for the environment variable ``INFRAE_SUBVERSION_IMPL`` to

          select which implementation to use. Possible values are ``PYSVN``

          (default) and ``PY`` [sylvain].

        - Uninstall only look at directory which have been created by the

          recipe in the part. Other are just reported [sylvain].

        - Export two new variables, if ``export_info`` is set to true:

          ``revisions``

             Which is lines formatted::

                link current_revision

          ``updated``

             Which is lines containing updated links.

          [sylvain].

        1.1

        ~~~

        - Add the ``ignore_verification`` option [sylvain].

        1.0

        ~~~

        - Base version of the recipe.

Keywords: subversion buildout

Platform: UNKNOWN

Classifier: Framework :: Buildout

Classifier: License :: OSI Approved :: Zope Public License

Classifier: Topic :: Software Development :: Version Control