This file is indexed.

/usr/share/doc/python-cliapp/html/walkthrough.html is in python-cliapp 1.20160109-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
  "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">


<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
    
    <title>2. Walkthrough &mdash; cliapp 1.20160109 documentation</title>
    
    <link rel="stylesheet" href="_static/classic.css" type="text/css" />
    <link rel="stylesheet" href="_static/pygments.css" type="text/css" />
    
    <script type="text/javascript">
      var DOCUMENTATION_OPTIONS = {
        URL_ROOT:    './',
        VERSION:     '1.20160109',
        COLLAPSE_INDEX: false,
        FILE_SUFFIX: '.html',
        HAS_SOURCE:  true
      };
    </script>
    <script type="text/javascript" src="_static/jquery.js"></script>
    <script type="text/javascript" src="_static/underscore.js"></script>
    <script type="text/javascript" src="_static/doctools.js"></script>
    <link rel="top" title="cliapp 1.20160109 documentation" href="index.html" />
    <link rel="next" title="3. Logging" href="logging.html" />
    <link rel="prev" title="1. Example" href="example.html" /> 
  </head>
  <body role="document">
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             accesskey="I">index</a></li>
        <li class="right" >
          <a href="py-modindex.html" title="Python Module Index"
             >modules</a> |</li>
        <li class="right" >
          <a href="logging.html" title="3. Logging"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="example.html" title="1. Example"
             accesskey="P">previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="index.html">cliapp 1.20160109 documentation</a> &raquo;</li> 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body" role="main">
            
  <div class="section" id="walkthrough">
<h1>2. Walkthrough<a class="headerlink" href="#walkthrough" title="Permalink to this headline">ΒΆ</a></h1>
<p>Every application should be a class that subclasses <code class="docutils literal"><span class="pre">cliapp.Application</span></code>.
The subclass should provide specific methods. Read the documentation
for the <code class="docutils literal"><span class="pre">cliapp.Application</span></code> class to see all methods, but a rough
summary is here:</p>
<ul class="simple">
<li>the <code class="docutils literal"><span class="pre">settings</span></code> attribute is the <code class="docutils literal"><span class="pre">cliapp.Settings</span></code> instance used by
the application</li>
<li>override <code class="docutils literal"><span class="pre">add_settings</span></code> to add new settings for the application</li>
<li>override <code class="docutils literal"><span class="pre">process_*</span></code> methods to override various stages in how
arguments and input files are processed</li>
<li>override <code class="docutils literal"><span class="pre">process_args</span></code> to decide how each argument is processed;
by default, this called <code class="docutils literal"><span class="pre">process_inputs</span></code> or handles subcommands</li>
<li><code class="docutils literal"><span class="pre">process_inputs</span></code> calls <code class="docutils literal"><span class="pre">process_input</span></code> (note singular) for each
argument, or on <code class="docutils literal"><span class="pre">-</span></code> to process standard input if no files are named
on the command line</li>
<li><code class="docutils literal"><span class="pre">process_input</span></code> calls <code class="docutils literal"><span class="pre">open_input</span></code> to open each file, then calls
<code class="docutils literal"><span class="pre">process_input_line</span></code> for each input line</li>
<li><code class="docutils literal"><span class="pre">process_input_line</span></code> does nothing, by default</li>
</ul>
<p>This cascade of overrideable methods is started by the <cite>run</cite>
method, which also sets up logging, loads configuration files,
parses the command line, and handles reporting of exceptions.
It can also run the rest of the code under the Python profiler,
if the appropriate environment variable is set.</p>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar" role="navigation" aria-label="main navigation">
        <div class="sphinxsidebarwrapper">
  <h4>Previous topic</h4>
  <p class="topless"><a href="example.html"
                        title="previous chapter">1. Example</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="logging.html"
                        title="next chapter">3. Logging</a></p>
  <div role="note" aria-label="source link">
    <h3>This Page</h3>
    <ul class="this-page-menu">
      <li><a href="_sources/walkthrough.txt"
            rel="nofollow">Show Source</a></li>
    </ul>
   </div>
<div id="searchbox" style="display: none" role="search">
  <h3>Quick search</h3>
    <form class="search" action="search.html" method="get">
      <input type="text" name="q" />
      <input type="submit" value="Go" />
      <input type="hidden" name="check_keywords" value="yes" />
      <input type="hidden" name="area" value="default" />
    </form>
    <p class="searchtip" style="font-size: 90%">
    Enter search terms or a module, class or function name.
    </p>
</div>
<script type="text/javascript">$('#searchbox').show(0);</script>
        </div>
      </div>
      <div class="clearer"></div>
    </div>
    <div class="related" role="navigation" aria-label="related navigation">
      <h3>Navigation</h3>
      <ul>
        <li class="right" style="margin-right: 10px">
          <a href="genindex.html" title="General Index"
             >index</a></li>
        <li class="right" >
          <a href="py-modindex.html" title="Python Module Index"
             >modules</a> |</li>
        <li class="right" >
          <a href="logging.html" title="3. Logging"
             >next</a> |</li>
        <li class="right" >
          <a href="example.html" title="1. Example"
             >previous</a> |</li>
        <li class="nav-item nav-item-0"><a href="index.html">cliapp 1.20160109 documentation</a> &raquo;</li> 
      </ul>
    </div>
    <div class="footer" role="contentinfo">
        &copy; Copyright 2011, Lars Wirzenius.
      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.3.3.
    </div>
  </body>
</html>