summaryrefslogtreecommitdiff
path: root/src/mailman/rest/root.py
blob: a6dc2624851a658f289597a79ba41dcda608e656 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
# Copyright (C) 2009 by the Free Software Foundation, Inc.
#
# This file is part of GNU Mailman.
#
# GNU Mailman is free software: you can redistribute it and/or modify it under
# the terms of the GNU General Public License as published by the Free
# Software Foundation, either version 3 of the License, or (at your option)
# any later version.
#
# GNU Mailman is distributed in the hope that it will be useful, but WITHOUT
# ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
# FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for
# more details.
#
# You should have received a copy of the GNU General Public License along with
# GNU Mailman.  If not, see <http://www.gnu.org/licenses/>.

"""The RESTful service root."""

from __future__ import absolute_import, unicode_literals

__metaclass__ = type
__all__ = [
    'AdminWebServiceRootResource',
    'AdminWebServiceRootAbsoluteURL',
    ]


from lazr.restful import ServiceRootResource
from lazr.restful.interfaces import ICollection
from zope.component import adapts
from zope.interface import implements
from zope.publisher.interfaces.browser import IDefaultBrowserLayer
from zope.traversing.browser.interfaces import IAbsoluteURL

from mailman.config import config
from mailman.core.system import system



class AdminWebServiceRootResource(ServiceRootResource):
    """The root of the Mailman RESTful admin web service."""


class AdminWebServiceRootAbsoluteURL:
    """A basic implementation of `IAbsoluteURL` for the root object."""

    implements(IAbsoluteURL)
    adapts(AdminWebServiceRootResource, IDefaultBrowserLayer)

    def __init__(self, context, request):
        """Initialize with respect to a context and request."""
        # Avoid circular imports.
        from mailman.rest.configuration import AdminWebServiceConfiguration
        self.webservice_config = AdminWebServiceConfiguration()
        self.version = webservice_config.service_version_uri_prefix
        self.schema = ('https' if self.webservice_config.use_https else 'http')
        self.hostname = config.webservice.hostname

    def __str__(self):
        """Return the semi-hard-coded URL to the service root."""
        return '{0.schema}://{0.hostname}/{0.version}'.format(self)

    __call__ = __str__