Warning: Can't synchronize with the repository (The 'repository_dir' has changed, a 'trac-admin resync' operation is needed.). Look in the Trac log for more information.
Description

Enable Cross Platform Publishing of Pudge Documentation (#8)

the currently provided automations do not work cross-platform (Unix/Windows).

Please isolate and report initially the cause of this (setuptools, buidutils, ...).

Changes

Change History

Changed 4 years ago by lazaridis_com

  • status changed from new to closed
  • resolution set to fixed

Changed 4 years ago by lazaridis_com

  • owner changed from mscott to lazaridis_com

Changed 4 years ago by lazaridis_com

The existent setup.cfg files are non-operative

buildutils dependencies

example setup.cfg entry

[publish]
doc-dir=doc/html
doc-dest=scp://lazaridis_com@orbtech.com/var/www/orbtech/orbtech.com/html/
make-dirs=0

This process should be further automated in cooperation with other projects that use buildutils and the buildutil-project itself.

Closing.

Changed 4 years ago by lazaridis_com

Although the algorythm is poor, it should work.

Trying this on the louie project, I got this error:

P:\com\orbtech\louie>python setup.py publish
running publish
Traceback (most recent call last):
  File "setup.py", line 59, in ?
    test_suite = 'nose.collector',
  File "C:\Python24\lib\distutils\core.py", line 149, in setup
    dist.run_commands()
  File "C:\Python24\lib\distutils\dist.py", line 946, in run_commands
    self.run_command(cmd)
  File "C:\Python24\lib\distutils\dist.py", line 966, in run_command
    cmd_obj.run()
  File "c:\python24\lib\site-packages\buildutils-0.1.1-py2.4.egg\buildutils\command\publish.py", line 272, in run
    handler = handler_for_url(dest)
  File "c:\python24\lib\site-packages\buildutils-0.1.1-py2.4.egg\buildutils\command\publish.py", line 33, in handler_for
_url
    scheme = parseurl(url)[0]
  File "c:\python24\lib\site-packages\buildutils-0.1.1-py2.4.egg\buildutils\command\publish.py", line 28, in parseurl
    (user, passwd) = splitpasswd(auth)
  File "C:\Python24\lib\urllib.py", line 965, in splitpasswd
    match = _passwdprog.match(user)
TypeError: expected string or buffer

Changed 4 years ago by lazaridis_com

Possible solution is to install rsync on windows:

http://optics.ph.unimelb.edu.au/help/rsync/rsync_pc1.html

Changed 4 years ago by lazaridis_com

From Matthew R. Scott within email (a few weeks ago):

Here's the brief overview of what I do:

1. Make sure you have both "pudge" and "buildutils" installed from
their svn trunk.

2. Run "pbu pudge" inside the Schevo trunk checkout to build docs.
At this point you can see the results by browsing to the
doc/html/index.html file that was built.

(alternatively: python setup.py pudge)

3. Run "python setup.py sdist bdist_egg" to build a snapshot egg and
source distribution.

4. Run "rsync -zav doc/html/.
orbtech.com:var/www/orbtech/schevo.org/html." to copy documentation
to server.

5. Run "rsync -zav dist/.
orbtech.com:var/www/orbtech/schevo.org/html/dist/snapshots." to copy
distributions to server.

Of note is that you should not use "pbu publish" despite there being
entries for it in Schevo's setup.cfg -- the algorithm used to publish
is fairly poor at the moment and it's easier to just use rsync or a
similar method that does everything in one shot.

Changed 4 years ago by lazaridis_com

  • keywords split added

Changed 5 years ago by lazaridis_com

  • owner changed from orbtech to mscott

The auto-generation functionality was already discussed, but it is not relevant within this defect report (the defect must be solved, independent of automated server-side generations).

The current implementation has a defect, thus I've asked for this information:

"Please isolate and report initially the cause of this (setuptools, buidutils, ...)."

As to my knowledge, mscott is the implementor and should be able to answer this question.

Based on this information, anyone intrested can solve the defect.

Changed 5 years ago by mscott@…

A better automation would be to focus on the auto-generation of documentation on the server side upon commit. This is something we did before and it worked quite well. Once the cogs are in place.

When I have worked out a script to do this for other projects I have started, I will gladly help quickly incorporate it into Schevo. If someone else tackles this first, fine by me :)