r2 - 12 Jun 2006 - 20:28:10 - MikeTYou are here: OSAF >  Projects Web  > KagamiProject

Kagami Project

Overview

Kagami is a toolset to allow any CVS repository to have an SVN mirror.

Goals

  • Given the following items end up with an SVN repository that matches exactly in content and history a CVS repository
    • CVS Repository
    • SVN Repository
    • Access either to the CVSROOT/loginfo or be able to run cvs log requests as needed

Documentation

Notes on processing CVS data

Overview

Kagami takes information extracted from CVS commit data and builds a SVN commit such that the SVN commit has all of the adds, changes and deletes that the CVS commit had but as a single SVN commit with log information.

This is done by two different programs in Kagami: logcvs.py and kagami.py

logcvs.py

logcvs is your "classic" CVS trigger script and is responsible for parsing the normal CVS loginfo data and also calling rlog to extract other key information so that multiple CVS commits can be treated as a single transaction.

logcvs can be run in one of three modes: full, loginfo ony and rlog only

logcvs in full mode (the default) runs the loginfo step and the rlog step all in a single pass. Because calling rlog can be a time consuming event (especially since rlog called for each file individually), the loginfo and rlog steps can be run in different passes.

When the loginfo step is run in different passes, an .loginfo intermediate file is created in the path passed in via -p.

The rlog step reads the -p specified directory for any .loginfo files, processes then and generates a .mirror file for each file found.

kagami.py

TBD

"Kagami" ... WTF?

Kagami is the Japanese word for "mirror". I picked it to follow in the very cool footsteps of Zanshin.

Source Code and License

Kagami source is available under the Apache v2.0 License in OSAF's subversion repository: http://svn.osafoundation.org/kagami/trunk

Related Projects

  1. Mozilla's Bonsai webtool -- it extracts history information to populate a database for query.
  2. http://svk.elixus.org/?MirrorVCP

-- MikeT - 07 Jun 2006

Edit | WYSIWYG | Attach | Printable | Raw View | Backlinks: Web, All Webs | History: r2 < r1 | More topic actions
 
Open Source Applications Foundation
Except where otherwise noted, this site and its content are licensed by OSAF under an Creative Commons License, Attribution Only 3.0.
See list of page contributors for attributions.