Commit ec310a92 authored by jim's avatar jim

Update formatting.


git-svn-id: http://svn.zope.org/repos/main/zc.buildout/trunk@70454 62d5b8a3-27da-0310-9561-8e5933582275
parent cb321ad2
...@@ -12,14 +12,14 @@ zc.buildout.testing.buildoutSetUp(test) ...@@ -12,14 +12,14 @@ zc.buildout.testing.buildoutSetUp(test)
The buildoutSetup function can be used as a doctest setup function. The buildoutSetup function can be used as a doctest setup function.
It performs adds a number of names to the test namespace: It performs adds a number of names to the test namespace:
sample_buildout ``sample_buildout``
This is the name of a buildout with a basic configuration. This is the name of a buildout with a basic configuration.
ls(*path) ``ls(*path)``
List the contents of a directory. The directory path is provided as one or List the contents of a directory. The directory path is provided as one or
more strings, to be joined with os.path.join. more strings, to be joined with os.path.join.
cat(*path) ``cat(*path)``
Display the contents of a file. The file path is provided as one or Display the contents of a file. The file path is provided as one or
more strings, to be joined with os.path.join. more strings, to be joined with os.path.join.
...@@ -27,15 +27,15 @@ cat(*path) ...@@ -27,15 +27,15 @@ cat(*path)
adding a '-script.py' suffix. This helps to work around a adding a '-script.py' suffix. This helps to work around a
difference in script generation on windows. difference in script generation on windows.
mkdir(*path) ``mkdir(*path)``
Create a directory. The directory path is provided as one or Create a directory. The directory path is provided as one or
more strings, to be joined with os.path.join. more strings, to be joined with os.path.join.
rmdir(*path) ``rmdir(*path)``
Remove a directory. The directory path is provided as one or Remove a directory. The directory path is provided as one or
more strings, to be joined with os.path.join. more strings, to be joined with os.path.join.
tmpdir(name) ``tmpdir(name)``
Create a temporary directory with the given name. The directory Create a temporary directory with the given name. The directory
will be automatically removed at the end of the test. The path of will be automatically removed at the end of the test. The path of
the created directory is returned. the created directory is returned.
...@@ -52,49 +52,48 @@ tmpdir(name) ...@@ -52,49 +52,48 @@ tmpdir(name)
Note that the sample_buildout directory is created by calling this Note that the sample_buildout directory is created by calling this
function. function.
write(*path_and_contents) ``write(*path_and_contents)``
Create a file. The file path is provided as one or more strings, Create a file. The file path is provided as one or more strings,
to be joined with os.path.join. The last argument is the file contents. to be joined with os.path.join. The last argument is the file contents.
system(command, input='') ``system(command, input='')``
Execute a system command with the given input passed to the Execute a system command with the given input passed to the
command's standard input. The output (error and regular output) command's standard input. The output (error and regular output)
from the command is returned. from the command is returned.
get(url) ``get(url)``
Get a web page. Get a web page.
cd(*path) ``cd(*path)``
Change to the given directory. The directory path is provided as one or Change to the given directory. The directory path is provided as one or
more strings, to be joined with os.path.join. more strings, to be joined with os.path.join.
The directory will be reset at the end of the test. The directory will be reset at the end of the test.
join(*path) ``join(*path)``
A convenient reference to os.path.join. A convenient reference to os.path.join.
register_teardown(func) ``register_teardown(func)``
Register a tear-down function. The function will be called with Register a tear-down function. The function will be called with
no arguments at the end of the test. no arguments at the end of the test.
start_server(path) ``start_server(path)``
Start a web server on the given path. The server will be shut Start a web server on the given path. The server will be shut
down at the end of the test. The server URL is returned. down at the end of the test. The server URL is returned.
sdist(setup, dest) ``sdist(setup, dest)``
Create a source distribution by running the given setup file and Create a source distribution by running the given setup file and
placing the result in the given destination directory. If the placing the result in the given destination directory. If the
setup argument is a directory, the thge setup.py file in that setup argument is a directory, the thge setup.py file in that
directory is used. directory is used.
bdist_egg(setup, executable, dest) ``bdist_egg(setup, executable, dest)``
Create an egg by running the given setup file with the given Create an egg by running the given setup file with the given
Python executable and placing the result in the given destination Python executable and placing the result in the given destination
directory. If the setup argument is a directory, the thge directory. If the setup argument is a directory, the thge
setup.py file in that directory is used. setup.py file in that directory is used.
find_python(version) ``find_python(version)``
Find a Python executable for the given version, where version is a Find a Python executable for the given version, where version is a
string like "2.4". string like "2.4".
...@@ -108,14 +107,14 @@ find_python(version) ...@@ -108,14 +107,14 @@ find_python(version)
- on Unix, try running python%(version)s or just python to get the - on Unix, try running python%(version)s or just python to get the
executable executable
zc.buildout.testing.buildoutTearDown(test) ``zc.buildout.testing.buildoutTearDown(test)``
------------------------------------------ ----------------------------------------------
Tear down everything set up by zc.buildout.testing.buildoutSetUp. Any Tear down everything set up by zc.buildout.testing.buildoutSetUp. Any
functions passed to register_teardown are called as well. functions passed to register_teardown are called as well.
install(project, destination) ``install(project, destination)``
----------------------------- ---------------------------------
Install eggs for a given project into a destination. If the Install eggs for a given project into a destination. If the
destination is a test object, then the eggs directory of the destination is a test object, then the eggs directory of the
...@@ -125,14 +124,14 @@ being tested (and their dependencies) into a sample buildout. The egg ...@@ -125,14 +124,14 @@ being tested (and their dependencies) into a sample buildout. The egg
to be used should already be loaded, by importing one of the modules to be used should already be loaded, by importing one of the modules
provided, before calling this function. provided, before calling this function.
install_develop(project, destination) ``install_develop(project, destination)``
------------------------------------- -----------------------------------------
Like install, but a develop egg is installed even if the current egg Like install, but a develop egg is installed even if the current egg
if not a develop egg. if not a develop egg.
Output normalization ``Output normalization``
-------------------- ------------------------
Recipe tests often generate output that is dependent on temporary file Recipe tests often generate output that is dependent on temporary file
locations, operating system conventions or Python versions. To deal locations, operating system conventions or Python versions. To deal
...@@ -144,17 +143,17 @@ a few helpful variables that define regular-expression/substitution ...@@ -144,17 +143,17 @@ a few helpful variables that define regular-expression/substitution
pairs that you can pass to zope.testing.renormalizing.RENormalizing. pairs that you can pass to zope.testing.renormalizing.RENormalizing.
normalize_path ``normalize_path``
Converts tests paths, based on directories created with tmpdir(), Converts tests paths, based on directories created with tmpdir(),
to simple paths. to simple paths.
normalize_script ``normalize_script``
On Unix-like systems, scripts are implemented in single files On Unix-like systems, scripts are implemented in single files
without suffixes. On windows, scripts are implemented with 2 without suffixes. On windows, scripts are implemented with 2
files, a -script.py file and a .exe file. This normalization files, a -script.py file and a .exe file. This normalization
converts directory listings of Windows scripts to the form converts directory listings of Windows scripts to the form
generated on UNix-like systems. generated on UNix-like systems.
normalize_egg_py ``normalize_egg_py``
Normalize Python version and platform indicators, if specified, in Normalize Python version and platform indicators, if specified, in
egg names. egg names.
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment