~gary/python-openid/python-openid-2.2.1-patched

« back to all changes in this revision

Viewing changes to doc/openid.oidutil-module.html

  • Committer: Launchpad Patch Queue Manager
  • Date: 2007-11-30 02:46:28 UTC
  • mfrom: (1.1.1 pyopenid-2.0)
  • Revision ID: launchpad@pqm.canonical.com-20071130024628-qktwsew3383iawmq
[rs=SteveA] upgrade to python-openid-2.0.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
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">
 
5
<head>
 
6
  <title>openid.oidutil</title>
 
7
  <link rel="stylesheet" href="epydoc.css" type="text/css"></link>
 
8
</head>
 
9
<body bgcolor="white" text="black" link="blue" vlink="#204080"
 
10
      alink="#204080">
 
11
 
 
12
<!-- =========== START OF NAVBAR =========== -->
 
13
<table class="navbar" border="0" width="100%" cellpadding="0" bgcolor="#a0c0ff" cellspacing="0">
 
14
  <tr valign="center">
 
15
    <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="openid-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
 
16
    <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="trees.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
 
17
    <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="indices.html">Index</a>&nbsp;&nbsp;&nbsp;</th>
 
18
    <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
 
19
    <th class="navbar" align="right" width="100%">
 
20
      <table border="0" cellpadding="0" cellspacing="0">
 
21
      <tr><th class="navbar" align="center">
 
22
        <p class="nomargin">
 
23
          <a class="navbar" target="_top" href="http://www.openidenabled.com/">Python-OpenID</a>
 
24
      </p></th></tr></table>
 
25
    </th>
 
26
  </tr>
 
27
</table>
 
28
<table width="100%" cellpadding="0" cellspacing="0">
 
29
  <tr valign="top">
 
30
    <td width="100%">
 
31
      <font size="-1"><b class="breadcrumbs">
 
32
        <a href="openid-module.html">Package&nbsp;openid</a> ::
 
33
        Module&nbsp;oidutil
 
34
      </b></font></br>
 
35
    </td>
 
36
    <td><table cellpadding="0" cellspacing="0">
 
37
      <tr><td align="right"><font size="-2">[<a href="frames.html"target="_top">frames</a>&nbsp;|&nbsp;<a href="openid.oidutil-module.html" target="_top">no&nbsp;frames</a>]</font></td></tr>
 
38
    </table></td>
 
39
</tr></table>
 
40
 
 
41
<!-- =========== START OF MODULE DESCRIPTION =========== -->
 
42
<h2 class="module">Module openid.oidutil</h2>
 
43
 
 
44
<p>This module contains general utility code that is used throughout the 
 
45
library.</p>
 
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 
 
49
interesting.
 
50
<hr/>
 
51
 
 
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
 
57
</font></td>
 
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>
 
60
<br />
 
61
Append query arguments to a HTTP(s) URL.</td></tr>
 
62
<tr><td align="right" valign="top" width="15%"><font size="-1">&nbsp;</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>
 
64
</td></tr>
 
65
<tr><td align="right" valign="top" width="15%"><font size="-1">&nbsp;</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>
 
68
<br />
 
69
Handle a log message from the OpenID library.</td></tr>
 
70
<tr><td align="right" valign="top" width="15%"><font size="-1">&nbsp;</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>
 
72
<br />
 
73
Represent string s as base64, omitting newlines</td></tr>
 
74
</table><br />
 
75
 
 
76
 
 
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>
 
81
</table>
 
82
 
 
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>
 
87
  </h3>
 
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).
 
92
  <dl><dt></dt><dd>
 
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>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
97
        (type=str)</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 
 
102
        will be preserved.
 
103
        <br /><i>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
104
        (type=A dictionary from string to string, or a sequence of 
 
105
              pairs of strings.)</i>
 
106
      </dd>
 
107
    </dl>
 
108
    <dl><dt><b>Returns:</b></dt>
 
109
      <dd>
 
110
        The URL with the parameters added
 
111
        <br /><i>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
112
        (type=str)</i>
 
113
      </dd>
 
114
    </dl>
 
115
  </dd></dl>
 
116
</td></tr></table>
 
117
 
 
118
<a name="log"></a>
 
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>
 
122
  </h3>
 
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
 
131
 
 
132
 def myLoggingFunction(message, level):
 
133
     ...
 
134
 
 
135
 oidutil.log = myLoggingFunction
 
136
</pre>
 
137
  <dl><dt></dt><dd>
 
138
    <dl><dt><b>Parameters:</b></dt>
 
139
      <dd><code><b>message</b></code> -
 
140
         A string containing a debugging message from the OpenID 
 
141
        library
 
142
        <br /><i>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
143
        (type=str)</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>&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;
 
149
        (type=int or None)</i>
 
150
      </dd>
 
151
    </dl>
 
152
    <dl><dt><b>Returns:</b></dt>
 
153
      <dd>
 
154
        Nothing.
 
155
      </dd>
 
156
    </dl>
 
157
  </dd></dl>
 
158
</td></tr></table>
 
159
 
 
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>
 
163
  </h3>
 
164
  Represent string s as base64, omitting newlines
 
165
  <dl><dt></dt><dd>
 
166
  </dd></dl>
 
167
</td></tr></table>
 
168
<br />
 
169
 
 
170
 
 
171
<!-- =========== START OF NAVBAR =========== -->
 
172
<table class="navbar" border="0" width="100%" cellpadding="0" bgcolor="#a0c0ff" cellspacing="0">
 
173
  <tr valign="center">
 
174
    <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="openid-module.html">Home</a>&nbsp;&nbsp;&nbsp;</th>
 
175
    <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="trees.html">Trees</a>&nbsp;&nbsp;&nbsp;</th>
 
176
    <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="indices.html">Index</a>&nbsp;&nbsp;&nbsp;</th>
 
177
    <th class="navbar">&nbsp;&nbsp;&nbsp;<a class="navbar" href="help.html">Help</a>&nbsp;&nbsp;&nbsp;</th>
 
178
    <th class="navbar" align="right" width="100%">
 
179
      <table border="0" cellpadding="0" cellspacing="0">
 
180
      <tr><th class="navbar" align="center">
 
181
        <p class="nomargin">
 
182
          <a class="navbar" target="_top" href="http://www.openidenabled.com/">Python-OpenID</a>
 
183
      </p></th></tr></table>
 
184
    </th>
 
185
  </tr>
 
186
</table>
 
187
 
 
188
<table border="0" cellpadding="0" cellspacing="0" width="100%">
 
189
  <tr>
 
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>
 
193
  </tr>
 
194
</table>
 
195
</body>
 
196
</html>