summaryrefslogtreecommitdiffstats
path: root/gi/types.py
blob: 10d7fdebf2a40bd1c4e01ba5d3ceff88a021d472 (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
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
# -*- Mode: Python; py-indent-offset: 4 -*-
# vim: tabstop=4 shiftwidth=4 expandtab
#
# Copyright (C) 2005-2009 Johan Dahlin <johan@gnome.org>
#
#   types.py: base types for introspected items.
#
# This library is free software; you can redistribute it and/or
# modify it under the terms of the GNU Lesser General Public
# License as published by the Free Software Foundation; either
# version 2.1 of the License, or (at your option) any later version.
#
# This library 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
# Lesser General Public License for more details.
#
# You should have received a copy of the GNU Lesser General Public
# License along with this library; if not, write to the Free Software
# Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301
# USA

from __future__ import absolute_import

import sys
import gobject

from ._gi import \
    InterfaceInfo, \
    ObjectInfo, \
    StructInfo, \
    set_object_has_new_constructor


class Boxed(gobject.GBoxed):
    # Instances of boxed structures cannot be constructed unless they have a
    # specific constructor.
    #
    # To achieve this behavior, PyGBoxed_Type's constructor creates an
    # instance, and the initializer eventually raises an exception. If things
    # had been implemented correctly, PyGBoxed_Type.tp_new would have been set to
    # NULL, and neither a creator nor an initializer wouldn't have been needed.
    #
    # In order to keep the code generic, we need to revert the right behavior.

    def __new__(cls):
        raise TypeError, "instances of '%s' cannot be created" % cls.__name__

    def __init__(self, *args, **kwargs):
        pass


def Function(info):

    def function(*args):
        return info.invoke(*args)
    function.__info__ = info
    function.__name__ = info.get_name()
    function.__module__ = info.get_namespace()

    return function


def Constructor(info):

    def constructor(cls, *args):
        cls_name = info.get_container().get_name()
        if cls.__name__ != cls_name:
            raise TypeError, '%s constructor cannot be used to create instances of a subclass' % cls_name
        return info.invoke(cls, *args)

    constructor.__info__ = info
    constructor.__name__ = info.get_name()
    constructor.__module__ = info.get_namespace()

    return constructor


class MetaClassHelper(object):

    def _setup_methods(cls):
        for method_info in cls.__info__.get_methods():
            name = method_info.get_name()
            function = Function(method_info)
            if method_info.is_method():
                method = function
            elif method_info.is_constructor():
                continue
            else:
                method = staticmethod(function)
            setattr(cls, name, method)

    def _setup_fields(cls):
        for field_info in cls.__info__.get_fields():
            name = field_info.get_name().replace('-', '_')
            setattr(cls, name, property(field_info.get_value, field_info.set_value))

    def _setup_constants(cls):
        for constant_info in cls.__info__.get_constants():
            name = constant_info.get_name()
            value = constant_info.get_value()
            setattr(cls, name, value)


class GObjectMeta(gobject.GObjectMeta, MetaClassHelper):

    def _setup_constructors(cls):
        for method_info in cls.__info__.get_methods():
            if method_info.is_constructor():
                name = method_info.get_name()
                constructor = classmethod(Constructor(method_info))
                setattr(cls, name, constructor)

    def __init__(cls, name, bases, dict_):
        super(GObjectMeta, cls).__init__(name, bases, dict_)

        # Avoid touching anything else than the base class.
        if cls.__name__ != cls.__info__.get_name():
            return;

        cls._setup_methods()
        cls._setup_constants()

        if (isinstance(cls.__info__, ObjectInfo)):
            cls._setup_fields()
            cls._setup_constructors()
            set_object_has_new_constructor(cls.__info__.get_g_type())


class StructMeta(type, MetaClassHelper):

    def _setup_constructors(cls):
        constructor_infos = []
        default_constructor_info = None

        for method_info in cls.__info__.get_methods():
            if method_info.is_constructor():
                name = method_info.get_name()
                constructor = classmethod(Function(method_info))

                setattr(cls, name, constructor)

                constructor_infos.append(method_info)
                if name == "new":
                    default_constructor_info = method_info

        if default_constructor_info is None and constructor_infos:
            default_constructor_info = constructor_infos[0]

        if default_constructor_info is not None:
            cls.__new__ = staticmethod(Function(default_constructor_info))

    def __init__(cls, name, bases, dict_):
        super(StructMeta, cls).__init__(name, bases, dict_)

        # Avoid touching anything else than the base class.
        if cls.__name__ != cls.__info__.get_name():
            return;

        cls._setup_fields()
        cls._setup_methods()
        cls._setup_constructors()