aboutsummaryrefslogtreecommitdiffstats
path: root/github3/handlers/base.py
blob: 0b3fa8a7996acba1b25225c844a5a6299c36d4fd (plain) (blame)
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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
#!/usr/bin/env python
# -*- encoding: utf-8 -*-
#
# author: David Medina

from github3.core import Paginate
from github3.converters import Modelizer

class Handler(object):
    """ Handler base. Requests to API and modelize responses """

    def __init__(self, gh):
        self._gh = gh
        super(Handler, self).__init__()

    def _prefix_resource(self, resource):
        prefix = getattr(self, 'prefix', '')
        return '/'.join((prefix, str(resource))).strip('/')

    def _get_converter(self, **kwargs):
        converter = kwargs.get(
            'converter', # 1. in kwargs
            getattr(self, 'converter', # 2. in handler
            Modelizer)) # 3. Default

        return converter()

    def _put(self, resource, **kwargs):
        """ Put proxy request"""

        return self._bool(resource, method='put', **kwargs)

    def _delete(self, resource, **kwargs):
        """ Delete proxy request"""

        return self._bool(resource, method='delete', **kwargs)

    def _bool(self, resource, **kwargs):
        """ Handler request to boolean response """

        from github3.exceptions import NotFound
        resource = self._prefix_resource(resource)
        try:
            callback = getattr(self._gh, kwargs.get('method',''), self._gh.head)
            response = callback(resource, **kwargs)
        except NotFound:
            return False
        assert response.status_code == 204
        return True

    def _get_resources(self, resource, model=None, limit=None, **kwargs):
        """ Hander request to multiple resources """

        if limit:
            limit = abs(limit)
        resource = self._prefix_resource(resource)
        counter = 1
        for page in Paginate(resource, self._gh.get, **kwargs):
            for raw_resource in page:
                counter += 1
                converter = self._get_converter(**kwargs)
                converter.inject(model)
                yield converter.loads(raw_resource)
                if limit and counter > limit: break
            else:
                continue
            break

    def _get_resource(self, resource, model=None, **kwargs):
        """ Handler request to single resource """

        resource = self._prefix_resource(resource)
        raw_resource = self._gh.get(resource)
        converter = self._get_converter(**kwargs)
        converter.inject(model)
        return converter.loads(raw_resource)

    def _post_resource(self, resource, data, model=None, **kwargs):
        """ Handler request to create a resource """

        resource = self._prefix_resource(resource)
        raw_resource = self._gh.post(resource, data=data)
        converter = self._get_converter(**kwargs)
        converter.inject(model)
        return converter.loads(raw_resource)