From d53e3b3b67e76eecf6bec2b347f0e7fc81102465 Mon Sep 17 00:00:00 2001 From: hpk Date: Thu, 2 Apr 2009 13:16:41 +0200 Subject: [PATCH] [svn r63529] remove idea here for a new "fs" namespace. 1.0.0 release announce draft some fixes and streamlines here and there. --HG-- branch : trunk --- py/doc/conf.py | 2 +- py/doc/draft_pyfs | 79 ---------------------------------------- py/doc/path.txt | 1 - py/doc/release-1.0.0.txt | 35 +++++++----------- py/doc/test.txt | 10 ++--- 5 files changed, 19 insertions(+), 108 deletions(-) delete mode 100644 py/doc/draft_pyfs diff --git a/py/doc/conf.py b/py/doc/conf.py index 85bd350c3..f39b3a343 100644 --- a/py/doc/conf.py +++ b/py/doc/conf.py @@ -92,7 +92,7 @@ pygments_style = 'sphinx' # The theme to use for HTML and HTML Help pages. Major themes that come with # Sphinx are currently 'default' and 'sphinxdoc'. -html_theme = 'default' +html_theme = 'basic' # Theme options are theme-specific and customize the look and feel of a theme # further. For a list of options available for each theme, see the diff --git a/py/doc/draft_pyfs b/py/doc/draft_pyfs deleted file mode 100644 index 68d6944fe..000000000 --- a/py/doc/draft_pyfs +++ /dev/null @@ -1,79 +0,0 @@ - -Let's do a walk through a memory filesystem. - -.. >>> import py - - -working with directories ---------------------------------- - -Let's create some directories and list them from memory:: - ->>> fs = py.fs.MemoryFS() ->>> fs.mkdir("x") ->>> fs.mkdir("y") ->>> fs.listdir() -['x', 'y'] - - -Creating, removing and reading files ---------------------------------------------- - ->>> f = fs.open('x/file', 'w') ->>> f.write("hello world") ->>> f.close() ->>> fs.listdir("x") -['file'] ->>> f = fs.open("x/file", 'r') ->>> f.readlines() -['hello world'] ->>> f.seek(6) ->>> f.read(3) -"wor" ->>> f.read() -"ld" ->>> f.close() ->>> fs.remove("y") ->>> fs.listdir() -['x'] ->>> fs.remove("non-existent") -py.error.ENOENT - -stat / checking for meta information ---------------------------------------- - ->>> stat = memory.stat("x") ->>> stat.isdir() -True ->>> stat.isfile() -False ->>> stat.exists() -True ->>> stat.islink() -False - -Linking to other objects --------------------------------------------------------- - -First an example how to link internally, i.e. within the -filesystem. - ->>> fs.link("newitem", "x") ->>> fs.stat("newitem").islink() -True ->>> fs.stat("newitem").isfile() -True ->>> fs.remove("newitem") # only deletes the link itself ->>> fs.stat("x").exists() - -cross-filesystem references ---------------------------------- - ->>> otherfs = py.fs.MemoryFS() - -XXX - ->>> fs.setproxy("newitem", otherfs, "otheritem") ->>> fs.stat("newitem").exists() -False ->>> otherfs.mkdir("otheritem") diff --git a/py/doc/path.txt b/py/doc/path.txt index 24ed960de..972dbe7e6 100644 --- a/py/doc/path.txt +++ b/py/doc/path.txt @@ -2,7 +2,6 @@ py.path ======= - The 'py' lib provides a uniform high-level api to deal with filesystems and filesystem-like interfaces: :api:`py.path`. It aims to offer a central object to fs-like object trees (reading from and writing to files, adding diff --git a/py/doc/release-1.0.0.txt b/py/doc/release-1.0.0.txt index 8498cc4db..3b9380e5f 100644 --- a/py/doc/release-1.0.0.txt +++ b/py/doc/release-1.0.0.txt @@ -1,31 +1,24 @@ -py lib 0.9.0: py.test, distributed execution, greenlets and more -====================================================================== +py lib 1.0.0: distributed testing and dynamic code deployment +=============================================================== -Welcome to the 0.9.0 py lib release - a library aiming to -support agile and test-driven python development on various levels. +XXX draft + +Welcome to the 1.0.0 py lib release - a python library aiming +to support agile and test-driven development. + +It passes tests against Linux, OSX and Win32, on Python +2.3, 2.4, 2.5 and 2.6. Main API/Tool Features: * py.test: cross-project testing tool with many advanced features * py.execnet: ad-hoc code distribution to SSH, Socket and local sub processes -* py.magic.greenlet: micro-threads on standard CPython ("stackless-light") +* py.code: support for dynamically running and debugging python code * py.path: path abstractions over local and subversion files -* rich documentation of py's exported API -* tested against Linux, OSX and partly against Win32, python 2.3-2.5 -All these features and their API have extensive documentation, -generated with the new "apigen", which we intend to make accessible -for other python projects as well. +Download/Install: http://codespeak.net/py/1.0.0/download.html +Documentation/API: http://codespeak.net/py/1.0.0/index.html -Download/Install: http://codespeak.net/py/0.9.0/download.html -Documentation/API: http://codespeak.net/py/0.9.0/index.html - -Work on the py lib has been partially funded by the -European Union IST programme and by http://merlinux.de -within the PyPy project. - -best, have fun and let us know what you think! - -holger krekel, Maciej Fijalkowski, -Guido Wesdorp, Carl Friedrich Bolz +best, +holger diff --git a/py/doc/test.txt b/py/doc/test.txt index 3ff64a7e3..df6c4f5f9 100644 --- a/py/doc/test.txt +++ b/py/doc/test.txt @@ -2,12 +2,10 @@ py.test ======= -*py.test* is a tool for: - -* rapidly writing unit- and functional tests in Python -* writing tests for non-python code and data -* receiving useful reports on test failures -* distributing tests to multiple CPUs and remote environments +* rapidly collect and run tests +* use unit- or doctests, functional or integration tests +* distribute tests to multiple environments +* local or global plugins for custom test types quickstart_: for getting started immediately.