Changes between Version 3 and Version 4 of PerforcePlugin


Ignore:
Timestamp:
Nov 18, 2005, 10:58:29 PM (9 years ago)
Author:
ttressieres
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • PerforcePlugin

    v3 v4  
    1 = Perforce Plugin for Trac =
     1= '''Perforce Plugin for Trac''' =
    22
    33''(See Trac ticket [trac-ticket:257 #257] for more information)''
    44
    55This is an '''experimental''' plugin for Trac [milestone:0.9] which enables [http://www.perforce.com Perforce]
    6 to be used instead of [http://subversion.tigris.org Subversion] for the [http://projects.edgewall.com/trac/wiki/VersioningSystemBackend VersioningSystemBackend].
     6to be used instead of [http://subversion.tigris.org Subversion] for the
     7[http://projects.edgewall.com/trac/wiki/VersioningSystemBackend VersioningSystemBackend].
    78
    89It is based on work from [http://projects.edgewall.com/trac/wiki/ChristianBoos ChristianBoos] on [http://projects.edgewall.com/trac/wiki/TracMercurial TracMercurial plugin] and from [http://www.jparks.net/blog JasonParks].
     
    1112
    1213
     14
    1315== Download and Installation ==
    1416
     17==== Sources ====
     18
     19the sources are [browser:perforceplugin/0.9 here], get them with subversion.
     20To build the egg, you must do this on Windows platform:
     21{{{
     22d:\dev\Python23\python.exe setup.py bdist_egg
     23}}}
     24
     25
    1526==== Trac ====
     27
     28
    1629The plugin needs a slightly modified version of Trac 0.9, which offers support for pluggable SCM backends.
    1730This version can be found in [http://projects.edgewall.com/trac/browser/sandbox/vc-refactoring vc-refactoring].
    1831
    1932
    20 The plugin itself will be available soon...
    2133
    2234==== Perforce ====
    2335
    24 The plugin has been tested with Perforce 2005.1 from http://www.perforce.com).
    2536
    26 You can try Perforce from [http://www.perforce.com/perforce/loadprog.html Perforce::Download].
     37The plugin has been tested with Perforce 2005.1 and 2005.2.Beta from http://www.perforce.com.
     38
     39You can try Perforce from [http://www.perforce.com/perforce/loadprog.html Perforce/Download].
    2740
    2841
    2942== Configuration ==
     43
    3044
    3145The configuration has to be done on the Trac side, there's nothing to do on the Perforce repository side,
     
    3448
    3549=== Setting up a Trac environment ===
     50
    3651
    3752You can either reuse an existing Trac environment, or create a brand new one.
     
    6378
    6479
     80
    6581to specify Perforce user and password you must add a [p4] section in trac.ini
    6682{{{
     
    7389}}}
    7490
     91Note: The best Perforce configuration is to add a user with read access and a login with no expiry, then you set your Trac configuration with this user.
     92
     93
    7594=== Setting up the perforce plugin ===
     95
    7696
    7797The TracPerforce-0.1 plugin egg should be added to the `plugins` folder of the environment.
     
    82102== Features ==
    83103
     104
    84105The Perforce support is pretty basic, but works well. I've tested that on the Perforce repository itself and the performance is quite good, even if there's currently ''no'' caching in the database (I'm still not decided if that's a feature or a bug).
    85106
     
    89110== Bugs and Limitations ==
    90111
     112
    91113There are still a lot of things that can be improved.
    92114
     
    94116=== Features that Trac+svn has but not currently implemented for Trac+p4 ===
    95117
    96 to be written
     118
     119 * The database is not used
     120 * move of files and directories are not taken into account
     121 * history is not updated
     122   * if you want to see a change before the 'max_changes' number specified in trac.ini, an error occured !!
    97123
    98124
    99125==== ''Add your cool feature here...'' ====
     126
    100127
    101128----
     
    103130== Implementation Notes ==
    104131
     132
    105133I'm interested in feedback concerning the code, in particular:
    106134 * concerning Perforce, I'm pretty sure I did things in a sub-optimal
    107135   way, as I was discovering the guts of p4 and Python while writing the plugin.
     136
    108137   Therefore, I'll be pleased to get tips for improvements.
    109138
    110 '' -- ThomasTressieres [wiki:ttressieres] ''
     139'' -- [wiki:ttressieres Thomas Tressieres] ''
    111140
    112141[[TagIt(0.9,plugin,ttressieres)]]