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)]]