py2docfx 0.1.15.dev2025501__py3-none-any.whl → 0.1.15.dev2038808__py3-none-any.whl

py2docfx/venv/venv1/Lib/site-packages/isapi/isapicon.py

@@ -1,121 +0,0 @@
-"""Constants needed by ISAPI filters and extensions."""
-
-#  ======================================================================
-#  Copyright 2002-2003 by Blackdog Software Pty Ltd.
-#
-#                          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
-#  Blackdog Software not be used in advertising or publicity pertaining to
-#  distribution of the software without specific, written prior
-#  permission.
-#
-#  BLACKDOG SOFTWARE DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE,
-#  INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN
-#  NO EVENT SHALL BLACKDOG SOFTWARE 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.
-#  ======================================================================
-
-# HTTP reply codes
-
-HTTP_CONTINUE = 100
-HTTP_SWITCHING_PROTOCOLS = 101
-HTTP_PROCESSING = 102
-HTTP_OK = 200
-HTTP_CREATED = 201
-HTTP_ACCEPTED = 202
-HTTP_NON_AUTHORITATIVE = 203
-HTTP_NO_CONTENT = 204
-HTTP_RESET_CONTENT = 205
-HTTP_PARTIAL_CONTENT = 206
-HTTP_MULTI_STATUS = 207
-HTTP_MULTIPLE_CHOICES = 300
-HTTP_MOVED_PERMANENTLY = 301
-HTTP_MOVED_TEMPORARILY = 302
-HTTP_SEE_OTHER = 303
-HTTP_NOT_MODIFIED = 304
-HTTP_USE_PROXY = 305
-HTTP_TEMPORARY_REDIRECT = 307
-HTTP_BAD_REQUEST = 400
-HTTP_UNAUTHORIZED = 401
-HTTP_PAYMENT_REQUIRED = 402
-HTTP_FORBIDDEN = 403
-HTTP_NOT_FOUND = 404
-HTTP_METHOD_NOT_ALLOWED = 405
-HTTP_NOT_ACCEPTABLE = 406
-HTTP_PROXY_AUTHENTICATION_REQUIRED = 407
-HTTP_REQUEST_TIME_OUT = 408
-HTTP_CONFLICT = 409
-HTTP_GONE = 410
-HTTP_LENGTH_REQUIRED = 411
-HTTP_PRECONDITION_FAILED = 412
-HTTP_REQUEST_ENTITY_TOO_LARGE = 413
-HTTP_REQUEST_URI_TOO_LARGE = 414
-HTTP_UNSUPPORTED_MEDIA_TYPE = 415
-HTTP_RANGE_NOT_SATISFIABLE = 416
-HTTP_EXPECTATION_FAILED = 417
-HTTP_UNPROCESSABLE_ENTITY = 422
-HTTP_INTERNAL_SERVER_ERROR = 500
-HTTP_NOT_IMPLEMENTED = 501
-HTTP_BAD_GATEWAY = 502
-HTTP_SERVICE_UNAVAILABLE = 503
-HTTP_GATEWAY_TIME_OUT = 504
-HTTP_VERSION_NOT_SUPPORTED = 505
-HTTP_VARIANT_ALSO_VARIES = 506
-
-HSE_STATUS_SUCCESS = 1
-HSE_STATUS_SUCCESS_AND_KEEP_CONN = 2
-HSE_STATUS_PENDING = 3
-HSE_STATUS_ERROR = 4
-
-SF_NOTIFY_SECURE_PORT = 0x00000001
-SF_NOTIFY_NONSECURE_PORT = 0x00000002
-SF_NOTIFY_READ_RAW_DATA = 0x00008000
-SF_NOTIFY_PREPROC_HEADERS = 0x00004000
-SF_NOTIFY_AUTHENTICATION = 0x00002000
-SF_NOTIFY_URL_MAP = 0x00001000
-SF_NOTIFY_ACCESS_DENIED = 0x00000800
-SF_NOTIFY_SEND_RESPONSE = 0x00000040
-SF_NOTIFY_SEND_RAW_DATA = 0x00000400
-SF_NOTIFY_LOG = 0x00000200
-SF_NOTIFY_END_OF_REQUEST = 0x00000080
-SF_NOTIFY_END_OF_NET_SESSION = 0x00000100
-
-SF_NOTIFY_ORDER_HIGH = 0x00080000
-SF_NOTIFY_ORDER_MEDIUM = 0x00040000
-SF_NOTIFY_ORDER_LOW = 0x00020000
-SF_NOTIFY_ORDER_DEFAULT = SF_NOTIFY_ORDER_LOW
-
-SF_NOTIFY_ORDER_MASK = (
-    SF_NOTIFY_ORDER_HIGH | SF_NOTIFY_ORDER_MEDIUM | SF_NOTIFY_ORDER_LOW
-)
-
-SF_STATUS_REQ_FINISHED = 134217728  # 0x8000000
-SF_STATUS_REQ_FINISHED_KEEP_CONN = 134217728 + 1
-SF_STATUS_REQ_NEXT_NOTIFICATION = 134217728 + 2
-SF_STATUS_REQ_HANDLED_NOTIFICATION = 134217728 + 3
-SF_STATUS_REQ_ERROR = 134217728 + 4
-SF_STATUS_REQ_READ_NEXT = 134217728 + 5
-
-HSE_IO_SYNC = 0x00000001  # for WriteClient
-HSE_IO_ASYNC = 0x00000002  # for WriteClient/TF/EU
-HSE_IO_DISCONNECT_AFTER_SEND = 0x00000004  # for TF
-HSE_IO_SEND_HEADERS = 0x00000008  # for TF
-HSE_IO_NODELAY = 0x00001000  # turn off nagling
-# These two are only used by VectorSend
-HSE_IO_FINAL_SEND = 0x00000010
-HSE_IO_CACHE_RESPONSE = 0x00000020
-
-HSE_EXEC_URL_NO_HEADERS = 0x02
-HSE_EXEC_URL_IGNORE_CURRENT_INTERCEPTOR = 0x04
-HSE_EXEC_URL_IGNORE_VALIDATION_AND_RANGE = 0x10
-HSE_EXEC_URL_DISABLE_CUSTOM_ERROR = 0x20
-HSE_EXEC_URL_SSI_CMD = 0x40
-HSE_EXEC_URL_HTTP_CACHE_ELIGIBLE = 0x80

py2docfx/venv/venv1/Lib/site-packages/isapi/samples/advanced.py

@@ -1,218 +0,0 @@
-# This extension demonstrates some advanced features of the Python ISAPI
-# framework.
-# We demonstrate:
-# * Reloading your Python module without shutting down IIS (eg, when your
-#   .py implementation file changes.)
-# * Custom command-line handling - both additional options and commands.
-# * Using a query string - any part of the URL after a '?' is assumed to
-#   be "variable names" separated by '&' - we will print the values of
-#   these server variables.
-# * If the tail portion of the URL is "ReportUnhealthy", IIS will be
-#   notified we are unhealthy via a HSE_REQ_REPORT_UNHEALTHY request.
-#   Whether this is acted upon depends on if the IIS health-checking
-#   tools are installed, but you should always see the reason written
-#   to the Windows event log - see the IIS documentation for more.
-
-import os
-import stat
-import sys
-
-from isapi import isapicon
-from isapi.simple import SimpleExtension
-
-if hasattr(sys, "isapidllhandle"):
-    import win32traceutil
-
-# Notes on reloading
-# If your HttpFilterProc or HttpExtensionProc functions raises
-# 'isapi.InternalReloadException', the framework will not treat it
-# as an error but instead will terminate your extension, reload your
-# extension module, re-initialize the instance, and re-issue the request.
-# The Initialize functions are called with None as their param.  The
-# return code from the terminate function is ignored.
-#
-# This is all the framework does to help you.  It is up to your code
-# when you raise this exception.  This sample uses a Win32 "find
-# notification".  Whenever windows tells us one of the files in the
-# directory has changed, we check if the time of our source-file has
-# changed, and set a flag.  Next imcoming request, we check the flag and
-# raise the special exception if set.
-#
-# The end result is that the module is automatically reloaded whenever
-# the source-file changes - you need take no further action to see your
-# changes reflected in the running server.
-
-# The framework only reloads your module - if you have libraries you
-# depend on and also want reloaded, you must arrange for this yourself.
-# One way of doing this would be to special case the import of these
-# modules.  Eg:
-# --
-# try:
-#    my_module = reload(my_module) # module already imported - reload it
-# except NameError:
-#    import my_module # first time around - import it.
-# --
-# When your module is imported for the first time, the NameError will
-# be raised, and the module imported.  When the ISAPI framework reloads
-# your module, the existing module will avoid the NameError, and allow
-# you to reload that module.
-
-import threading
-
-import win32con
-import win32event
-import win32file
-import winerror
-
-from isapi import InternalReloadException
-
-try:
-    reload_counter += 1  # type: ignore[used-before-def]
-except NameError:
-    reload_counter = 0
-
-
-# A watcher thread that checks for __file__ changing.
-# When it detects it, it simply sets "change_detected" to true.
-class ReloadWatcherThread(threading.Thread):
-    def __init__(self):
-        self.change_detected = False
-        self.filename = __file__
-        if self.filename.endswith("c") or self.filename.endswith("o"):
-            self.filename = self.filename[:-1]
-        self.handle = win32file.FindFirstChangeNotification(
-            os.path.dirname(self.filename),
-            False,  # watch tree?
-            win32con.FILE_NOTIFY_CHANGE_LAST_WRITE,
-        )
-        threading.Thread.__init__(self)
-
-    def run(self):
-        last_time = os.stat(self.filename)[stat.ST_MTIME]
-        while 1:
-            try:
-                rc = win32event.WaitForSingleObject(self.handle, win32event.INFINITE)
-                win32file.FindNextChangeNotification(self.handle)
-            except win32event.error as details:
-                # handle closed - thread should terminate.
-                if details.winerror != winerror.ERROR_INVALID_HANDLE:
-                    raise
-                break
-            this_time = os.stat(self.filename)[stat.ST_MTIME]
-            if this_time != last_time:
-                print("Detected file change - flagging for reload.")
-                self.change_detected = True
-                last_time = this_time
-
-    def stop(self):
-        win32file.FindCloseChangeNotification(self.handle)
-
-
-# The ISAPI extension - handles requests in our virtual dir, and sends the
-# response to the client.
-class Extension(SimpleExtension):
-    "Python advanced sample Extension"
-
-    def __init__(self):
-        self.reload_watcher = ReloadWatcherThread()
-        self.reload_watcher.start()
-
-    def HttpExtensionProc(self, ecb):
-        # NOTE: If you use a ThreadPoolExtension, you must still perform
-        # this check in HttpExtensionProc - raising the exception from
-        # The "Dispatch" method will just cause the exception to be
-        # rendered to the browser.
-        if self.reload_watcher.change_detected:
-            print("Doing reload")
-            raise InternalReloadException
-
-        url = ecb.GetServerVariable("UNICODE_URL")
-        if url.endswith("ReportUnhealthy"):
-            ecb.ReportUnhealthy("I'm a little sick")
-
-        ecb.SendResponseHeaders("200 OK", "Content-Type: text/html\r\n\r\n", 0)
-        print("<HTML><BODY>", file=ecb)
-
-        qs = ecb.GetServerVariable("QUERY_STRING")
-        if qs:
-            queries = qs.split("&")
-            print("<PRE>", file=ecb)
-            for q in queries:
-                val = ecb.GetServerVariable(q, "&lt;no such variable&gt;")
-                print(f"{q}={val!r}", file=ecb)
-            print("</PRE><P/>", file=ecb)
-
-        print("This module has been imported", file=ecb)
-        print("%d times" % (reload_counter,), file=ecb)
-        print("</BODY></HTML>", file=ecb)
-        ecb.close()
-        return isapicon.HSE_STATUS_SUCCESS
-
-    def TerminateExtension(self, status):
-        self.reload_watcher.stop()
-
-
-# The entry points for the ISAPI extension.
-def __ExtensionFactory__():
-    return Extension()
-
-
-# Our special command line customization.
-# Pre-install hook for our virtual directory.
-def PreInstallDirectory(params, options):
-    # If the user used our special '--description' option,
-    # then we override our default.
-    if options.description:
-        params.Description = options.description
-
-
-# Post install hook for our entire script
-def PostInstall(params, options):
-    print()
-    print("The sample has been installed.")
-    print("Point your browser to /AdvancedPythonSample")
-    print("If you modify the source file and reload the page,")
-    print("you should see the reload counter increment")
-
-
-# Handler for our custom 'status' argument.
-def status_handler(options, log, arg):
-    "Query the status of something"
-    print("Everything seems to be fine!")
-
-
-custom_arg_handlers = {"status": status_handler}
-
-if __name__ == "__main__":
-    # If run from the command-line, install ourselves.
-    from isapi.install import *
-
-    params = ISAPIParameters(PostInstall=PostInstall)
-    # Setup the virtual directories - this is a list of directories our
-    # extension uses - in this case only 1.
-    # Each extension has a "script map" - this is the mapping of ISAPI
-    # extensions.
-    sm = [ScriptMapParams(Extension="*", Flags=0)]
-    vd = VirtualDirParameters(
-        Name="AdvancedPythonSample",
-        Description=Extension.__doc__,
-        ScriptMaps=sm,
-        ScriptMapUpdate="replace",
-        # specify the pre-install hook.
-        PreInstall=PreInstallDirectory,
-    )
-    params.VirtualDirs = [vd]
-    # Setup our custom option parser.
-    from optparse import OptionParser
-
-    parser = OptionParser("")  # blank usage, so isapi sets it.
-    parser.add_option(
-        "",
-        "--description",
-        action="store",
-        help="custom description to use for the virtual directory",
-    )
-
-    HandleCommandLine(
-        params, opt_parser=parser, custom_arg_handlers=custom_arg_handlers
-    )

py2docfx/venv/venv1/Lib/site-packages/isapi/samples/redirector.py

@@ -1,116 +0,0 @@
-# This is a sample ISAPI extension written in Python.
-#
-# Please see README.txt in this directory, and specifically the
-# information about the "loader" DLL - installing this sample will create
-# "_redirector.dll" in the current directory.  The readme explains this.
-
-# Executing this script (or any server config script) will install the extension
-# into your web server. As the server executes, the PyISAPI framework will load
-# this module and create your Extension and Filter objects.
-
-# This is the simplest possible redirector (or proxy) we can write.  The
-# extension installs with a mask of '*' in the root of the site.
-# As an added bonus though, we optionally show how, on IIS6 and later, we
-# can use HSE_ERQ_EXEC_URL to ignore certain requests - in IIS5 and earlier
-# we can only do this with an ISAPI filter - see redirector_with_filter for
-# an example.  If this sample is run on IIS5 or earlier it simply ignores
-# any excludes.
-
-import sys
-from urllib.request import urlopen
-
-import win32api
-
-from isapi import isapicon, threaded_extension
-
-# sys.isapidllhandle will exist when we are loaded by the IIS framework.
-# In this case we redirect our output to the win32traceutil collector.
-if hasattr(sys, "isapidllhandle"):
-    import win32traceutil
-
-# The site we are proxying.
-proxy = "https://www.python.org"
-
-# Urls we exclude (ie, allow IIS to handle itself) - all are lowered,
-# and these entries exist by default on Vista...
-excludes = ["/iisstart.htm", "/welcome.png"]
-
-
-# An "io completion" function, called when ecb.ExecURL completes...
-def io_callback(ecb, url, cbIO, errcode):
-    # Get the status of our ExecURL
-    httpstatus, substatus, win32 = ecb.GetExecURLStatus()
-    print(
-        "ExecURL of %r finished with http status %d.%d, win32 status %d (%s)"
-        % (url, httpstatus, substatus, win32, win32api.FormatMessage(win32).strip())
-    )
-    # nothing more to do!
-    ecb.DoneWithSession()
-
-
-# The ISAPI extension - handles all requests in the site.
-class Extension(threaded_extension.ThreadPoolExtension):
-    "Python sample Extension"
-
-    def Dispatch(self, ecb):
-        # Note that our ThreadPoolExtension base class will catch exceptions
-        # in our Dispatch method, and write the traceback to the client.
-        # That is perfect for this sample, so we don't catch our own.
-        # print(f'IIS dispatching "{ecb.GetServerVariable("URL")}"')
-        url = ecb.GetServerVariable("URL").decode("ascii")
-        for exclude in excludes:
-            if url.lower().startswith(exclude):
-                print("excluding %s" % url)
-                if ecb.Version < 0x60000:
-                    print("(but this is IIS5 or earlier - can't do 'excludes')")
-                else:
-                    ecb.IOCompletion(io_callback, url)
-                    ecb.ExecURL(
-                        None,
-                        None,
-                        None,
-                        None,
-                        None,
-                        isapicon.HSE_EXEC_URL_IGNORE_CURRENT_INTERCEPTOR,
-                    )
-                    return isapicon.HSE_STATUS_PENDING
-
-        new_url = proxy + url
-        print("Opening %s" % new_url)
-        fp = urlopen(new_url)
-        headers = fp.info()
-        # subtle breakage: str(headers) normalizes \r\n
-        # back to \n and also sticks an extra \n term.
-        # take *all* trailing \n off, replace remaining with
-        # \r\n, then add the 2 trailing \r\n.
-        header_text = str(headers).rstrip("\n").replace("\n", "\r\n") + "\r\n\r\n"
-        ecb.SendResponseHeaders("200 OK", header_text, False)
-        ecb.WriteClient(fp.read())
-        ecb.DoneWithSession()
-        print(f"Returned data from '{new_url}'")
-        return isapicon.HSE_STATUS_SUCCESS
-
-
-# The entry points for the ISAPI extension.
-def __ExtensionFactory__():
-    return Extension()
-
-
-if __name__ == "__main__":
-    # If run from the command-line, install ourselves.
-    from isapi.install import *
-
-    params = ISAPIParameters()
-    # Setup the virtual directories - this is a list of directories our
-    # extension uses - in this case only 1.
-    # Each extension has a "script map" - this is the mapping of ISAPI
-    # extensions.
-    sm = [ScriptMapParams(Extension="*", Flags=0)]
-    vd = VirtualDirParameters(
-        Name="/",
-        Description=Extension.__doc__,
-        ScriptMaps=sm,
-        ScriptMapUpdate="replace",
-    )
-    params.VirtualDirs = [vd]
-    HandleCommandLine(params)

py2docfx/venv/venv1/Lib/site-packages/isapi/samples/redirector_asynch.py

@@ -1,85 +0,0 @@
-# This is a sample ISAPI extension written in Python.
-
-# This is like the other 'redirector' samples, but uses asnch IO when writing
-# back to the client (it does *not* use asynch io talking to the remote
-# server!)
-
-import sys
-import urllib.error
-import urllib.parse
-import urllib.request
-
-from isapi import isapicon, threaded_extension
-
-# sys.isapidllhandle will exist when we are loaded by the IIS framework.
-# In this case we redirect our output to the win32traceutil collector.
-if hasattr(sys, "isapidllhandle"):
-    import win32traceutil
-
-# The site we are proxying.
-proxy = "https://www.python.org"
-
-# We synchronously read chunks of this size then asynchronously write them.
-CHUNK_SIZE = 8192
-
-
-# The callback made when IIS completes the asynch write.
-def io_callback(ecb, fp, cbIO, errcode):
-    print("IO callback", ecb, fp, cbIO, errcode)
-    chunk = fp.read(CHUNK_SIZE)
-    if chunk:
-        ecb.WriteClient(chunk, isapicon.HSE_IO_ASYNC)
-        # and wait for the next callback to say this chunk is done.
-    else:
-        # eof - say we are complete.
-        fp.close()
-        ecb.DoneWithSession()
-
-
-# The ISAPI extension - handles all requests in the site.
-class Extension(threaded_extension.ThreadPoolExtension):
-    "Python sample proxy server - asynch version."
-
-    def Dispatch(self, ecb):
-        print('IIS dispatching "{}"'.format(ecb.GetServerVariable("URL")))
-        url = ecb.GetServerVariable("URL")
-
-        new_url = proxy + url
-        print("Opening %s" % new_url)
-        fp = urllib.request.urlopen(new_url)
-        headers = fp.info()
-        ecb.SendResponseHeaders("200 OK", str(headers) + "\r\n", False)
-        # now send the first chunk asynchronously
-        ecb.ReqIOCompletion(io_callback, fp)
-        chunk = fp.read(CHUNK_SIZE)
-        if chunk:
-            ecb.WriteClient(chunk, isapicon.HSE_IO_ASYNC)
-            return isapicon.HSE_STATUS_PENDING
-        # no data - just close things now.
-        ecb.DoneWithSession()
-        return isapicon.HSE_STATUS_SUCCESS
-
-
-# The entry points for the ISAPI extension.
-def __ExtensionFactory__():
-    return Extension()
-
-
-if __name__ == "__main__":
-    # If run from the command-line, install ourselves.
-    from isapi.install import *
-
-    params = ISAPIParameters()
-    # Setup the virtual directories - this is a list of directories our
-    # extension uses - in this case only 1.
-    # Each extension has a "script map" - this is the mapping of ISAPI
-    # extensions.
-    sm = [ScriptMapParams(Extension="*", Flags=0)]
-    vd = VirtualDirParameters(
-        Name="/",
-        Description=Extension.__doc__,
-        ScriptMaps=sm,
-        ScriptMapUpdate="replace",
-    )
-    params.VirtualDirs = [vd]
-    HandleCommandLine(params)