224 lines
		
	
	
		
			8.5 KiB
		
	
	
	
		
			HTML
		
	
	
	
			
		
		
	
	
			224 lines
		
	
	
		
			8.5 KiB
		
	
	
	
		
			HTML
		
	
	
	
| <?xml version="1.0" encoding="ascii"?>
 | |
| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
 | |
|           "DTD/xhtml1-transitional.dtd">
 | |
| <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
 | |
| <head>
 | |
|   <title>googleapiclient.sample_tools</title>
 | |
|   <link rel="stylesheet" href="epydoc.css" type="text/css" />
 | |
|   <script type="text/javascript" src="epydoc.js"></script>
 | |
| </head>
 | |
| 
 | |
| <body bgcolor="white" text="black" link="blue" vlink="#204080"
 | |
|       alink="#204080">
 | |
| <!-- ==================== NAVIGATION BAR ==================== -->
 | |
| <table class="navbar" border="0" width="100%" cellpadding="0"
 | |
|        bgcolor="#a0c0ff" cellspacing="0">
 | |
|   <tr valign="middle">
 | |
|   <!-- Home link -->
 | |
|       <th>   <a
 | |
|         href="googleapiclient-module.html">Home</a>   </th>
 | |
| 
 | |
|   <!-- Tree link -->
 | |
|       <th>   <a
 | |
|         href="module-tree.html">Trees</a>   </th>
 | |
| 
 | |
|   <!-- Index link -->
 | |
|       <th>   <a
 | |
|         href="identifier-index.html">Indices</a>   </th>
 | |
| 
 | |
|   <!-- Help link -->
 | |
|       <th>   <a
 | |
|         href="help.html">Help</a>   </th>
 | |
| 
 | |
|       <th class="navbar" width="100%"></th>
 | |
|   </tr>
 | |
| </table>
 | |
| <table width="100%" cellpadding="0" cellspacing="0">
 | |
|   <tr valign="top">
 | |
|     <td width="100%">
 | |
|       <span class="breadcrumbs">
 | |
|         <a href="googleapiclient-module.html">Package googleapiclient</a> ::
 | |
|         Module sample_tools
 | |
|       </span>
 | |
|     </td>
 | |
|     <td>
 | |
|       <table cellpadding="0" cellspacing="0">
 | |
|         <!-- hide/show private -->
 | |
|         <tr><td align="right"><span class="options">[<a href="javascript:void(0);" class="privatelink"
 | |
|     onclick="toggle_private();">hide private</a>]</span></td></tr>
 | |
|         <tr><td align="right"><span class="options"
 | |
|             >[<a href="frames.html" target="_top">frames</a
 | |
|             >] | <a href="googleapiclient.sample_tools-module.html"
 | |
|             target="_top">no frames</a>]</span></td></tr>
 | |
|       </table>
 | |
|     </td>
 | |
|   </tr>
 | |
| </table>
 | |
| <!-- ==================== MODULE DESCRIPTION ==================== -->
 | |
| <h1 class="epydoc">Module sample_tools</h1><p class="nomargin-top"><span class="codelink"><a href="googleapiclient.sample_tools-pysrc.html">source code</a></span></p>
 | |
| <p>Utilities for making samples.</p>
 | |
|   <p>Consolidates a lot of code commonly repeated in sample 
 | |
|   applications.</p>
 | |
| 
 | |
| <hr />
 | |
| <div class="fields">      <p><strong>Author:</strong>
 | |
|         jcgregorio@google.com (Joe Gregorio)
 | |
|       </p>
 | |
| </div><!-- ==================== FUNCTIONS ==================== -->
 | |
| <a name="section-Functions"></a>
 | |
| <table class="summary" border="1" cellpadding="3"
 | |
|        cellspacing="0" width="100%" bgcolor="white">
 | |
| <tr bgcolor="#70b0f0" class="table-header">
 | |
|   <td colspan="2" class="table-header">
 | |
|     <table border="0" cellpadding="0" cellspacing="0" width="100%">
 | |
|       <tr valign="top">
 | |
|         <td align="left"><span class="table-header">Functions</span></td>
 | |
|         <td align="right" valign="top"
 | |
|          ><span class="options">[<a href="#section-Functions"
 | |
|          class="privatelink" onclick="toggle_private();"
 | |
|          >hide private</a>]</span></td>
 | |
|       </tr>
 | |
|     </table>
 | |
|   </td>
 | |
| </tr>
 | |
| <tr>
 | |
|     <td width="15%" align="right" valign="top" class="summary">
 | |
|       <span class="summary-type"> </span>
 | |
|     </td><td class="summary">
 | |
|       <table width="100%" cellpadding="0" cellspacing="0" border="0">
 | |
|         <tr>
 | |
|           <td><span class="summary-sig"><a href="googleapiclient.sample_tools-module.html#init" class="summary-sig-name">init</a>(<span class="summary-sig-arg">argv</span>,
 | |
|         <span class="summary-sig-arg">name</span>,
 | |
|         <span class="summary-sig-arg">version</span>,
 | |
|         <span class="summary-sig-arg">doc</span>,
 | |
|         <span class="summary-sig-arg">filename</span>,
 | |
|         <span class="summary-sig-arg">scope</span>=<span class="summary-sig-default">None</span>,
 | |
|         <span class="summary-sig-arg">parents</span>=<span class="summary-sig-default">[]</span>,
 | |
|         <span class="summary-sig-arg">discovery_filename</span>=<span class="summary-sig-default">None</span>)</span><br />
 | |
|       A common initialization routine for samples.</td>
 | |
|           <td align="right" valign="top">
 | |
|             <span class="codelink"><a href="googleapiclient.sample_tools-pysrc.html#init">source code</a></span>
 | |
|             
 | |
|           </td>
 | |
|         </tr>
 | |
|       </table>
 | |
|       
 | |
|     </td>
 | |
|   </tr>
 | |
| </table>
 | |
| <!-- ==================== FUNCTION DETAILS ==================== -->
 | |
| <a name="section-FunctionDetails"></a>
 | |
| <table class="details" border="1" cellpadding="3"
 | |
|        cellspacing="0" width="100%" bgcolor="white">
 | |
| <tr bgcolor="#70b0f0" class="table-header">
 | |
|   <td colspan="2" class="table-header">
 | |
|     <table border="0" cellpadding="0" cellspacing="0" width="100%">
 | |
|       <tr valign="top">
 | |
|         <td align="left"><span class="table-header">Function Details</span></td>
 | |
|         <td align="right" valign="top"
 | |
|          ><span class="options">[<a href="#section-FunctionDetails"
 | |
|          class="privatelink" onclick="toggle_private();"
 | |
|          >hide private</a>]</span></td>
 | |
|       </tr>
 | |
|     </table>
 | |
|   </td>
 | |
| </tr>
 | |
| </table>
 | |
| <a name="init"></a>
 | |
| <div>
 | |
| <table class="details" border="1" cellpadding="3"
 | |
|        cellspacing="0" width="100%" bgcolor="white">
 | |
| <tr><td>
 | |
|   <table width="100%" cellpadding="0" cellspacing="0" border="0">
 | |
|   <tr valign="top"><td>
 | |
|   <h3 class="epydoc"><span class="sig"><span class="sig-name">init</span>(<span class="sig-arg">argv</span>,
 | |
|         <span class="sig-arg">name</span>,
 | |
|         <span class="sig-arg">version</span>,
 | |
|         <span class="sig-arg">doc</span>,
 | |
|         <span class="sig-arg">filename</span>,
 | |
|         <span class="sig-arg">scope</span>=<span class="sig-default">None</span>,
 | |
|         <span class="sig-arg">parents</span>=<span class="sig-default">[]</span>,
 | |
|         <span class="sig-arg">discovery_filename</span>=<span class="sig-default">None</span>)</span>
 | |
|   </h3>
 | |
|   </td><td align="right" valign="top"
 | |
|     ><span class="codelink"><a href="googleapiclient.sample_tools-pysrc.html#init">source code</a></span> 
 | |
|     </td>
 | |
|   </tr></table>
 | |
|   
 | |
|   <pre class="literalblock">
 | |
| A common initialization routine for samples.
 | |
| 
 | |
| Many of the sample applications do the same initialization, which has now
 | |
| been consolidated into this function. This function uses common idioms found
 | |
| in almost all the samples, i.e. for an API with name 'apiname', the
 | |
| credentials are stored in a file named apiname.dat, and the
 | |
| client_secrets.json file is stored in the same directory as the application
 | |
| main file.
 | |
| 
 | |
| Args:
 | |
|   argv: list of string, the command-line parameters of the application.
 | |
|   name: string, name of the API.
 | |
|   version: string, version of the API.
 | |
|   doc: string, description of the application. Usually set to __doc__.
 | |
|   file: string, filename of the application. Usually set to __file__.
 | |
|   parents: list of argparse.ArgumentParser, additional command-line flags.
 | |
|   scope: string, The OAuth scope used.
 | |
|   discovery_filename: string, name of local discovery file (JSON). Use when discovery doc not available via URL.
 | |
| 
 | |
| Returns:
 | |
|   A tuple of (service, flags), where service is the service object and flags
 | |
|   is the parsed command-line flags.
 | |
| 
 | |
| </pre>
 | |
|   <dl class="fields">
 | |
|   </dl>
 | |
| </td></tr></table>
 | |
| </div>
 | |
| <br />
 | |
| <!-- ==================== NAVIGATION BAR ==================== -->
 | |
| <table class="navbar" border="0" width="100%" cellpadding="0"
 | |
|        bgcolor="#a0c0ff" cellspacing="0">
 | |
|   <tr valign="middle">
 | |
|   <!-- Home link -->
 | |
|       <th>   <a
 | |
|         href="googleapiclient-module.html">Home</a>   </th>
 | |
| 
 | |
|   <!-- Tree link -->
 | |
|       <th>   <a
 | |
|         href="module-tree.html">Trees</a>   </th>
 | |
| 
 | |
|   <!-- Index link -->
 | |
|       <th>   <a
 | |
|         href="identifier-index.html">Indices</a>   </th>
 | |
| 
 | |
|   <!-- Help link -->
 | |
|       <th>   <a
 | |
|         href="help.html">Help</a>   </th>
 | |
| 
 | |
|       <th class="navbar" width="100%"></th>
 | |
|   </tr>
 | |
| </table>
 | |
| <table border="0" cellpadding="0" cellspacing="0" width="100%%">
 | |
|   <tr>
 | |
|     <td align="left" class="footer">
 | |
|     Generated by Epydoc 3.0.1 on Fri Oct  2 20:46:22 2020
 | |
|     </td>
 | |
|     <td align="right" class="footer">
 | |
|       <a target="mainFrame" href="http://epydoc.sourceforge.net"
 | |
|         >http://epydoc.sourceforge.net</a>
 | |
|     </td>
 | |
|   </tr>
 | |
| </table>
 | |
| 
 | |
| <script type="text/javascript">
 | |
|   <!--
 | |
|   // Private objects are initially displayed (because if
 | |
|   // javascript is turned off then we want them to be
 | |
|   // visible); but by default, we want to hide them.  So hide
 | |
|   // them unless we have a cookie that says to show them.
 | |
|   checkCookie();
 | |
|   // -->
 | |
| </script>
 | |
| </body>
 | |
| </html>
 |