File: cmdline.html

package info (click to toggle)
python-paver 1.2.1-1~bpo70%2B1
  • links: PTS, VCS
  • area: main
  • in suites: wheezy-backports
  • size: 1,220 kB
  • sloc: python: 4,678; makefile: 20
file content (155 lines) | stat: -rw-r--r-- 6,864 bytes parent folder | download | duplicates (3)
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
143
144
145
146
147
148
149
150
151
152
153
154
155
<!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>Paver Command Line &mdash; Paver 1.2.1 documentation</title>
    
    <link rel="stylesheet" href="_static/default.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.2.1',
        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="Paver 1.2.1 documentation" href="index.html" />
    <link rel="next" title="Tips and Tricks" href="tips.html" />
    <link rel="prev" title="SSH Remote Access Support (paver.ssh)" href="ssh.html" /> 
  </head>
  <body>
    <div class="related">
      <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="tips.html" title="Tips and Tricks"
             accesskey="N">next</a> |</li>
        <li class="right" >
          <a href="ssh.html" title="SSH Remote Access Support (paver.ssh)"
             accesskey="P">previous</a> |</li>
        <li><a href="index.html">Paver 1.2.1 documentation</a> &raquo;</li> 
      </ul>
    </div>  

    <div class="document">
      <div class="documentwrapper">
        <div class="bodywrapper">
          <div class="body">
            
  <div class="section" id="paver-command-line">
<span id="cmdline"></span><h1>Paver Command Line<a class="headerlink" href="#paver-command-line" title="Permalink to this headline">ΒΆ</a></h1>
<p>Paver does sophisticated command line parsing globally and for each task:</p>
<div class="highlight-python"><pre>paver [-q] [-n] [-v] [-f pavement] [-h] [option.name=key] [taskname] [taskoptions] [taskname...]</pre>
</div>
<p>The command line options are:</p>
<table class="docutils option-list" frame="void" rules="none">
<col class="option" />
<col class="description" />
<tbody valign="top">
<tr><td class="option-group">
<kbd><span class="option">-q</span></kbd></td>
<td>quiet... don&#8217;t display much info (info and debug messages are not shown)</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-n</span></kbd></td>
<td>dry run... don&#8217;t actually run destructive commands</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-v</span></kbd></td>
<td>verbose... display debug level output</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-h</span></kbd></td>
<td>display the command line options and list of available tasks. Note
that -h can be provided for any task to display the command line options
and detailed help for that task.</td></tr>
<tr><td class="option-group">
<kbd><span class="option">-f <var>&lt;pavement&gt;</var></span></kbd></td>
<td>use a different file than &#8220;pavement.py&#8221;</td></tr>
</tbody>
</table>
<p>If you run paver without a task, it will only run the &#8220;auto&#8221; task, if there
is one. Otherwise, Paver will do nothing.</p>
<p><tt class="docutils literal"><span class="pre">paver</span> <span class="pre">help</span></tt> is the equivalent of <tt class="docutils literal"><span class="pre">paver</span> <span class="pre">-h</span></tt>, and <tt class="docutils literal"><span class="pre">paver</span> <span class="pre">help</span> <span class="pre">taskname</span></tt>
is the equivalent of <tt class="docutils literal"><span class="pre">paver</span> <span class="pre">taskname</span> <span class="pre">-h</span></tt>.</p>
<p>You can set build options via the command line by providing optionname=value.
The option names can be in dotted notation, so <tt class="docutils literal"><span class="pre">foo.bar.baz=something</span></tt> will
set options[&#8216;foo&#8217;][&#8216;bar&#8217;][&#8216;baz&#8217;] = &#8216;something&#8217; in the options. If you need
to enter a value with multiple words, put quotes around the part with the space.</p>
<p><cite>Important and useful</cite>: Options are set at the point in which they appear in
the command line. That means that you can set an option before one task
and then set it to another value for the next task.</p>
</div>


          </div>
        </div>
      </div>
      <div class="sphinxsidebar">
        <div class="sphinxsidebarwrapper">
  <h4>Previous topic</h4>
  <p class="topless"><a href="ssh.html"
                        title="previous chapter">SSH Remote Access Support (paver.ssh)</a></p>
  <h4>Next topic</h4>
  <p class="topless"><a href="tips.html"
                        title="next chapter">Tips and Tricks</a></p>
  <h3>This Page</h3>
  <ul class="this-page-menu">
    <li><a href="_sources/cmdline.txt"
           rel="nofollow">Show Source</a></li>
  </ul>
<div id="searchbox" style="display: none">
  <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">
      <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="tips.html" title="Tips and Tricks"
             >next</a> |</li>
        <li class="right" >
          <a href="ssh.html" title="SSH Remote Access Support (paver.ssh)"
             >previous</a> |</li>
        <li><a href="index.html">Paver 1.2.1 documentation</a> &raquo;</li> 
      </ul>
    </div>
    <div class="footer">
        &copy; Copyright 2008, SitePen, Inc..
      Last updated on Jun 02, 2013.
      Created using <a href="http://sphinx-doc.org/">Sphinx</a> 1.2b1.
    </div>
  </body>
</html>