~loggerhead-team/loggerhead/trunk-rich

« back to all changes in this revision

Viewing changes to __init__.py

  • Committer: Martin Pool
  • Date: 2009-01-23 22:36:38 UTC
  • mto: This revision was merged to the branch mainline in revision 298.
  • Revision ID: mbp@sourcefrog.net-20090123223638-s57mqtpu4um3stes
Act as a plugin only when loaded by bzr; update docs

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
1
# Copyright 2009 Canonical Ltd
 
2
#
 
3
# This program is free software; you can redistribute it and/or modify
 
4
# it under the terms of the GNU General Public License as published by
 
5
# the Free Software Foundation; either version 2 of the License, or
 
6
# (at your option) any later version.
 
7
#
 
8
# This program is distributed in the hope that it will be useful,
 
9
# but WITHOUT ANY WARRANTY; without even the implied warranty of
 
10
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 
11
# GNU General Public License for more details.
 
12
#
 
13
# You should have received a copy of the GNU General Public License
 
14
# along with this program; if not, write to the Free Software
 
15
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
 
16
 
2
17
 
3
18
# This file allows loggerhead to be treated as a plugin for bzr.
4
19
#
5
 
# XXX: Because loggerhead already contains a loggerhead directory, much of the code
6
 
# is going to live in bzrlib.plugins.loggerhead.loggerhead.  But moving it can
7
 
# wait.  When we do move it, we may need to guard the plugin code by __name__
8
 
# so it can be used as a library from other places.  -- mbp 20090123
9
 
 
10
 
"""Loggerhead web viewer for Bazaar branches."""
11
 
 
12
 
import bzrlib
13
 
from bzrlib.api import require_api
 
20
# XXX: Because loggerhead already contains a loggerhead directory, much of the
 
21
# code is going to appear loaded at bzrlib.plugins.loggerhead.loggerhead.
 
22
# This seems like the easiest thing, because bzrlib wants the top-level plugin
 
23
# directory to be the module, but when it's used as a library people expect
 
24
# the source directory to contain a directory called loggerhead.  -- mbp
 
25
# 20090123
 
26
 
 
27
"""Loggerhead web viewer for Bazaar branches.
 
28
 
 
29
This provides a new option "--http" to the "bzr serve" command, that 
 
30
starts a web server to browse the contents of a branch.
 
31
"""
14
32
 
15
33
version_info = (1, 11, 0)
16
34
 
17
 
require_api(bzrlib, (1, 11, 0))
18
 
 
19
 
 
20
 
# TODO: All the following should be in a lazily-loaded module.
21
 
#
22
 
# TODO: This should provide a new type of server that can be used by bzr
23
 
# serve, maybe through a registry, rather than overriding the command.  Though
24
 
# maybe we should keep the wrapper to work with older bzr releases, at least
25
 
# for a bit.
26
 
#
27
 
# TODO: If a --port option is given, use that.
28
 
 
29
 
import bzrlib.builtins
30
 
from bzrlib.commands import get_cmd_object, register_command
31
 
from bzrlib.option import Option
32
 
 
33
 
_original_command = get_cmd_object('serve')
34
 
 
35
 
class cmd_serve(bzrlib.builtins.cmd_serve):
36
 
    __doc__ = _original_command.__doc__
37
 
 
38
 
    takes_options = _original_command.takes_options + [
39
 
        Option('http',
40
 
            help='Run an http (Loggerhead) server to browse code, by default on port 9876.')]
41
 
 
42
 
    def run(self, *args, **kw):
43
 
        if 'http' in kw:
44
 
            # hack around loggerhead expecting to be loaded from the module
45
 
            # "loggerhead" - this may be wrong in some cases?
46
 
            import os.path, sys
47
 
            sys.path.append(os.path.dirname(__file__))
48
 
 
49
 
            from loggerhead.apps.filesystem import BranchesFromFileSystemRoot
50
 
            from paste.httpexceptions import HTTPExceptionHandler
51
 
            from paste.httpserver import serve
52
 
            a = HTTPExceptionHandler(BranchesFromFileSystemRoot('.'))
53
 
            port = kw.get('port', '9876')
54
 
            if ':' in port:
55
 
                host, port = port.split(':')
 
35
if __name__ == 'bzrlib.plugins.loggerhead':
 
36
    import bzrlib
 
37
    from bzrlib.api import require_api
 
38
 
 
39
    require_api(bzrlib, (1, 11, 0))
 
40
 
 
41
    # TODO: This should provide a new type of server that can be used by bzr
 
42
    # serve, maybe through a registry, rather than overriding the command.  Though
 
43
    # maybe we should keep the wrapper to work with older bzr releases, at least
 
44
    # for a bit.
 
45
 
 
46
    # NB: Normally plugins should lazily load almost everything, but this
 
47
    # seems reasonable to have in-line here: bzrlib.commands and options are
 
48
    # normally loaded, and the rest of loggerhead won't be loaded until serve
 
49
    # --http is run.
 
50
        
 
51
    import bzrlib.builtins
 
52
    from bzrlib.commands import get_cmd_object, register_command
 
53
    from bzrlib.option import Option
 
54
 
 
55
    _original_command = get_cmd_object('serve')
 
56
 
 
57
    DEFAULT_PORT = 8080
 
58
 
 
59
    class cmd_serve(bzrlib.builtins.cmd_serve):
 
60
        __doc__ = _original_command.__doc__
 
61
 
 
62
        takes_options = _original_command.takes_options + [
 
63
            Option('http',
 
64
                help='Run an http (Loggerhead) server to browse code, '
 
65
                    'by default on port %s.' % DEFAULT_PORT)]
 
66
 
 
67
        def run(self, *args, **kw):
 
68
            if 'http' in kw:
 
69
                # loggerhead internal code will try to 'import loggerhead', so
 
70
                # let's put it on the path
 
71
                import os.path, sys
 
72
                sys.path.append(os.path.dirname(__file__))
 
73
 
 
74
                from loggerhead.apps.filesystem import BranchesFromFileSystemRoot
 
75
                from paste.httpexceptions import HTTPExceptionHandler
 
76
                from paste.httpserver import serve
 
77
                a = HTTPExceptionHandler(BranchesFromFileSystemRoot('.'))
 
78
                port = kw.get('port', DEFAULT_PORT)
 
79
                if ':' in port:
 
80
                    host, port = port.split(':')
 
81
                else:
 
82
                    host = '0.0.0.0'
 
83
                serve(a, host=host, port=port)
56
84
            else:
57
 
                host = '0.0.0.0'
58
 
            serve(a, host=host, port=port)
59
 
        else:
60
 
            super(cmd_serve, self).run(*args, **kw)
 
85
                super(cmd_serve, self).run(*args, **kw)
61
86
 
62
 
register_command(cmd_serve)
 
87
    register_command(cmd_serve)