Changeset 765

Timestamp:

07/22/07 01:54:21 (1 year ago)

Author:

robin

Message:

--

Files:

• pyrun/trunk/README.nose.txt (deleted)
• pyrun/trunk/examples/command_line_use.rst (modified) (1 diff)
• pyrun/trunk/pyrun.html (modified) (4 diffs)
• pyrun/trunk/pyrun.rst (modified) (1 diff)

pyrun/trunk/examples/command_line_use.rst

@@ -1 +1 @@
-pyrun - command line usage
-~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-pyrun [PYRUN-OPTIONS] [DISCOVERYPATH] [TARGET-OPTIONS]
-
-
-module discovery and implicit selection
-.......................................
-
-If you include an explicit reference to a python source file in the discovery
-path you are acheiving two things:
-
-1. You select it as the `implicit` run target
-2. You `discover` the appropriate path to add to sys.path in order for the
-   identified module to be imported using its *fully* qualified module name.
-
-All modules referenced on the command line like this are considered for path
-discovery. The implicit `pyrun target` is *always* the *first* module
-reference.
-
-To *explicitly* select the module to run, terminate the pyrun arguments with
-``-m fully.qualified.module.name``. Replacing `fully.qualified.module.name`
-with the module you wish to run.
-
-simple examples
-...............
-
-Given::
-
-  ~/foo/__init__.py
-  ~/foo/bar/__init__.py
-  ~/foo/mod.py
-
-
-Implicit selection of a sub module::
-
-  pyrun ~/foo/bar/__init__.py
-             ^              ^
-             |              |
-             |              .
-             |               ------- * module file
-             .
-              -----------------------* `sys.path` entry
-
-  pyrun ~/foo/mod.py
-             ^     ^
-             |     |
-             |     .
-             |      ---------------- * module file
-             .
-              -----------------------* `sys.path` entry
-
-The ``python -m`` form of the above examples would be::
-
-  PYTHONPATH=~/foo python -m foo.bar
-
-  PYTHONPATH=~/foo python -m foo.mod
-
-For examples as simple as this one the only potential advantage of pyrun is the
-convenience of not having to work with `SHELL` environment variables.
-
-Things get more interesting when your `discovery` path includes more elements.
-
-
-
-
+

pyrun/trunk/pyrun.html

@@ -337 +337 @@
-<li><a class="reference" href="#pyrun" id="id1" name="id1">pyrun</a></li>
-<li><a class="reference" href="#installation" id="id2" name="id2">Installation</a></li>
-pyrun-command-line-usage" id="id3" name="id3">pyrun - command line usage</a><ul
+command-line-interface" id="id3" name="id3">Command line interface</a></li
-<li><a class="reference" href="#module-discovery-and-implicit-selection" id="id4" name="id4">module discovery and implicit selection</a></li>
-<li><a class="reference" href="#simple-examples" id="id5" name="id5">simple examples</a></li>
-</ul>
-</li>
-<li><a class="reference" href="#pyrun-module-api" id="id6" name="id6">pyrun - module api</a><ul>
-<li><a class="reference" href="#discover-and-run" id="id7" name="id7">discover_and_run</a></li>
@@ -412 +410 @@
-</div>
-<div class="section">
-
-
-
-
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
-<p>If you include an explicit reference to a python source file in the discovery
-path you are acheiving two things:</p>
@@ -431 +482 @@
-</div>
-<div class="section">
-2><a class="toc-backref" href="#id5" id="simple-examples" name="simple-examples">simple examples</a></h2
+1><a class="toc-backref" href="#id5" id="simple-examples" name="simple-examples">simple examples</a></h1
-<p>Given:</p>
-<pre class="literal-block">
@@ -465 +516 @@
-convenience of not having to work with <cite>SHELL</cite> environment variables.</p>
-<p>Things get more interesting when your <cite>discovery</cite> path includes more elements.</p>
-</div>
-</div>
-<div class="section">

pyrun/trunk/pyrun.rst

@@ -10 +10 @@
-.. include:: INSTALL.txt
-
-
+
+
-.. include:: examples/discover_and_run.rst
-