OnroerendErfgoed / crabpy

            h.set_gateway(self)

        return huisnummers

    def list_huisnummers_by_perceel(self, perceel, sort=1):

        '''

        List all `huisnummers` on a `Pereel`.

        Generally there will only be one, but multiples are possible.

        :param perceel: The :class:`Perceel` for which the \

            `huisnummers` are wanted.

        :rtype: A :class: `list` of :class:`Huisnummer`

        '''

        try:

            id = perceel.id

        except AttributeError:

            id = perceel

        def creator():

            res = crab_gateway_request(

                self.client, 'ListHuisnummersWithStatusByIdentificatorPerceel',

                id, sort

            )

            try:

                huisnummers= []

                for r in res.HuisnummerWithStatusItem:

                    h = self.get_huisnummer_by_id(r.HuisnummerId)

                    h.clear_gateway()

                    huisnummers.append(h)

                return huisnummers

            except AttributeError:

                return []

        if self.caches['short'].is_configured:

            key = 'ListHuisnummersWithStatusByIdentificatorPerceel#%s%s' % (id, sort)

            huisnummers = self.caches['short'].get_or_create(key, creator)

        else:

            huisnummers = creator()

        for h in huisnummers:

            h.set_gateway(self)

        return huisnummers

    def get_huisnummer_by_id(self, id):

        '''

            g.set_gateway(self)

        return gemeente

    def list_gemeenten(self, gewest=2, sort=1):

        '''

        List all `gemeenten` in a `gewest`.

        :param gewest: The :class:`Gewest` for which the \

            `gemeenten` are wanted.

        :param integer sort: What field to sort on.

        :rtype: A :class:`list` of :class:`Gemeente`.

        '''

        try:

            gewest_id = gewest.id

        except AttributeError:

            gewest_id = gewest

            gewest = self.get_gewest_by_id(gewest_id)

        gewest.clear_gateway()

        def creator():

            res = crab_gateway_request(

                self.client, 'ListGemeentenByGewestId', gewest_id, sort

            )

            return[

                Gemeente(

                    r.GemeenteId,

                    r.GemeenteNaam,

                    r.NISGemeenteCode,

                    gewest

                )for r in res.GemeenteItem if r.TaalCode == r.TaalCodeGemeenteNaam

            ]

        if self.caches['permanent'].is_configured:

            key = 'ListGemeentenByGewestId#%s#%s' % (gewest_id, sort)

            gemeenten = self.caches['permanent'].get_or_create(key, creator)

        else:

            gemeenten = creator()

        for g in gemeenten:

            g.set_gateway(self)

        return gemeenten

    def get_gemeente_by_id(self, id):

        '''

        provincie.set_gateway(self)

        return provincie

    def list_gemeenten_by_provincie(self, provincie):

        '''

        List all `gemeenten` in a `provincie`.

        :param provincie: The :class:`Provincie` for which the \

            `gemeenten` are wanted.

        :rtype: A :class:`list` of :class:`Gemeente`.

        '''

        try:

            gewest = provincie.gewest

            prov = provincie

        except AttributeError:

            prov = self.get_provincie_by_id(provincie)

            gewest = prov.gewest

        gewest.clear_gateway()

        def creator():

            gewest_gemeenten = self.list_gemeenten(gewest.id)

            return[

                Gemeente(

                    r.id,

                    r.naam,

                    r.niscode,

                    gewest

                )for r in gewest_gemeenten if str(r.niscode)[0] == str(prov.niscode)[0]

            ]

        if self.caches['permanent'].is_configured:

            key = 'ListGemeentenByProvincieId#%s' % prov.id

            gemeente = self.caches['long'].get_or_create(key, creator)

        else:

            gemeente = creator()

        for g in gemeente:

            g.set_gateway(self)

        return gemeente

    def list_gemeenten(self, gewest=2, sort=1):

        '''

            key = 'GetKadAfdelingByKadAfdelingcode#%s' % id

            afdeling = self.caches['long'].get_or_create(key, creator)

        else:

            afdeling = creator()

        afdeling.set_gateway(self)

        return afdeling

    @deprecate(DEPRECATIONWARNING.format('.list_secties_by_afdeling'))

    def list_secties_by_afdeling(self, afdeling):

        '''

        List all `secties` in a `kadastrale afdeling`.

        :param afdeling: The :class:`Afdeling` for which the `secties` are \

            wanted. Can also be the id of and `afdeling`.

        :rtype: A :class:`list` of `Sectie`.

        '''

        try:

            aid = afdeling.id

        except AttributeError:

            aid = afdeling

            afdeling = self.get_kadastrale_afdeling_by_id(aid)

        afdeling.clear_gateway()

        def creator():

            res = capakey_gateway_request(

                self.client, 'ListKadSectiesByKadAfdelingcode', aid

            )

            try:

                return [

                    Sectie(

                        r.KadSectiecode,

                        afdeling

                    ) for r in res.KadSectieItem

                ]

            except AttributeError:

                # Handle bad error handling on the CAPAKEY side

                return []

        if self.caches['long'].is_configured:

            key = 'ListKadSectiesByKadAfdelingcode#%s' % aid

            secties = self.caches['long'].get_or_create(key, creator)

        else:

            secties = creator()

        for s in secties:

            s.set_gateway(self)