1
<?xml version="1.0" encoding="iso-8859-1"?>
2
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
3
"DTD/xhtml1-transitional.dtd">
4
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
6
<title>openid.oidutil</title>
7
<link rel="stylesheet" href="epydoc.css" type="text/css"></link>
9
<body bgcolor="white" text="black" link="blue" vlink="#204080"
12
<!-- =========== START OF NAVBAR =========== -->
13
<table class="navbar" border="0" width="100%" cellpadding="0" bgcolor="#a0c0ff" cellspacing="0">
15
<th class="navbar"> <a class="navbar" href="openid-module.html">Home</a> </th>
16
<th class="navbar"> <a class="navbar" href="trees.html">Trees</a> </th>
17
<th class="navbar"> <a class="navbar" href="indices.html">Index</a> </th>
18
<th class="navbar"> <a class="navbar" href="help.html">Help</a> </th>
19
<th class="navbar" align="right" width="100%">
20
<table border="0" cellpadding="0" cellspacing="0">
21
<tr><th class="navbar" align="center">
23
<a class="navbar" target="_top" href="http://www.openidenabled.com/">Python-OpenID</a>
24
</p></th></tr></table>
28
<table width="100%" cellpadding="0" cellspacing="0">
31
<font size="-1"><b class="breadcrumbs">
32
<a href="openid-module.html">Package openid</a> ::
36
<td><table cellpadding="0" cellspacing="0">
37
<tr><td align="right"><font size="-2">[<a href="frames.html"target="_top">frames</a> | <a href="openid.oidutil-module.html" target="_top">no frames</a>]</font></td></tr>
41
<!-- =========== START OF MODULE DESCRIPTION =========== -->
42
<h2 class="module">Module openid.oidutil</h2>
44
<p>This module contains general utility code that is used throughout the
46
For users of this library, the <code><a
47
href="openid.oidutil-module.html#log"
48
class="link"><code>log</code></a></code> function is probably the most
52
<!-- =========== START OF FUNCTION SUMMARY =========== -->
53
<table class="summary" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white">
54
<tr bgcolor="#70b0f0" class="summary">
55
<th colspan="2">Function Summary</th></tr>
56
<tr><td align="right" valign="top" width="15%"><font size="-1"> str
58
<td><code><span class="summary-sig"><a href="openid.oidutil-module.html#appendArgs" class="summary-sig-name"><code>appendArgs</code></a>(<span class=summary-sig-arg>url</span>,
59
<span class=summary-sig-arg>args</span>)</span></code>
61
Append query arguments to a HTTP(s) URL.</td></tr>
62
<tr><td align="right" valign="top" width="15%"><font size="-1"> </font></td>
63
<td><code><a name="fromBase64"></a><span class="summary-sig"><span class="summary-sig-name">fromBase64</span>(<span class=summary-sig-arg>s</span>)</span></code>
65
<tr><td align="right" valign="top" width="15%"><font size="-1"> </font></td>
66
<td><code><span class="summary-sig"><a href="openid.oidutil-module.html#log" class="summary-sig-name"><code>log</code></a>(<span class=summary-sig-arg>message</span>,
67
<span class=summary-sig-arg>level</span>)</span></code>
69
Handle a log message from the OpenID library.</td></tr>
70
<tr><td align="right" valign="top" width="15%"><font size="-1"> </font></td>
71
<td><code><span class="summary-sig"><a href="openid.oidutil-module.html#toBase64" class="summary-sig-name"><code>toBase64</code></a>(<span class=summary-sig-arg>s</span>)</span></code>
73
Represent string s as base64, omitting newlines</td></tr>
77
<!-- =========== START OF FUNCTION DETAILS =========== -->
78
<table class="details" border="1" cellpadding="3" cellspacing="0" width="100%" bgcolor="white">
79
<tr bgcolor="#70b0f0" class="details">
80
<th colspan="2">Function Details</th></tr>
83
<a name="appendArgs"></a>
84
<table width="100%" class="func-details" bgcolor="#e0e0e0"><tr><td>
85
<h3><span class="sig"><span class="sig-name">appendArgs</span>(<span class=sig-arg>url</span>,
86
<span class=sig-arg>args</span>)</span>
88
Append query arguments to a HTTP(s) URL. If the URL already has
89
query arguemtns, these arguments will be added, and the existing
90
arguments will be preserved. Duplicate arguments will not be detected
91
or collapsed (both will appear in the output).
93
<dl><dt><b>Parameters:</b></dt>
94
<dd><code><b>url</b></code> -
95
The url to which the arguments will be appended
96
<br /><i>
98
<dd><code><b>args</b></code> -
99
The query arguments to add to the URL. If a dictionary is
100
passed, the items will be sorted before appending them to the
101
URL. If a sequence of pairs is passed, the order of the sequence
103
<br /><i>
104
(type=A dictionary from string to string, or a sequence of
105
pairs of strings.)</i>
108
<dl><dt><b>Returns:</b></dt>
110
The URL with the parameters added
111
<br /><i>
119
<table width="100%" class="func-details" bgcolor="#e0e0e0"><tr><td>
120
<h3><span class="sig"><span class="sig-name">log</span>(<span class=sig-arg>message</span>,
121
<span class=sig-arg>level</span>=<span class=sig-default>0</span>)</span>
123
<p>Handle a log message from the OpenID library.</p>
124
<p>This implementation writes the string it to <code>sys.stderr</code>,
125
followed by a newline.</p>
126
<p>Currently, the library does not use the second parameter to this
127
function, but that may change in the future.</p>
128
To install your own logging hook:
129
<pre class="literalblock">
130
from openid import oidutil
132
def myLoggingFunction(message, level):
135
oidutil.log = myLoggingFunction
138
<dl><dt><b>Parameters:</b></dt>
139
<dd><code><b>message</b></code> -
140
A string containing a debugging message from the OpenID
142
<br /><i>
144
<dd><code><b>level</b></code> -
145
The severity of the log message. This parameter is currently
146
unused, but in the future, the library may indicate more
147
important information with a higher level value.
148
<br /><i>
149
(type=int or None)</i>
152
<dl><dt><b>Returns:</b></dt>
160
<a name="toBase64"></a>
161
<table width="100%" class="func-details" bgcolor="#e0e0e0"><tr><td>
162
<h3><span class="sig"><span class="sig-name">toBase64</span>(<span class=sig-arg>s</span>)</span>
164
Represent string s as base64, omitting newlines
171
<!-- =========== START OF NAVBAR =========== -->
172
<table class="navbar" border="0" width="100%" cellpadding="0" bgcolor="#a0c0ff" cellspacing="0">
174
<th class="navbar"> <a class="navbar" href="openid-module.html">Home</a> </th>
175
<th class="navbar"> <a class="navbar" href="trees.html">Trees</a> </th>
176
<th class="navbar"> <a class="navbar" href="indices.html">Index</a> </th>
177
<th class="navbar"> <a class="navbar" href="help.html">Help</a> </th>
178
<th class="navbar" align="right" width="100%">
179
<table border="0" cellpadding="0" cellspacing="0">
180
<tr><th class="navbar" align="center">
182
<a class="navbar" target="_top" href="http://www.openidenabled.com/">Python-OpenID</a>
183
</p></th></tr></table>
188
<table border="0" cellpadding="0" cellspacing="0" width="100%">
190
<td align="left"><font size="-2">Generated by Epydoc 2.1 on Mon Sep 10 13:00:12 2007</font></td>
191
<td align="right"><a href="http://epydoc.sourceforge.net"
192
><font size="-2">http://epydoc.sf.net</font></a></td>