This file is indexed.

/usr/share/pyshared/qpid/reference.py is in python-qpid 0.22+dfsg-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  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
#!/usr/bin/env python

#
# Licensed to the Apache Software Foundation (ASF) under one
# or more contributor license agreements.  See the NOTICE file
# distributed with this work for additional information
# regarding copyright ownership.  The ASF licenses this file
# to you under the Apache License, Version 2.0 (the
# "License"); you may not use this file except in compliance
# with the License.  You may obtain a copy of the License at
# 
#   http://www.apache.org/licenses/LICENSE-2.0
# 
# Unless required by applicable law or agreed to in writing,
# software distributed under the License is distributed on an
# "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
# KIND, either express or implied.  See the License for the
# specific language governing permissions and limitations
# under the License.
#

"""
Support for amqp 'reference' content (as opposed to inline content)
"""

import threading
from queue import Queue, Closed

class NotOpened(Exception): pass

class AlreadyOpened(Exception): pass

"""
A representation of a reference id; can be passed wherever amqp
content is required in place of inline data
"""
class ReferenceId:

    def __init__(self, id):
        self.id = id

"""
Holds content received through 'reference api'. Instances of this
class will be placed in the consumers queue on receiving a transfer
(assuming the reference has been opened). Data can be retrieved in
chunks (as append calls are received) or in full (after reference has
been closed signalling data s complete).
"""

class Reference:

    def __init__(self, id):
        self.id = id
        self.chunks = Queue(0)

    def close(self):
        self.chunks.close()

    def append(self, bytes):    
        self.chunks.put(bytes)

    def get_chunk(self):
        return self.chunks.get()

    def get_complete(self):
        data = ""
        for chunk in self:
            data += chunk
        return data

    def next(self):
        try:
            return self.get_chunk()
        except Closed, e:
            raise StopIteration

    def __iter__(self):
        return self

"""
Manages a set of opened references. New references can be opened and
existing references can be retrieved or closed.
"""
class References:

    def __init__(self):
        self.map = {}
        self.lock = threading.Lock()

    def get(self, id):
        self.lock.acquire()
        try:
            try:
                ref = self.map[id]
            except KeyError:
                raise NotOpened()
        finally:
            self.lock.release()
        return ref

    def open(self, id):
        self.lock.acquire()
        try:
            if id in self.map: raise AlreadyOpened()
            self.map[id] = Reference(id)
        finally:
            self.lock.release()


    def close(self, id):
        self.get(id).close()
        self.lock.acquire()
        try:
            self.map.pop(id)
        finally:
            self.lock.release()