Wala shell

Advanced PHP File Manager

Server IP: 127.0.0.1 | PHP Version: 8.3.30 | Domains Hosted: 54

Name	Size	Last Modified
📁 ..	-	2025-06-25 08:19
📁 .github	-	2022-02-02 23:24
📄 .gitignore .egg .egg-info .mo .py[cod] .so .DS_Store .cache/ .coverage .hg .installed.cfg .mr.developer.cfg .project .pydevproject .pytest_cache/ .tags* .tox _httplib2_test_cache/* bin build default.profraw develop-eggs dist eggs lib lib64 nosetests.xml parts pip-log.txt sdist var venv*/	284 B	2022-02-02 23:24
📄 CHANGELOG 0.20.4 proxy: support proxy urls with ipv6 address https://github.com/httplib2/httplib2/pull/217 0.20.3 No changes in library. Tests compatible with Python3.10 and recent pytest. 0.20.2 auth: support pyparsing v3 (AttributeError downcaseTokens) https://github.com/httplib2/httplib2/issues/207 proxy: correct extraction of errno from pysocks ProxyConnectionError https://github.com/httplib2/httplib2/pull/202 0.20.1 No changes from 0.20.0, re-upload of broken py2 wheel. 0.20.0 IMPORTANT cacerts: remove expired DST Root CA X3, add ISRG Root X1, X2 https://github.com/httplib2/httplib2/pull/200 https://github.com/httplib2/httplib2/issues/203 tls: accept min/max ssl.TLSVersion enum values https://github.com/httplib2/httplib2/pull/191 setup(python_requires=...) may need setuptools update https://github.com/httplib2/httplib2/pull/195 0.19.1 auth header parsing performance optimizations; Thanks to Paul McGuire Use mock from the standard library on Python>=3.3 0.19.0 auth: parse headers using pyparsing instead of regexp https://github.com/httplib2/httplib2/pull/182 auth: WSSE token needs to be string not bytes https://github.com/httplib2/httplib2/pull/179 0.18.1 explicit build-backend workaround for pip build isolation bug "AttributeError: 'module' object has no attribute '__legacy__'" on pip install https://github.com/httplib2/httplib2/issues/169 0.18.0 IMPORTANT security vulnerability CWE-93 CRLF injection Force %xx quote of space, CR, LF characters in uri. Special thanks to Recar https://github.com/Ciyfly for discrete notification. https://cwe.mitre.org/data/definitions/93.html 0.17.4 Ship test suite in source dist https://github.com/httplib2/httplib2/pull/168 0.17.3 IronPython2.7: relative import iri2uri fixes ImportError https://github.com/httplib2/httplib2/pull/163 0.17.2 python3 + debug + IPv6 disabled: https raised "IndexError: Replacement index 1 out of range for positional args tuple" https://github.com/httplib2/httplib2/issues/161 0.17.1 python3: no_proxy was not checked with https https://github.com/httplib2/httplib2/issues/160 0.17.0 feature: Http().redirect_codes set, works after follow(_all)_redirects check This allows one line workaround for old gcloud library that uses 308 response without redirect semantics. https://github.com/httplib2/httplib2/issues/156 0.16.0 IMPORTANT cache invalidation change, fix 307 keep method, add 308 Redirects https://github.com/httplib2/httplib2/issues/151 proxy: username/password as str compatible with pysocks https://github.com/httplib2/httplib2/issues/154 0.15.0 python2: regression in connect() error handling https://github.com/httplib2/httplib2/pull/150 add support for password protected certificate files https://github.com/httplib2/httplib2/pull/143 feature: Http.close() to clean persistent connections and sensitive data https://github.com/httplib2/httplib2/pull/149 0.14.0 Python3: PROXY_TYPE_SOCKS5 with str user/pass raised TypeError https://github.com/httplib2/httplib2/pull/145 0.13.1 Python3: Use no_proxy https://github.com/httplib2/httplib2/pull/140 0.13.0 Allow setting TLS max/min versions https://github.com/httplib2/httplib2/pull/138 0.12.3 No changes to library. Distribute py3 wheels. 0.12.1 Catch socket timeouts and clear dead connection https://github.com/httplib2/httplib2/issues/18 https://github.com/httplib2/httplib2/pull/111 Officially support Python 3.7 (package metadata) https://github.com/httplib2/httplib2/issues/123 0.12.0 Drop support for Python 3.3 ca_certs from environment HTTPLIB2_CA_CERTS or certifi https://github.com/httplib2/httplib2/pull/117 PROXY_TYPE_HTTP with non-empty user/pass raised TypeError: bytes required https://github.com/httplib2/httplib2/pull/115 Revert http:443->https workaround https://github.com/httplib2/httplib2/issues/112 eliminate connection pool read race https://github.com/httplib2/httplib2/pull/110 cache: stronger safename https://github.com/httplib2/httplib2/pull/101 0.11.3 No changes, just reupload of 0.11.2 after fixing automatic release conditions in Travis. 0.11.2 proxy: py3 NameError basestring https://github.com/httplib2/httplib2/pull/100 0.11.1 Fix HTTP(S)ConnectionWithTimeout AttributeError proxy_info https://github.com/httplib2/httplib2/pull/97 0.11.0 Add DigiCert Global Root G2 serial 033af1e6a711a9a0bb2864b11d09fae5 https://github.com/httplib2/httplib2/pull/91 python3 proxy support https://github.com/httplib2/httplib2/pull/90 If no_proxy environment value ends with comma then proxy is not used https://github.com/httplib2/httplib2/issues/11 fix UnicodeDecodeError using socks5 proxy https://github.com/httplib2/httplib2/pull/64 Respect NO_PROXY env var in proxy_info_from_url https://github.com/httplib2/httplib2/pull/58 NO_PROXY=bar was matching foobar (suffix without dot delimiter) New behavior matches curl/wget: - no_proxy=foo.bar will only skip proxy for exact hostname match - no_proxy=.wild.card will skip proxy for any.subdomains.wild.card https://github.com/httplib2/httplib2/issues/94 Bugfix for Content-Encoding: deflate https://stackoverflow.com/a/22311297 0.10.3 Fix certificate validation on Python<=2.7.8 without ssl.CertificateError https://github.com/httplib2/httplib2/issues/45 0.10.2 Just a reupload of 0.10.1, which was broken for Python3 because wheel distribution doesn't play well with our 2/3 split code base. https://github.com/httplib2/httplib2/issues/43 0.10.1 This is the first release by new httplib2 team. See post by Joe https://bitworking.org/news/2016/03/an_update_on_httplib2 Remove VeriSign Class 3 CA from trusted certs https://googleonlinesecurity.blogspot.com/2015/12/proactive-measures-in-digital.html Add IdenTrust DST Root CA X3 https://github.com/httplib2/httplib2/pull/26 Support for specifying the SSL protocol version (Python v2) https://github.com/jcgregorio/httplib2/issues/329 On App Engine use urlfetch's default deadline if None is passed. Fix TypeError on AppEngine “__init__() got an unexpected keyword argument 'ssl_version’” https://github.com/httplib2/httplib2/pull/12 Send SNI data for SSL connections on Python 2.7.9+ Verify the server hostname if certificate validation is enabled https://github.com/httplib2/httplib2/pull/13 Add proxy_headers argument to ProxyInfo constructor https://github.com/httplib2/httplib2/pull/21 Make disable_ssl_certificate_validation work with Python 3.5. https://github.com/httplib2/httplib2/pull/15 Fix socket error handling https://github.com/httplib2/httplib2/commit/eb7468561714a5b700d5a3d8fa1a8794de02b9ef https://github.com/httplib2/httplib2/commit/e7f6e622047107e701ee70e7ec586717d97b0cbb 0.9.2 Fixes in this release: https://github.com/jcgregorio/httplib2/pull/313 Fix incorrect ResponseNotReady exceptions, retry on transient errors. 0.9.1 Fixes in this release: https://github.com/jcgregorio/httplib2/pull/296 There was a problem with headers when a binary string is passed (like b'Authorization'). https://github.com/jcgregorio/httplib2/pull/276 Default to doing DNS resolution through a proxy server if present. 0.9 Heartbleed 0.8 More fixes for the App Engine support. Added a new feature that allows you to supply your own provider for the CA_CERTS file. Just create a module named ca_certs_locater that has a method get() that returns the file location of the CA_CERTS file. Lots of clean up of the code formatting to make it more consistent. 0.7.7 More fixes for App Engine, now less likely to swallow important exceptions. Adding proxy_info_from_* methods to Python3. Reviewed in https://codereview.appspot.com/6588078/. Added GeoTrust cert Make httplib2.Http() instances pickleable. Reviewed in https://codereview.appspot.com/6506074/ The following issues have been fixed: 229 python3 httplib2 clobbers multiple headers of same key 230 Expose meaningful exception for App Engine URLFetch ResponseTooLargeError 231 Expose App Engine URLFetch DeadlineExceededError for debugging purposes 0.7.6 Fixes for App Engine 2.7. 0.7.5 Keys are lowercase in a Response object, regardless of how Response object is constructed. Add control so that Authorization: headers aren't forwarded on a 3xx response by default. Set the reason correctly when running on App Engine. Patch from Alain Vongsouvanh. Reviewed in http://codereview.appspot.com/6422051/ Fix proxy socks for SSL connections. Fixes issue #199. You can now set httplib2.RETRIES to the number of retries before a request is considered to fail It is set to a default of 2 to mimic the traditional behavior of httplib2. The following issues have been addressed: 223 HEAD requests fail calling the close() method of ResponseDict instance. 222 Can't disable cert validation in appengine 204 Credentials can leak in HTTP redirects 210 Different API between Python 2 and Python 3 version breaks wsgi_intercept 214 ValueError on malformated cache entries 204 Credentials can leak in HTTP redirects 0.7.3 ProxyInfo objects now can construct themselves from environment variables commonly-used in Unix environments. By default, the Http class will construct a ProxyInfo instance based on these environment variables. To achieve the previous behavior, where environment variables are ignored, pass proxy_info=None to Http(). The following issues have been addressed: Issue 159: automatic detection of proxy configuration. Issue 179: Allow unicode in proxy hostname. Issue 194: Added support for setuptools. Fixes for HTTP CONNECT proxies. 0.7.1 Fix failure to install cacerts.txt for 2.x installs. 0.7.0 The two major changes in this release are SSL Certificate checking and App Engine support. By default the certificates of an HTTPS connection are checked, but that can be disabled via disable_ssl_certificate_validation. The second change is that on App Engine there is a new connection object that utilizes the urlfetch capabilities on App Engine, including setting timeouts and validating certificates. The following issues have been addressed: Fixes issue 72. Always lowercase authorization header. Fix issue 47. Redirects that become a GET should not have a body. Fixes issue 19. Set Content-location on redirected HEAD requests Fixes issue 139. Redirect with a GET on 302 regardless of the originating method. Fixes issue 138. Handle unicode in headers when writing and retrieving cache entries. Who says headers have to be ASCII! Add certificate validation. Work initially started by Christoph Kern. Set a version number. Fixes issue # 135. Sync to latest version of socks.py Add gzip to the user-agent, in case we are making a request to an app engine project: http://code.google.com/appengine/kb/general.html#compression Uses a custom httplib shim on App Engine to wrap urlfetch, as opposed Add default support for optimistic concurrency on PATCH requests Fixes issue 126. IPv6 under various conditions would fail. Fixes issue 131. Handle socket.timeout's that occur during send. proxy support: degrade gracefully when socket.socket is unavailable 0.6.0 The following issues have been addressed: #51 - Failure to handle server legitimately closing connection before request body is fully sent #77 - Duplicated caching test #65 - Transform _normalize_headers into a method of Http class #45 - Vary header #73 - All files in Mercurial are executable #81 - Have a useful .hgignore #78 - Add release tags to the Mercurial repository #67 - HEAD requests cause next request to be retried Mostly bug fixes, the big enhancement is the addition of proper Vary: header handling. Thanks to Chris Dent for that change. The other big change is the build process for distributions so that both python2 and python3 are included in the same .tar.gz/.zip file. 0.5.0 Added Python 3 support Fixed the following bugs: #12 - Cache-Control: only-if-cached incorrectly does request if item not in cache #39 - Deprecation warnings in Python 2.6 #54 - Http.request fails accessing Google account via http proxy #56 - Block on response.read() for HEAD requests. #57 - Timeout ignore for Python 2.6 #58 - Fixed parsing of Cache-Control: header to make it more robust Also fixed a deprecation warning that appeared between Python 3.0 and 3.1. 0.4.0 Added support for proxies if the Socksipy module is installed. Fixed bug with some HEAD responses having content-length set to zero incorrectly. Fixed most except's to catch a specific exception. Added 'connection_type' parameter to Http.request(). The default for 'force_exception_to_status_code' was changed to False. Defaulting to True was causing quite a bit of confusion. 0.3.0 Calling Http.request() with a relative URI, as opposed to an absolute URI, will now throw a specific exception. Http() now has an additional optional parameter for the socket timeout. Exceptions can now be forced into responses. That is, instead of throwing an exception, a good httlib2.Response object is returned that describe the error with an appropriate status code. Many improvements to the file cache: 1. The names in the cache are now much less opaque, which should help with debugging. 2. The disk cache is now Apache mod_asis compatible. 3. A Content-Location: header is supplied and stored in the cache which points to the original requested URI. User supplied If-* headers now override httplib2 supplied versions. IRIs are now fully supported. Note that they MUST be passed in as unicode objects. Http.add_credentials() now takes an optional domain to restrict the credentials to being only used on that domain. Added Http.add_certificate() which allows setting a key and cert for SSL connections. Many other bugs fixed. 0.2.0 Added support for Google Auth. Added experimental support for HMACDigest. Added support for a pluggable caching system. Now supports the old system of using the file system and now memcached. Added httplib2.debuglevel which turns on debugging. Change Response._previous to Response.previous. Added Http.follow_all_redirects which forces httplib2 to follow all redirects, as opposed to following only the safe redirects. This makes the GData protocol easier to use. All known bugs fixed to date. 0.1.1 Fixed several bugs raised by James Antill: 1. HEAD didn't get an Accept: header added like GET. 2. HEAD requests did not use the cache. 3. GET requests with Range: headers would erroneously return a full cached response. 4. Subsequent requests to resources that had timed out would raise an exception. And one feature request for 'method' to default to GET. Xavier Verges Farrero supplied what I needed to make the library work with Python 2.3. I added distutils based setup.py. 0.1 Rev 86 Initial Release	15.07 KB	2022-02-02 23:24
📄 LICENSE Httplib2 Software License Copyright (c) 2006 by Joe Gregorio Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.	1.06 KB	2022-02-02 23:24
📄 MANIFEST.in recursive-include python2 .py .txt recursive-include python3 .py .txt README graft doc graft tests include .md include CHANGELOG include LICENSE include requirements.txt exclude codecov.yml prune ref global-exclude __pycache__ global-exclude *.py[cod]	258 B	2022-02-02 23:24
📄 README.md Introduction ============ httplib2 is a comprehensive HTTP client library, httplib2.py supports many features left out of other HTTP libraries. ### HTTP and HTTPS HTTPS support is only available if the socket module was compiled with SSL support. ### Keep-Alive Supports HTTP 1.1 Keep-Alive, keeping the socket open and performing multiple requests over the same connection if possible. ### Authentication The following three types of HTTP Authentication are supported. These can be used over both HTTP and HTTPS. * Digest * Basic * WSSE ### Caching The module can optionally operate with a private cache that understands the Cache-Control: header and uses both the ETag and Last-Modified cache validators. ### All Methods The module can handle any HTTP request method, not just GET and POST. ### Redirects Automatically follows 3XX redirects on GETs. ### Compression Handles both 'deflate' and 'gzip' types of compression. ### Lost update support Automatically adds back ETags into PUT requests to resources we have already cached. This implements Section 3.2 of Detecting the Lost Update Problem Using Unreserved Checkout. ### Unit Tested A large and growing set of unit tests. Installation ============ $ pip install httplib2 Usage ===== A simple retrieval: ```python import httplib2 h = httplib2.Http(".cache") (resp_headers, content) = h.request("http://example.org/", "GET") ``` The 'content' is the content retrieved from the URL. The content is already decompressed or unzipped if necessary. To PUT some content to a server that uses SSL and Basic authentication: ```python import httplib2 h = httplib2.Http(".cache") h.add_credentials('name', 'password') (resp, content) = h.request("https://example.org/chapter/2", "PUT", body="This is text", headers={'content-type':'text/plain'} ) ``` Use the Cache-Control: header to control how the caching operates. ```python import httplib2 h = httplib2.Http(".cache") (resp, content) = h.request("http://bitworking.org/", "GET") ... (resp, content) = h.request("http://bitworking.org/", "GET", headers={'cache-control':'no-cache'}) ``` The first request will be cached and since this is a request to bitworking.org it will be set to be cached for two hours, because that is how I have my server configured. Any subsequent GET to that URI will return the value from the on-disk cache and no request will be made to the server. You can use the Cache-Control: header to change the caches behavior and in this example the second request adds the Cache-Control: header with a value of 'no-cache' which tells the library that the cached copy must not be used when handling this request. More example usage can be found at: * https://github.com/httplib2/httplib2/wiki/Examples * https://github.com/httplib2/httplib2/wiki/Examples-Python3	2.87 KB	2022-02-02 23:24
📄 SECURITY.md # Security Policy ## Supported Versions master branch and latest release get priority support. You should expect all known problems fixed in master. All other released versions receive security updates per request. If you use some old version and can not upgrade for any or no reason, ask for security update release, most likely you will get it. ## Reporting a Vulnerability Contact current maintainers. At 2020-05: temotor@gmail.com or https://t.me/temotor If that doesn't work, open Github issue just asking for private communication channel. This is volunteer maintained project, all issues are processed on best effort basis, no deadlines promised. Of course, security vulnerabilities get priority over regular issues. You can expect fame in history or maybe you prefer anonymity - say what you prefer. Thank you for responsible handling of security problems. Your attention and effort are appreciated.	916 B	2022-02-02 23:24
📄 codecov.yml comment: layout: "files" require_changes: yes coverage: precision: 0 round: down status: project: default: target: auto threshold: 2%	171 B	2022-02-02 23:24
📄 libhttplib2.tex % Template for a library manual section. % PLEASE REMOVE THE COMMENTS AFTER USING THE TEMPLATE % % Complete documentation on the extended LaTeX markup used for Python % documentation is available in ``Documenting Python'', which is part % of the standard documentation for Python. It may be found online % at: % % http://www.python.org/doc/current/doc/doc.html % ==== 0. ==== % Copy this file to <mydir>/lib<mymodule>.tex, and edit that file % according to the instructions below. % ==== 1. ==== % The section prologue. Give the section a title and provide some % meta-information. References to the module should use % \refbimodindex, \refstmodindex, \refexmodindex or \refmodindex, as % appropriate. \section{\module{httplib2} A comprehensive HTTP client library. } % Choose one of these to specify the module module name. If there's % an underscore in the name, use % \declaremodule[modname]{...}{mod_name} instead. % \declaremodule{}{httplib2} % not standard, in Python % Portability statement: Uncomment and fill in the parameter to specify the % availability of the module. The parameter can be Unix, IRIX, SunOS, Mac, % Windows, or lots of other stuff. When ``Mac'' is specified, the availability % statement will say ``Macintosh'' and the Module Index may say ``Mac''. % Please use a name that has already been used whenever applicable. If this % is omitted, no availability statement is produced or implied. % % \platform{Unix} % These apply to all modules, and may be given more than once: \moduleauthor{Joe Gregorio}{joe@bitworking.org} % Author of the module code; % omit if not known. \sectionauthor{Joe Gregorio}{joe@bitworking.org} % Author of the documentation, % even if not a module section. % Leave at least one blank line after this, to simplify ad-hoc tools % that are sometimes used to massage these files. \modulesynopsis{A comprehensive HTTP client library, \module{httplib2} supports many features left out of other HTTP libraries.} % ==== 2. ==== % Give a short overview of what the module does. % If it is platform specific, mention this. % Mention other important restrictions or general operating principles. % For example: The \module{httplib2} module is a comprehensive HTTP client library with the following features: \begin{description} \item[HTTP and HTTPS] HTTPS support is only available if the socket module was compiled with SSL support. \item[Keep-Alive] Supports HTTP 1.1 Keep-Alive, keeping the socket open and performing multiple requests over the same connection if possible. \item[Authentication] The following three types of HTTP Authentication are supported. These can be used over both HTTP and HTTPS. \begin{itemize} \item Digest \item Basic \item WSSE \end{itemize} \item[Caching] The module can optionally operate with a private cache that understands the Cache-Control: header and uses both the ETag and Last-Modified cache validators. \item[All Methods] The module can handle any HTTP request method, not just GET and POST. \item[Redirects] Automatically follows 3XX redirects on GETs. \item[Compression] Handles both 'deflate' and 'gzip' types of compression. \item[Proxies] If the Socksipy module is installed then httplib2 can handle sock4, sock5 and http proxies. \item[Lost update support] Automatically adds back ETags into PUT requests to resources we have already cached. This implements Section 3.2 of Detecting the Lost Update Problem Using Unreserved Checkout \end{description} % ==== 3. ==== % List the public functions defined by the module. Begin with a % standard phrase. You may also list the exceptions and other data % items defined in the module, insofar as they are important for the % user. The \module{httplib2} module defines the following variables: % ---- 3.2. ---- % Data items are described using a ``datadesc'' block. This has only % one parameter: the item's name. \begin{datadesc}{debuglevel} The amount of debugging information to print. The default is 0. \end{datadesc} \begin{datadesc}{RETRIES} A request will be tried 'RETRIES' times if it fails at the socket/connection level. The default is 2. \end{datadesc} % --- 3.3. --- % Exceptions are described using a ``excdesc'' block. This has only % one parameter: the exception name. Exceptions defined as classes in % the source code should be documented using this environment, but % constructor parameters must be omitted. The \module{httplib2} module may raise the following Exceptions. Note that there is an option that turns exceptions into normal responses with an HTTP status code indicating an error occured. See \member{Http.force_exception_to_status_code} \begin{excdesc}{HttpLib2Error} The Base Exception for all exceptions raised by httplib2. \end{excdesc} \begin{excdesc}{RedirectMissingLocation} A 3xx redirect response code was provided but no Location: header was provided to point to the new location. \end{excdesc} \begin{excdesc}{RedirectLimit} The maximum number of redirections was reached without coming to a final URI. \end{excdesc} \begin{excdesc}{ServerNotFoundError} Unable to resolve the host name given. \end{excdesc} \begin{excdesc}{RelativeURIError} A relative, as opposed to an absolute URI, was passed into request(). \end{excdesc} \begin{excdesc}{FailedToDecompressContent} The headers claimed that the content of the response was compressed but the decompression algorithm applied to the content failed. \end{excdesc} \begin{excdesc}{UnimplementedDigestAuthOptionError} The server requested a type of Digest authentication that we are unfamiliar with. \end{excdesc} \begin{excdesc}{UnimplementedHmacDigestAuthOptionError} The server requested a type of HMACDigest authentication that we are unfamiliar with. \end{excdesc} % ---- 3.4. ---- % Other standard environments: % % classdesc - Python classes; same arguments are funcdesc % methoddesc - methods, like funcdesc but has an optional parameter % to give the type name: \begin{methoddesc}[mytype]{name}{args} % By default, the type name will be the name of the % last class defined using classdesc. The type name % is required if the type is implemented in C (because % there's no classdesc) or if the class isn't directly % documented (if it's private). % memberdesc - data members, like datadesc, but with an optional % type name like methoddesc. \begin{classdesc}{Http}{\optional{cache=None}, \optional{timeout=None}, \optional{proxy_info=None}} The class that represents a client HTTP interface. The \var{cache} parameter is either the name of a directory to be used as a flat file cache, or it must an object that implements the required caching interface. The \var{timeout} parameter is the socket level timeout. The \var{proxy_info} is an instance of \class{ProxyInfo} and is supplied if a proxy is to be used. Note that the Socksipy module must be installed for proxy support to work. \end{classdesc} \begin{classdesc}{Response}{info} Response is a subclass of \class{dict} and instances of this class are returned from calls to Http.request. The \var{info} parameter is either an \class{rfc822.Message} or an \class{httplib.HTTPResponse} object. \end{classdesc} \begin{classdesc}{FileCache}{dir_name, \optional{safe=safename}} FileCache implements a Cache as a directory of files. The \var{dir_name} parameter is the name of the directory to use. If the directory does not exist then FileCache attempts to create the directory. The optional \var{safe} parameter is a funtion which generates the cache filename for each URI. A FileCache object is constructed and used for caching when you pass a directory name into the constructor of \class{Http}. \end{classdesc} \begin{classdesc}{ProxyInfo}{proxy_type, proxy_host, proxy_port, \optional{proxy_rdns=None}, \optional{proxy_user=None}, \optional{proxy_pass=None}} The parameter \var{proxy_type} must be set to one of socks.PROXY_TYPE_XXX constants. The \var{proxy_host} and \var{proxy_port} must be set to the location of the proxy. The optional \var{proxy_rdns} should be set to True if the DNS server on the proxy should be used. The \var{proxy_user} and \var{proxy_pass} are supplied when the proxy is protected by authentication. \end{classdesc} % If your module defines new object types (for a built-in module) or % classes (for a module written in Python), you should list the % methods and instance variables (if any) of each type or class in a % separate subsection. \subsection{Http Objects} \label{http-objects} % This label is generally useful for referencing this section, but is % also used to give a filename when generating HTML. Http objects have the following methods: \begin{methoddesc}[Http]{request}{uri, \optional{method="GET", body=None, headers=None, redirections=DEFAULT_MAX_REDIRECTS, connection_type=None}} Performs a single HTTP request. The \var{uri} is the URI of the HTTP resource and can begin with either \code{http} or \code{https}. The value of \var{uri} must be an absolute URI. The \var{method} is the HTTP method to perform, such as \code{GET}, \code{POST}, \code{DELETE}, etc. There is no restriction on the methods allowed. The \var{body} is the entity body to be sent with the request. It is a string object. Any extra headers that are to be sent with the request should be provided in the \var{headers} dictionary. The maximum number of redirect to follow before raising an exception is \var{redirections}. The default is 5. The \var{connection_type} is the type of connection object to use. The supplied class should implement the interface of httplib.HTTPConnection. The return value is a tuple of (response, content), the first being and instance of the \class{Response} class, the second being a string that contains the response entity body. \end{methoddesc} \begin{methoddesc}[Http]{add_credentials}{name, password, \optional{domain=None}} Adds a name and password that will be used when a request requires authentication. Supplying the optional \var{domain} name will restrict these credentials to only be sent to the specified domain. If \var{domain} is not specified then the given credentials will be used to try to satisfy every HTTP 401 challenge. \end{methoddesc} \begin{methoddesc}[Http]{add_certificate}{key, cert, domain} Add a \var{key} and \var{cert} that will be used for an SSL connection to the specified domain. \var{keyfile} is the name of a PEM formatted file that contains your private key. \var{certfile} is a PEM formatted certificate chain file. \end{methoddesc} \begin{methoddesc}[Http]{clear_credentials}{} Remove all the names and passwords used for authentication. \end{methoddesc} \begin{memberdesc}[Http]{follow_redirects} If \code{True}, which is the default, safe redirects are followed, where safe means that the client is only doing a \code{GET} or \code{HEAD} on the URI to which it is being redirected. If \code{False} then no redirects are followed. Note that a False 'follow_redirects' takes precedence over a True 'follow_all_redirects'. Another way of saying that is for 'follow_all_redirects' to have any affect, 'follow_redirects' must be True. \end{memberdesc} \begin{memberdesc}[Http]{forward_authorization_headers} If \code{False}, which is the default, then Authorization: headers are stripped from redirects. If \code{True} then Authorization: headers are left in place when following redirects. This parameter only applies if following redirects is turned on. Note that turning this on could cause your credentials to leak, so carefully consider the consequences. \end{memberdesc} \begin{memberdesc}[Http]{follow_all_redirects} If \code{False}, which is the default, only safe redirects are followed, where safe means that the client is only doing a \code{GET} or \code{HEAD} on the URI to which it is being redirected. If \code{True} then all redirects are followed. Note that a False 'follow_redirects' takes precedence over a True 'follow_all_redirects'. Another way of saying that is for 'follow_all_redirects' to have any affect, 'follow_redirects' must be True. \end{memberdesc} \begin{memberdesc}[Http]{force_exception_to_status_code} If \code{True}, which is the default, then no \module{httplib2} exceptions will be thrown. Instead, those error conditions will be turned into \class{Response} objects that will be returned normally. If \code{False}, then exceptions will be thrown. \end{memberdesc} \begin{memberdesc}[Http]{ignore_etag} Defaults to \code{False}. If \code{True}, then any etags present in the cached response are ignored when processing the current request, i.e. httplib2 does \strong{not} use 'if-match' for PUT or 'if-none-match' when GET or HEAD requests are made. This is mainly to deal with broken servers which supply an etag, but change it capriciously. \end{memberdesc} \subsection{Cache Objects} \label{cache-objects} % This label is generally useful for referencing this section, but is % also used to give a filename when generating HTML. If you wish to supply your own caching implementation then you will need to pass in an object that supports the following methods. Note that the \module{memcache} module supports this interface natively. \begin{methoddesc}[Cache]{get}{key} Takes a string \var{key} and returns the value as a string. \end{methoddesc} \begin{methoddesc}[Cache]{set}{key, value} Takes a string \var{key} and \var{value} and stores it in the cache. \end{methoddesc} \begin{methoddesc}[Cache]{delete}{key} Deletes the cached value stored at \var{key}. The value of \var{key} is a string. \end{methoddesc} \subsection{Response Objects} \label{response-objects} % This label is generally useful for referencing this section, but is % also used to give a filename when generating HTML. Response objects are derived from \class{dict} and map header names (lower case with the trailing colon removed) to header values. In addition to the dict methods a Response object also has: \begin{memberdesc}[Response]{fromcache} If \code{true} the the response was returned from the cache. \end{memberdesc} \begin{memberdesc}[Response]{version} The version of HTTP that the server supports. A value of 11 means '1.1'. \end{memberdesc} \begin{memberdesc}[Response]{status} The numerical HTTP status code returned in the response. \end{memberdesc} \begin{memberdesc}[Response]{reason} The human readable component of the HTTP response status code. \end{memberdesc} \begin{memberdesc}[Response]{previous} If redirects are followed then the \class{Response} object returned is just for the very last HTTP request and \var{previous} points to the previous \class{Response} object. In this manner they form a chain going back through the responses to the very first response. Will be \code{None} if there are no previous respones. \end{memberdesc} The Response object also populates the header \code{content-location}, that contains the URI that was ultimately requested. This is useful if redirects were encountered, you can determine the ultimate URI that the request was sent to. All Response objects contain this key value, including \code{previous} responses so you can determine the entire chain of redirects. If \member{Http.force_exception_to_status_code} is \code{True} and the number of redirects has exceeded the number of allowed number of redirects then the \class{Response} object will report the error in the status code, but the complete chain of previous responses will still be in tact. % ==== 4. ==== % Now is probably a good time for a complete example. (Alternatively, % an example giving the flavor of the module may be given before the % detailed list of functions.) \subsection{Examples \label{httplib2-example}} To do a simple \code{GET} request just supply the absolute URI of the resource: \begin{verbatim} import httplib2 h = httplib2.Http() resp, content = h.request("http://bitworking.org/") assert resp.status == 200 assert resp['content-type'] == 'text/html' \end{verbatim} Here is more complex example that does a PUT of some text to a resource that requires authentication. The Http instance also uses a file cache in the directory \code{.cache}. \begin{verbatim} import httplib2 h = httplib2.Http(".cache") h.add_credentials('name', 'password') resp, content = h.request("https://example.org/chap/2", "PUT", body="This is text", headers={'content-type':'text/plain'} ) \end{verbatim} Here is an example that connects to a server that supports the Atom Publishing Protocol. \begin{verbatim} import httplib2 h = httplib2.Http() h.add_credentials(myname, mypasswd) h.follow_all_redirects = True headers = {'Content-Type': 'application/atom+xml'} body = """<?xml version="1.0" ?> <entry xmlns="http://www.w3.org/2005/Atom"> <title>Atom-Powered Robots Run Amok</title> <id>urn:uuid:1225c695-cfb8-4ebb-aaaa-80da344efa6a</id> <updated>2003-12-13T18:30:02Z</updated> <author><name>John Doe</name></author> <content>Some text.</content> </entry> """ uri = "http://www.example.com/collection/" resp, content = h.request(uri, "POST", body=body, headers=headers) \end{verbatim} % Note that there is no trailing ">>> " prompt shown. Here is an example of providing data to an HTML form processor. In this case we presume this is a POST form. We need to take our data and format it as "application/x-www-form-urlencoded" data and use that as a body for a POST request. \begin{verbatim} >>> import httplib2 >>> import urllib >>> data = {'name': 'fred', 'address': '123 shady lane'} >>> body = urllib.urlencode(data) >>> body 'name=fred&address=123+shady+lane' >>> h = httplib2.Http() >>> resp, content = h.request("http://example.com", method="POST", body=body) \end{verbatim} % Note that there is no trailing ">>> " prompt shown. Here is an example of using a proxy server: \begin{verbatim} import httplib2 import socks httplib2.debuglevel=4 h = httplib2.Http(proxy_info = httplib2.ProxyInfo(socks.PROXY_TYPE_HTTP, 'localhost', 8000)) r,c = h.request("http://bitworking.org/news/") \end{verbatim}	17.87 KB	2022-02-02 23:24
📄 pyproject.toml [build-system] requires = ["setuptools >= 40.8.0", "wheel"] build-backend = "setuptools.build_meta" [tool.black] line-length = 121 [tool.check-manifest] ignore = [".github/", "script/", "*.tex"]	199 B	2022-02-02 23:24
📁 python2	-	2022-02-02 23:24
📁 python3	-	2022-02-02 23:24
📁 ref	-	2022-02-02 23:24
📄 ref.tex % Complete documentation on the extended LaTeX markup used for Python % documentation is available in ``Documenting Python'', which is part % of the standard documentation for Python. It may be found online % at: % % http://www.python.org/doc/current/doc/doc.html \documentclass{manual} \title{The httplib2 Library} \author{Joe Gregorio} % Please at least include a long-lived email address; % the rest is at your discretion. \authoraddress{ % Organization name, if applicable \\ % Street address, if you want to use it \\ Email: \email{joe@bitworking.org} } \date{Mar 8, 2007} % update before release! \release{0.3} % release version; this is used to define the % \version macro \makeindex % tell \index to actually write the .idx file \makemodindex % If this contains a lot of module sections. \begin{document} \maketitle % This makes the contents more accessible from the front page of the HTML. %\ifhtml %\chapter*{Front Matter\label{front}} %\fi %\input{copyright} \begin{abstract} \noindent The \module{httplib2} module is a comprehensive HTTP client library that handles caching, keep-alive, compression, redirects and many kinds of authentication. \end{abstract} \tableofcontents \chapter{Reference} \input{libhttplib2.tex} %\appendix %\chapter{...} %My appendix. %The \code{\e appendix} markup need not be repeated for additional %appendices. % % The ugly "%begin{latexonly}" pseudo-environments are really just to % keep LaTeX2HTML quiet during the \renewcommand{} macros; they're % not really valuable. % % If you don't want the Module Index, you can remove all of this up % until the second \input line. % %begin{latexonly} \renewcommand{\indexname}{Module Index} %end{latexonly} \input{mod\jobname.ind} % Module Index %begin{latexonly} \renewcommand{\indexname}{Index} %end{latexonly} \input{\jobname.ind} % Index \end{document}	1.9 KB	2022-02-02 23:24
📄 requirements-test.txt cryptography==35.0.0;python_version>="3.6" flake8==3.9.2 future==0.16.0 mock==2.0.0;python_version<"3.3" pytest-cov==2.12.1 pytest-forked==1.3.0 pytest-randomly==1.2.3 pytest-timeout==1.4.2 pytest-xdist==1.34.0 pytest==4.6.11;python_version<="3.4" pytest==6.1.2;python_version>"3.4" and python_version<"3.10" pytest==6.2.5;python_version>="3.10" six==1.10.0	358 B	2022-02-02 23:24
📄 requirements.txt pyparsing>=2.4.2,<3; python_version<'3.0' # TODO remove after dropping Python2 support pyparsing>=2.4.2,<4, !=3.0.0, !=3.0.1, !=3.0.2, !=3.0.3; python_version>'3.0'	165 B	2022-02-02 23:24
📁 script	-	2022-02-02 23:24
📄 setup.cfg # [bdist_wheel] # universal = 1 # FIXME universal wheels don't roll well with our 2/3 split code base # https://github.com/httplib2/httplib2/pull/29 [coverage:run] [flake8] exclude = .egg,.env,.git,.tox,_,build,dist,venv,python2/,python3/ ignore = E261,E731,W503 max-line-length = 121 [tool:pytest] minversion = 3.2 addopts = # --fulltrace # -n auto --cov-config=setup.cfg --cov=httplib2 --ignore=tests/_TODO_legacy/ --noconftest --showlocals --strict-markers --tb=short --timeout=17 --verbose -ra	531 B	2022-02-02 23:24
📄 setup.py import os import setuptools import setuptools.command.test import sys pkgdir = {"": "python%s" % sys.version_info[0]} VERSION = "0.20.4" # `python setup.py test` uses existing Python environment, no virtualenv, no pip. # Use case: Archlinux package. https://github.com/httplib2/httplib2/issues/103 # Otherwise, use `script/test` class TestCommand(setuptools.command.test.test): def run_tests(self): # pytest may be not installed yet import pytest args = ["--forked", "--fulltrace", "--no-cov", "tests/"] if self.test_suite: args += ["-k", self.test_suite] sys.stderr.write("setup.py:test run pytest {}\n".format(" ".join(args))) errno = pytest.main(args) sys.exit(errno) def read_requirements(name): project_root = os.path.dirname(os.path.abspath(__file__)) with open(os.path.join(project_root, name), "rb") as f: # remove whitespace and comments g = (line.decode("utf-8").lstrip().split("#", 1)[0].rstrip() for line in f) return [l for l in g if l] setuptools.setup( name="httplib2", version=VERSION, author="Joe Gregorio", author_email="joe@bitworking.org", url="https://github.com/httplib2/httplib2", description="A comprehensive HTTP client library.", license="MIT", long_description=""" A comprehensive HTTP client library, ``httplib2`` supports many features left out of other HTTP libraries. HTTP and HTTPS HTTPS support is only available if the socket module was compiled with SSL support. Keep-Alive Supports HTTP 1.1 Keep-Alive, keeping the socket open and performing multiple requests over the same connection if possible. Authentication The following three types of HTTP Authentication are supported. These can be used over both HTTP and HTTPS. * Digest * Basic * WSSE Caching The module can optionally operate with a private cache that understands the Cache-Control: header and uses both the ETag and Last-Modified cache validators. Both file system and memcached based caches are supported. All Methods The module can handle any HTTP request method, not just GET and POST. Redirects Automatically follows 3XX redirects on GETs. Compression Handles both 'deflate' and 'gzip' types of compression. Lost update support Automatically adds back ETags into PUT requests to resources we have already cached. This implements Section 3.2 of Detecting the Lost Update Problem Using Unreserved Checkout Unit Tested A large and growing set of unit tests. """, package_dir=pkgdir, packages=["httplib2"], package_data={"httplib2": [".txt"]}, install_requires=read_requirements("requirements.txt"), tests_require=read_requirements("requirements-test.txt"), python_requires=">=2.7, !=3.0., !=3.1., !=3.2., !=3.3.*", cmdclass={"test": TestCommand}, classifiers=[ "Development Status :: 4 - Beta", "Environment :: Web Environment", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Operating System :: OS Independent", "Programming Language :: Python", "Programming Language :: Python :: 2", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Topic :: Internet :: WWW/HTTP", "Topic :: Software Development :: Libraries", ], )	3.64 KB	2022-02-02 23:24

Edit File:

Terminal