Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
__phello__	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
__pycache__	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
asyncio	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
collections	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
concurrent	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
config-3.11-x86_64-linux-gnu	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
ctypes	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
curses	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
dbm	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
distutils	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
email	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
encodings	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
ensurepip	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
html	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
http	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
importlib	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
json	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
lib-dynload	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
lib2to3	[ DIR ]	drwxr-xr-x	2025-10-28 07:06
logging	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
multiprocessing	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
pydoc_data	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
re	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
sqlite3	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
test	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
tomllib	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
unittest	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
urllib	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
venv	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
wsgiref	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
xml	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
xmlrpc	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
zoneinfo	[ DIR ]	drwxr-xr-x	2026-07-12 06:23
EXTERNALLY-MANAGED	645 B	-rw-r--r--	2026-05-12 05:17
LICENSE.txt	13.61 KB	-rw-r--r--	2026-05-12 05:17
__future__.py	5.1 KB	-rw-r--r--	2026-05-12 05:17
__hello__.py	227 B	-rw-r--r--	2026-05-12 05:17
_aix_support.py	3.31 KB	-rw-r--r--	2026-05-12 05:17
_bootsubprocess.py	2.61 KB	-rw-r--r--	2026-05-12 05:17
_collections_abc.py	29.49 KB	-rw-r--r--	2026-05-12 05:17
_compat_pickle.py	8.56 KB	-rw-r--r--	2026-05-12 05:17
_compression.py	5.55 KB	-rw-r--r--	2026-05-12 05:17
_distutils_system_mod.py	6.16 KB	-rw-r--r--	2026-05-12 05:17
_markupbase.py	14.31 KB	-rw-r--r--	2026-05-12 05:17
_osx_support.py	21.28 KB	-rw-r--r--	2026-05-12 05:17
_py_abc.py	6.04 KB	-rw-r--r--	2026-05-12 05:17
_pydecimal.py	223.83 KB	-rw-r--r--	2026-05-12 05:17
_pyio.py	91.83 KB	-rw-r--r--	2026-05-12 05:17
_sitebuiltins.py	3.05 KB	-rw-r--r--	2026-05-12 05:17
_strptime.py	24.68 KB	-rw-r--r--	2026-05-12 05:17
_sysconfigdata__linux_x86_64-linux-gnu.py	42.36 KB	-rw-r--r--	2026-05-12 05:17
_sysconfigdata__x86_64-linux-gnu.py	42.36 KB	-rw-r--r--	2026-05-12 05:17
_threading_local.py	7.05 KB	-rw-r--r--	2026-05-12 05:17
_weakrefset.py	5.75 KB	-rw-r--r--	2026-05-12 05:17
abc.py	6.37 KB	-rw-r--r--	2026-05-12 05:17
aifc.py	33.41 KB	-rw-r--r--	2026-05-12 05:17
antigravity.py	500 B	-rw-r--r--	2026-05-12 05:17
argparse.py	97.28 KB	-rw-r--r--	2026-05-12 05:17
ast.py	59.25 KB	-rw-r--r--	2026-05-12 05:17
asynchat.py	11.3 KB	-rw-r--r--	2026-05-12 05:17
asyncore.py	19.83 KB	-rw-r--r--	2026-05-12 05:17
base64.py	20.53 KB	-rwxr-xr-x	2026-05-12 05:17
bdb.py	31.59 KB	-rw-r--r--	2026-05-12 05:17
bisect.py	3.06 KB	-rw-r--r--	2026-05-12 05:17
bz2.py	11.57 KB	-rw-r--r--	2026-05-12 05:17
cProfile.py	6.19 KB	-rwxr-xr-x	2026-05-12 05:17
calendar.py	24.17 KB	-rw-r--r--	2026-05-12 05:17
cgi.py	33.61 KB	-rwxr-xr-x	2026-05-12 05:17
cgitb.py	12.13 KB	-rw-r--r--	2026-05-12 05:17
chunk.py	5.37 KB	-rw-r--r--	2026-05-12 05:17
cmd.py	14.52 KB	-rw-r--r--	2026-05-12 05:17
code.py	10.37 KB	-rw-r--r--	2026-05-12 05:17
codecs.py	35.85 KB	-rw-r--r--	2026-05-12 05:17
codeop.py	5.47 KB	-rw-r--r--	2026-05-12 05:17
colorsys.py	3.93 KB	-rw-r--r--	2026-05-12 05:17
compileall.py	19.78 KB	-rw-r--r--	2026-05-12 05:17
configparser.py	53.96 KB	-rw-r--r--	2026-05-12 05:17
contextlib.py	26.44 KB	-rw-r--r--	2026-05-12 05:17
contextvars.py	129 B	-rw-r--r--	2026-05-12 05:17
copy.py	8.48 KB	-rw-r--r--	2026-05-12 05:17
copyreg.py	7.5 KB	-rw-r--r--	2026-05-12 05:17
crypt.py	3.82 KB	-rw-r--r--	2026-05-12 05:17
csv.py	15.65 KB	-rw-r--r--	2026-05-12 05:17
dataclasses.py	56.5 KB	-rw-r--r--	2026-05-12 05:17
datetime.py	89.85 KB	-rw-r--r--	2026-05-12 05:17
decimal.py	320 B	-rw-r--r--	2026-05-12 05:17
difflib.py	81.36 KB	-rw-r--r--	2026-05-12 05:17
dis.py	28.28 KB	-rw-r--r--	2026-05-12 05:17
doctest.py	102.71 KB	-rw-r--r--	2026-05-12 05:17
enum.py	76.81 KB	-rw-r--r--	2026-05-12 05:17
filecmp.py	9.94 KB	-rw-r--r--	2026-05-12 05:17
fileinput.py	15.33 KB	-rw-r--r--	2026-05-12 05:17
fnmatch.py	5.86 KB	-rw-r--r--	2026-05-12 05:17
fractions.py	28 KB	-rw-r--r--	2026-05-12 05:17
ftplib.py	34.66 KB	-rw-r--r--	2026-05-12 05:17
functools.py	37.51 KB	-rw-r--r--	2026-05-12 05:17
genericpath.py	4.86 KB	-rw-r--r--	2026-05-12 05:17
getopt.py	7.31 KB	-rw-r--r--	2026-05-12 05:17
getpass.py	5.85 KB	-rw-r--r--	2026-05-12 05:17
gettext.py	20.8 KB	-rw-r--r--	2026-05-12 05:17
glob.py	8.48 KB	-rw-r--r--	2026-05-12 05:17
graphlib.py	9.43 KB	-rw-r--r--	2026-05-12 05:17
gzip.py	23.51 KB	-rw-r--r--	2026-05-12 05:17
hashlib.py	11.49 KB	-rw-r--r--	2026-05-12 05:17
heapq.py	22.48 KB	-rw-r--r--	2026-05-12 05:17
hmac.py	7.54 KB	-rw-r--r--	2026-05-12 05:17
imaplib.py	53.58 KB	-rw-r--r--	2026-05-12 05:17
imghdr.py	3.86 KB	-rw-r--r--	2026-05-12 05:17
imp.py	10.36 KB	-rw-r--r--	2026-05-12 05:17
inspect.py	121.28 KB	-rw-r--r--	2026-05-12 05:17
io.py	4.14 KB	-rw-r--r--	2026-05-12 05:17
ipaddress.py	76.45 KB	-rw-r--r--	2026-05-12 05:17
keyword.py	1.04 KB	-rw-r--r--	2026-05-12 05:17
linecache.py	5.56 KB	-rw-r--r--	2026-05-12 05:17
locale.py	77.15 KB	-rw-r--r--	2026-05-12 05:17
lzma.py	12.97 KB	-rw-r--r--	2026-05-12 05:17
mailbox.py	76.95 KB	-rw-r--r--	2026-05-12 05:17
mailcap.py	9.15 KB	-rw-r--r--	2026-05-12 05:17
mimetypes.py	22.26 KB	-rw-r--r--	2026-05-12 05:17
modulefinder.py	23.14 KB	-rw-r--r--	2026-05-12 05:17
netrc.py	6.77 KB	-rw-r--r--	2026-05-12 05:17
nntplib.py	40.12 KB	-rw-r--r--	2026-05-12 05:17
ntpath.py	27.07 KB	-rw-r--r--	2026-05-12 05:17
nturl2path.py	2.82 KB	-rw-r--r--	2026-05-12 05:17
numbers.py	10.11 KB	-rw-r--r--	2026-05-12 05:17
opcode.py	10.2 KB	-rw-r--r--	2026-05-12 05:17
operator.py	10.71 KB	-rw-r--r--	2026-05-12 05:17
optparse.py	58.95 KB	-rw-r--r--	2026-05-12 05:17
os.py	38.58 KB	-rw-r--r--	2026-05-12 05:17
pathlib.py	47.44 KB	-rw-r--r--	2026-05-12 05:17
pdb.py	62.4 KB	-rwxr-xr-x	2026-05-12 05:17
pickle.py	63.43 KB	-rw-r--r--	2026-05-12 05:17
pickletools.py	91.29 KB	-rw-r--r--	2026-05-12 05:17
pipes.py	8.77 KB	-rw-r--r--	2026-05-12 05:17
pkgutil.py	24.04 KB	-rw-r--r--	2026-05-12 05:17
platform.py	41.28 KB	-rwxr-xr-x	2026-05-12 05:17
plistlib.py	27.82 KB	-rw-r--r--	2026-05-12 05:17
poplib.py	14.84 KB	-rw-r--r--	2026-05-12 05:17
posixpath.py	16.49 KB	-rw-r--r--	2026-05-12 05:17
pprint.py	23.92 KB	-rw-r--r--	2026-05-12 05:17
profile.py	22.33 KB	-rwxr-xr-x	2026-05-12 05:17
pstats.py	28.67 KB	-rw-r--r--	2026-05-12 05:17
pty.py	5.09 KB	-rw-r--r--	2026-05-12 05:17
py_compile.py	7.69 KB	-rw-r--r--	2026-05-12 05:17
pyclbr.py	11.13 KB	-rw-r--r--	2026-05-12 05:17
pydoc.py	106.57 KB	-rwxr-xr-x	2026-05-12 05:17
queue.py	11.23 KB	-rw-r--r--	2026-05-12 05:17
quopri.py	7.1 KB	-rwxr-xr-x	2026-05-12 05:17
random.py	31.41 KB	-rw-r--r--	2026-05-12 05:17
reprlib.py	5.31 KB	-rw-r--r--	2026-05-12 05:17
rlcompleter.py	7.64 KB	-rw-r--r--	2026-05-12 05:17
runpy.py	12.85 KB	-rw-r--r--	2026-05-12 05:17
sched.py	6.2 KB	-rw-r--r--	2026-05-12 05:17
secrets.py	1.98 KB	-rw-r--r--	2026-05-12 05:17
selectors.py	19.03 KB	-rw-r--r--	2026-05-12 05:17
shelve.py	8.36 KB	-rw-r--r--	2026-05-12 05:17
shlex.py	13.18 KB	-rw-r--r--	2026-05-12 05:17
shutil.py	53.58 KB	-rw-r--r--	2026-05-12 05:17
signal.py	2.38 KB	-rw-r--r--	2026-05-12 05:17
site.py	23.17 KB	-rw-r--r--	2026-05-12 05:17
sitecustomize.py	155 B	-rw-r--r--	2024-11-30 21:22
smtpd.py	30.43 KB	-rwxr-xr-x	2026-05-12 05:17
smtplib.py	44.35 KB	-rwxr-xr-x	2026-05-12 05:17
sndhdr.py	7.27 KB	-rw-r--r--	2026-05-12 05:17
socket.py	36.41 KB	-rw-r--r--	2026-05-12 05:17
socketserver.py	26.94 KB	-rw-r--r--	2026-05-12 05:17
sre_compile.py	231 B	-rw-r--r--	2026-05-12 05:17
sre_constants.py	232 B	-rw-r--r--	2026-05-12 05:17
sre_parse.py	229 B	-rw-r--r--	2026-05-12 05:17
ssl.py	52.71 KB	-rw-r--r--	2026-05-12 05:17
stat.py	5.36 KB	-rw-r--r--	2026-05-12 05:17
statistics.py	46.59 KB	-rw-r--r--	2026-05-12 05:17
string.py	11.51 KB	-rw-r--r--	2026-05-12 05:17
stringprep.py	12.61 KB	-rw-r--r--	2026-05-12 05:17
struct.py	257 B	-rw-r--r--	2026-05-12 05:17
subprocess.py	83.74 KB	-rw-r--r--	2026-05-12 05:17
sunau.py	18.05 KB	-rw-r--r--	2026-05-12 05:17
symtable.py	10.13 KB	-rw-r--r--	2026-05-12 05:17
sysconfig.py	31.35 KB	-rw-r--r--	2026-05-12 05:17
tabnanny.py	11.03 KB	-rwxr-xr-x	2026-05-12 05:17
tarfile.py	96.23 KB	-rwxr-xr-x	2026-05-12 05:17
telnetlib.py	22.75 KB	-rw-r--r--	2026-05-12 05:17
tempfile.py	34.66 KB	-rw-r--r--	2026-05-12 05:17
textwrap.py	19.26 KB	-rw-r--r--	2026-05-12 05:17
this.py	1003 B	-rw-r--r--	2026-05-12 05:17
threading.py	56.46 KB	-rw-r--r--	2026-05-12 05:17
timeit.py	13.18 KB	-rwxr-xr-x	2026-05-12 05:17
token.py	2.33 KB	-rw-r--r--	2026-05-12 05:17
tokenize.py	25.72 KB	-rw-r--r--	2026-05-12 05:17
trace.py	28.52 KB	-rwxr-xr-x	2026-05-12 05:17
traceback.py	37.52 KB	-rw-r--r--	2026-05-12 05:17
tracemalloc.py	17.62 KB	-rw-r--r--	2026-05-12 05:17
tty.py	879 B	-rw-r--r--	2026-05-12 05:17
turtle.py	140.97 KB	-rw-r--r--	2026-05-12 05:17
types.py	9.83 KB	-rw-r--r--	2026-05-12 05:17
typing.py	114.35 KB	-rw-r--r--	2026-05-12 05:17
uu.py	6.86 KB	-rwxr-xr-x	2026-05-12 05:17
uuid.py	26.95 KB	-rw-r--r--	2026-05-12 05:17
warnings.py	20.53 KB	-rw-r--r--	2026-05-12 05:17
wave.py	21.33 KB	-rw-r--r--	2026-05-12 05:17
weakref.py	21.01 KB	-rw-r--r--	2026-05-12 05:17
webbrowser.py	25.02 KB	-rwxr-xr-x	2026-05-12 05:17
xdrlib.py	5.84 KB	-rw-r--r--	2026-05-12 05:17
zipapp.py	7.36 KB	-rw-r--r--	2026-05-12 05:17
zipfile.py	91.45 KB	-rw-r--r--	2026-05-12 05:17
zipimport.py	30.17 KB	-rw-r--r--	2026-05-12 05:17

Rename

# -*- Mode: Python; tab-width: 4 -*-
#       Id: asynchat.py,v 2.26 2000/09/07 22:29:26 rushing Exp
#       Author: Sam Rushing <rushing@nightmare.com>

# ======================================================================
# Copyright 1996 by Sam Rushing
#
#                         All Rights Reserved
#
# Permission to use, copy, modify, and distribute this software and
# its documentation for any purpose and without fee is hereby
# granted, provided that the above copyright notice appear in all
# copies and that both that copyright notice and this permission
# notice appear in supporting documentation, and that the name of Sam
# Rushing not be used in advertising or publicity pertaining to
# distribution of the software without specific, written prior
# permission.
#
# SAM RUSHING DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
# INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN
# NO EVENT SHALL SAM RUSHING BE LIABLE FOR ANY SPECIAL, INDIRECT OR
# CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM LOSS
# OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
# NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN
# CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
# ======================================================================

r"""A class supporting chat-style (command/response) protocols.

This class adds support for 'chat' style protocols - where one side
sends a 'command', and the other sends a response (examples would be
the common internet protocols - smtp, nntp, ftp, etc..).

The handle_read() method looks at the input stream for the current
'terminator' (usually '\r\n' for single-line responses, '\r\n.\r\n'
for multi-line output), calling self.found_terminator() on its
receipt.

for example:
Say you build an async nntp client using this class.  At the start
of the connection, you'll have self.terminator set to '\r\n', in
order to process the single-line greeting.  Just before issuing a
'LIST' command you'll set it to '\r\n.\r\n'.  The output of the LIST
command will be accumulated (using your own 'collect_incoming_data'
method) up to the terminator, and then control will be returned to
you - by calling your self.found_terminator() method.
"""
import asyncore
from collections import deque

from warnings import _deprecated

_DEPRECATION_MSG = ('The {name} module is deprecated and will be removed in '
                    'Python {remove}. The recommended replacement is asyncio')
_deprecated(__name__, _DEPRECATION_MSG, remove=(3, 12))

class async_chat(asyncore.dispatcher):
    """This is an abstract class.  You must derive from this class, and add
    the two methods collect_incoming_data() and found_terminator()"""

# these are overridable defaults

ac_in_buffer_size = 65536
    ac_out_buffer_size = 65536

# we don't want to enable the use of encoding by default, because that is a
    # sign of an application bug that we don't want to pass silently

use_encoding = 0
    encoding = 'latin-1'

def __init__(self, sock=None, map=None):
        # for string terminator matching
        self.ac_in_buffer = b''

# we use a list here rather than io.BytesIO for a few reasons...
        # del lst[:] is faster than bio.truncate(0)
        # lst = [] is faster than bio.truncate(0)
        self.incoming = []

# we toss the use of the "simple producer" and replace it with
        # a pure deque, which the original fifo was a wrapping of
        self.producer_fifo = deque()
        asyncore.dispatcher.__init__(self, sock, map)

def collect_incoming_data(self, data):
        raise NotImplementedError("must be implemented in subclass")

def _collect_incoming_data(self, data):
        self.incoming.append(data)

def _get_data(self):
        d = b''.join(self.incoming)
        del self.incoming[:]
        return d

def found_terminator(self):
        raise NotImplementedError("must be implemented in subclass")

def set_terminator(self, term):
        """Set the input delimiter.

Can be a fixed string of any length, an integer, or None.
        """
        if isinstance(term, str) and self.use_encoding:
            term = bytes(term, self.encoding)
        elif isinstance(term, int) and term < 0:
            raise ValueError('the number of received bytes must be positive')
        self.terminator = term

def get_terminator(self):
        return self.terminator

# grab some more data from the socket,
    # throw it to the collector method,
    # check for the terminator,
    # if found, transition to the next state.

def handle_read(self):

try:
            data = self.recv(self.ac_in_buffer_size)
        except BlockingIOError:
            return
        except OSError:
            self.handle_error()
            return

if isinstance(data, str) and self.use_encoding:
            data = bytes(str, self.encoding)
        self.ac_in_buffer = self.ac_in_buffer + data

# Continue to search for self.terminator in self.ac_in_buffer,
        # while calling self.collect_incoming_data.  The while loop
        # is necessary because we might read several data+terminator
        # combos with a single recv(4096).

while self.ac_in_buffer:
            lb = len(self.ac_in_buffer)
            terminator = self.get_terminator()
            if not terminator:
                # no terminator, collect it all
                self.collect_incoming_data(self.ac_in_buffer)
                self.ac_in_buffer = b''
            elif isinstance(terminator, int):
                # numeric terminator
                n = terminator
                if lb < n:
                    self.collect_incoming_data(self.ac_in_buffer)
                    self.ac_in_buffer = b''
                    self.terminator = self.terminator - lb
                else:
                    self.collect_incoming_data(self.ac_in_buffer[:n])
                    self.ac_in_buffer = self.ac_in_buffer[n:]
                    self.terminator = 0
                    self.found_terminator()
            else:
                # 3 cases:
                # 1) end of buffer matches terminator exactly:
                #    collect data, transition
                # 2) end of buffer matches some prefix:
                #    collect data to the prefix
                # 3) end of buffer does not match any prefix:
                #    collect data
                terminator_len = len(terminator)
                index = self.ac_in_buffer.find(terminator)
                if index != -1:
                    # we found the terminator
                    if index > 0:
                        # don't bother reporting the empty string
                        # (source of subtle bugs)
                        self.collect_incoming_data(self.ac_in_buffer[:index])
                    self.ac_in_buffer = self.ac_in_buffer[index+terminator_len:]
                    # This does the Right Thing if the terminator
                    # is changed here.
                    self.found_terminator()
                else:
                    # check for a prefix of the terminator
                    index = find_prefix_at_end(self.ac_in_buffer, terminator)
                    if index:
                        if index != lb:
                            # we found a prefix, collect up to the prefix
                            self.collect_incoming_data(self.ac_in_buffer[:-index])
                            self.ac_in_buffer = self.ac_in_buffer[-index:]
                        break
                    else:
                        # no prefix, collect it all
                        self.collect_incoming_data(self.ac_in_buffer)
                        self.ac_in_buffer = b''

def handle_write(self):
        self.initiate_send()

def handle_close(self):
        self.close()

def push(self, data):
        if not isinstance(data, (bytes, bytearray, memoryview)):
            raise TypeError('data argument must be byte-ish (%r)',
                            type(data))
        sabs = self.ac_out_buffer_size
        if len(data) > sabs:
            for i in range(0, len(data), sabs):
                self.producer_fifo.append(data[i:i+sabs])
        else:
            self.producer_fifo.append(data)
        self.initiate_send()

def push_with_producer(self, producer):
        self.producer_fifo.append(producer)
        self.initiate_send()

def readable(self):
        "predicate for inclusion in the readable for select()"
        # cannot use the old predicate, it violates the claim of the
        # set_terminator method.

# return (len(self.ac_in_buffer) <= self.ac_in_buffer_size)
        return 1

def writable(self):
        "predicate for inclusion in the writable for select()"
        return self.producer_fifo or (not self.connected)

def close_when_done(self):
        "automatically close this channel once the outgoing queue is empty"
        self.producer_fifo.append(None)

def initiate_send(self):
        while self.producer_fifo and self.connected:
            first = self.producer_fifo[0]
            # handle empty string/buffer or None entry
            if not first:
                del self.producer_fifo[0]
                if first is None:
                    self.handle_close()
                    return

# handle classic producer behavior
            obs = self.ac_out_buffer_size
            try:
                data = first[:obs]
            except TypeError:
                data = first.more()
                if data:
                    self.producer_fifo.appendleft(data)
                else:
                    del self.producer_fifo[0]
                continue

if isinstance(data, str) and self.use_encoding:
                data = bytes(data, self.encoding)

# send the data
            try:
                num_sent = self.send(data)
            except OSError:
                self.handle_error()
                return

if num_sent:
                if num_sent < len(data) or obs < len(first):
                    self.producer_fifo[0] = first[num_sent:]
                else:
                    del self.producer_fifo[0]
            # we tried to send some actual data
            return

def discard_buffers(self):
        # Emergencies only!
        self.ac_in_buffer = b''
        del self.incoming[:]
        self.producer_fifo.clear()

class simple_producer:

def __init__(self, data, buffer_size=512):
        self.data = data
        self.buffer_size = buffer_size

def more(self):
        if len(self.data) > self.buffer_size:
            result = self.data[:self.buffer_size]
            self.data = self.data[self.buffer_size:]
            return result
        else:
            result = self.data
            self.data = b''
            return result

# Given 'haystack', see if any prefix of 'needle' is at its end.  This
# assumes an exact match has already been checked.  Return the number of
# characters matched.
# for example:
# f_p_a_e("qwerty\r", "\r\n") => 1
# f_p_a_e("qwertydkjf", "\r\n") => 0
# f_p_a_e("qwerty\r\n", "\r\n") => <undefined>

# this could maybe be made faster with a computed regex?
# [answer: no; circa Python-2.0, Jan 2001]
# new python:   28961/s
# old python:   18307/s
# re:        12820/s
# regex:     14035/s

def find_prefix_at_end(haystack, needle):
    l = len(needle) - 1
    while l and not haystack.endswith(needle[:l]):
        l -= 1
    return l