From ff666b57984c53763b4678a10adc5230bd12eaad Mon Sep 17 00:00:00 2001 From: "willmcgugan@gmail.com" Date: Mon, 17 Mar 2014 10:31:24 +0000 Subject: Docs git-svn-id: http://pyfilesystem.googlecode.com/svn/trunk@893 67cdc799-7952-0410-af00-57a81ceafa0f --- docs/commands.rst | 18 ++++++++++-------- docs/getting_started.rst | 12 +++++++++++- docs/introduction.rst | 10 +++++++++- docs/releasenotes.rst | 4 ++-- 4 files changed, 32 insertions(+), 12 deletions(-) diff --git a/docs/commands.rst b/docs/commands.rst index 2b15f20..6ca1e84 100644 --- a/docs/commands.rst +++ b/docs/commands.rst @@ -1,3 +1,5 @@ +.. _commands: + Command Line Applications ========================= @@ -17,8 +19,8 @@ You can also 'point' the command line applications at an opener to add it to a l For example, the following uses a custom opener to list the contents of a directory served with the 'myfs' protocol:: fsls --fs mypackage.mymodule.myfs.MyFSOpener myfs://127.0.0.1 - - + + Listing Supported Filesystems ----------------------------- @@ -32,7 +34,7 @@ fsls Lists the contents of a directory, similar to the ``ls`` command, e.g.:: - fsls + fsls fsls ../ fsls ftp://example.org/pub fsls zip://photos.zip @@ -55,7 +57,7 @@ Writes a file to stdout, e.g:: fscat ~/.bashrc fscat http://www.willmcgugan.com fscat ftp://ftp.mozilla.org/pub/README - + fsinfo ------ @@ -63,7 +65,7 @@ Displays information regarding a file / directory, e.g:: fsinfo C:\autoexec.bat fsinfo ftp://ftp.mozilla.org/pub/README - + fsmv ---- @@ -71,7 +73,7 @@ Moves a file from one location to another, e.g:: fsmv foo bar fsmv *.jpg zip://photos.zip - + fsmkdir ------- @@ -100,11 +102,11 @@ Removes (deletes) a file from a filesystem, e.g:: fsserve ------- -Serves the contents of a filesystem over a network with one of a number of methods; HTTP, RPC or SFTP, e.g:: +Serves the contents of a filesystem over a network with one of a number of methods; HTTP, RPC or SFTP, e.g:: fsserve fsserve --type rpc - fsserve --type http zip://photos.zip + fsserve --type http zip://photos.zip fsmount ------- diff --git a/docs/getting_started.rst b/docs/getting_started.rst index bdc08d0..df2eff3 100644 --- a/docs/getting_started.rst +++ b/docs/getting_started.rst @@ -6,7 +6,7 @@ PyFilesystem is a Python-only module and can be installed from source or with `p Installing ---------- -To install with pip, use the following +To install with pip, use the following:: pip install fs @@ -26,6 +26,16 @@ Whichever method you use, you should now have the `fs` module on your path (vers >>> fs.__version__ '0.5.0' +You should also have the command line applications installed. If you enter the following in the command line, you should see a tree display of the current working directory:: + + fstree -l 2 + +Because the command line utilities use PyFilesystem, they also work with any of the supported filesystems. For example:: + + fstree ftp://ftp.mozilla.org -l 2 + +See :doc:`commands` for more information on the command line applications. + Prerequisites ------------- diff --git a/docs/introduction.rst b/docs/introduction.rst index cda9575..a8c5e86 100644 --- a/docs/introduction.rst +++ b/docs/introduction.rst @@ -10,7 +10,15 @@ Even if you only want to work with the local filesystem, PyFilesystem simplifies About PyFilesystem ------------------ -PyFilesystem was initially created by Will McGugan (http://www.willmcgugan.com) and is now a joint effort with Ryan Kelly (http://www.rfk.id.au/). +PyFilesystem was initially created by Will McGugan and is now a joint effort from the following contributors: + + +- Will McGugan (http://www.willmcgugan.com) +- Ryan Kelly (http://www.rfx.id.au) +- Andrew Scheller +- Ben Timby + +And many others who have contributed bug reports and patches. Need Help? diff --git a/docs/releasenotes.rst b/docs/releasenotes.rst index f4f4514..a7467fb 100644 --- a/docs/releasenotes.rst +++ b/docs/releasenotes.rst @@ -3,7 +3,7 @@ Release Notes PyFilesystem has reached a point where the interface is relatively stable. The were some backwards incompatibilities introduced with version 0.5.0, due to Python 3 support. -Changes from 0.5.0 +Changes from 0.4.0 ------------------ Python 3.X support was added. The interface has remained much the same, but the ``open`` method now works like Python 3's builtin, which handles text encoding more elegantly. i.e. if you open a file in text mode, you get a stream that reads or writes unicode rather than binary strings. @@ -14,7 +14,7 @@ The new signature to the ``open`` method (and ``safeopen``) is as follows:: In order to keep the same signature across both Python 2 and 3, PyFilesystems uses the ``io`` module from the standard library. Unfortunately this is only available from Python 2.6 onwards, so Python 2.5 support has been dropped. If you need Python 2.5 support, consider sticking to PyFilesystem 0.4.0. -By default the new ``open`` method now returns a unicode text stream, whereas 0.4.0 returned a binary file-like object. If you have code that runs on 0.4.0, you will probably want to either modify your code to work with unicode or explicitly open files in binary mode. The later is as simple as changing the mode from "r" to "rb" (or "w" to "wb"), but if you were working with unicode, the new text streams will likely save you a few lines of code. +By default the new ``open`` method now returns a unicode text stream, whereas 0.4.0 returned a binary file-like object. If you have code that runs on 0.4.0, you will probably want to either modify your code to work with unicode or explicitly open files in binary mode. The latter is as simple as changing the mode from "r" to "rb" (or "w" to "wb"), but if you were working with unicode, the new text streams will likely save you a few lines of code. The ``setcontents`` and ``getcontents`` methods have also grown a few parameters in order to work with text files. So you won't require an extra encode / decode step for text files. -- cgit v1.2.1