summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
authorrfkelly0 <rfkelly0@67cdc799-7952-0410-af00-57a81ceafa0f>2011-03-08 22:20:20 +0000
committerrfkelly0 <rfkelly0@67cdc799-7952-0410-af00-57a81ceafa0f>2011-03-08 22:20:20 +0000
commit2f6887fbf744bfb8b732d2de8eaa6ef73916de7a (patch)
treebd255259b1bba014bba3d26a79e0098592fee1ef /docs
parent4b97c220ff1d1b261b67201ef95875133c158045 (diff)
downloadpyfilesystem-git-2f6887fbf744bfb8b732d2de8eaa6ef73916de7a.tar.gz
spelling fixes
Diffstat (limited to 'docs')
-rw-r--r--docs/concepts.rst6
-rw-r--r--docs/contrib.rst2
-rw-r--r--docs/expose/index.rst2
-rw-r--r--docs/filesystems.rst2
-rw-r--r--docs/getting_started.rst4
-rw-r--r--docs/implementersguide.rst18
-rw-r--r--docs/interface.rst4
-rw-r--r--docs/introduction.rst2
-rw-r--r--docs/opening.rst6
-rw-r--r--docs/spelling_wordlist.txt170
10 files changed, 193 insertions, 23 deletions
diff --git a/docs/concepts.rst b/docs/concepts.rst
index 63bb1d5..e30758d 100644
--- a/docs/concepts.rst
+++ b/docs/concepts.rst
@@ -8,7 +8,7 @@ Sandboxing
FS objects are not permitted to work with any files / directories outside of the Filesystem they represent. If you attempt to open a file or directory outside the root of the FS (e.g. by using "../" in the path) you will get a ``ValueError``.
-There is no concept of a current working directory in PyFilesystem, since it is a common source of bugs and not all filesytems even have such a notion. If you want to work with a sub-directory of a FS object, you can use the :meth:`~fs.base.FS.opendir` method which returns another FS object representing the sub-directory.
+There is no concept of a current working directory in PyFilesystem, since it is a common source of bugs and not all filesystems even have such a notion. If you want to work with a sub-directory of a FS object, you can use the :meth:`~fs.base.FS.opendir` method which returns another FS object representing the sub-directory.
For example, consider the following directory structure. The directory `foo` contains two sub-directories; `bar` and `baz`::
@@ -29,7 +29,7 @@ The `foo_fs` object can work with any of the contents of `bar` and `baz`, which
bar_fs = foo_fs.opendir('bar')
-This creates a completely new FS object that represents everything in the `foo/bar` directory. The root directory of `bar_fs` has been re-position, so that from `bar_fs`'s point of view, the readment.txt and photo.jpg files are in the root::
+This creates a completely new FS object that represents everything in the `foo/bar` directory. The root directory of `bar_fs` has been re-position, so that from `bar_fs`'s point of view, the readme.txt and photo.jpg files are in the root::
--bar
|--readme.txt
@@ -54,7 +54,7 @@ When working with paths in FS objects, keep in mind the following:
* A double dot means 'previous directory'
Note that paths used by the FS interface will use this format, but the constructor or additional methods may not.
-Notably the :mod:`~fs.osfs.OSFS` constructor which requires an OS path -- the format of which can be platform-dependant.
+Notably the :mod:`~fs.osfs.OSFS` constructor which requires an OS path -- the format of which can be platform-dependent.
There are many helpful functions for working with paths in the :mod:`fs.path` module.
diff --git a/docs/contrib.rst b/docs/contrib.rst
index 341c686..34182ee 100644
--- a/docs/contrib.rst
+++ b/docs/contrib.rst
@@ -17,6 +17,6 @@ An interface to Tahoe Least-Authority File System. See :mod:`fs.contrib.tahoela
BIG (BIG Archive File Format)
-----------------------------
-A read-only interface to the BIG archive file format used in some EA games titles (e.g. Command & Conquery 4). See :mod:`fs.contrib.bigfs`
+A read-only interface to the BIG archive file format used in some EA games titles (e.g. Command & Conquer 4). See :mod:`fs.contrib.bigfs`
diff --git a/docs/expose/index.rst b/docs/expose/index.rst
index 6a185e5..0ebc8a1 100644
--- a/docs/expose/index.rst
+++ b/docs/expose/index.rst
@@ -1,7 +1,7 @@
fs.expose
=========
-The ``fs.expose`` module contains a number of options for making an FS implementation available over the internet, or to other applications.
+The ``fs.expose`` module contains a number of options for making an FS implementation available over the Internet, or to other applications.
.. toctree::
:maxdepth: 3
diff --git a/docs/filesystems.rst b/docs/filesystems.rst
index 4b6f147..01effcb 100644
--- a/docs/filesystems.rst
+++ b/docs/filesystems.rst
@@ -50,7 +50,7 @@ Creates a temporary filesystem in an OS provided location. See :mod:`fs.tempfs`
Wrap
----
-A collection of wrappers that add new behaviour / features to existing FS instances. See :mod:`fs.wrapfs`
+A collection of wrappers that add new behavior / features to existing FS instances. See :mod:`fs.wrapfs`
Zip
diff --git a/docs/getting_started.rst b/docs/getting_started.rst
index 443475a..dab09ef 100644
--- a/docs/getting_started.rst
+++ b/docs/getting_started.rst
@@ -32,14 +32,14 @@ Prerequisites
PyFilesystem requires at least **Python 2.5**. There are a few other dependencies if you want to use some of the more advanced filesystem interfaces, but for basic use all that is needed is the Python standard library.
* Boto (required for :mod:`fs.s3fs`) http://code.google.com/p/boto/
- * Paramikio (required for :class:`fs.ftpfs.FTPFS`) http://www.lag.net/paramiko/
+ * Paramiko (required for :class:`fs.ftpfs.FTPFS`) http://www.lag.net/paramiko/
* wxPython (required for :mod:`fs.browsewin`) http://www.wxpython.org/
Quick Examples
--------------
-Before you dive in to the API documentation, here are a few interesting things you can do with pyFilesystem.
+Before you dive in to the API documentation, here are a few interesting things you can do with PyFilesystem.
The following will list all the files in your home directory::
diff --git a/docs/implementersguide.rst b/docs/implementersguide.rst
index 3dc7f6e..ceac3a8 100644
--- a/docs/implementersguide.rst
+++ b/docs/implementersguide.rst
@@ -3,7 +3,7 @@
A Guide For Filesystem Implementers
===================================
-PyFilesystems objects are designed to be as generic as possible and still expose the full filesystem functionality.
+PyFilesystem objects are designed to be as generic as possible and still expose the full filesystem functionality.
With a little care, you can write a wrapper for your filesystem that allows it to work interchangeably with any of the built-in FS classes and tools.
To create a working PyFilesystem interface, derive a class from :py:class:`fs.base.FS` and implement the 9 :ref:`essential-methods`.
@@ -11,7 +11,7 @@ The base class uses these essential methods as a starting point for providing a
but in some cases the default implementation may not be the most efficient.
For example, most filesystems have an atomic way of moving a file from one location to another without having to copy data,
whereas the default implementation of :meth:`~fs.base.FS.move` method must copy all the bytes in the source file to the destination file.
-Any of the :ref:`non-essential-methods` may be overriden, but efficient custom versions of the following methods will have the greatest impact on performance:
+Any of the :ref:`non-essential-methods` may be overridden, but efficient custom versions of the following methods will have the greatest impact on performance:
* :meth:`~fs.base.FS.copy` copy a file
* :meth:`~fs.base.FS.copydir` copy a directory
@@ -37,7 +37,7 @@ but there is nothing preventing you from implementing them -- just be careful to
Filesystem Errors
-----------------
-With the exception of the constuctor, FS methods should throw :class:`fs.errors.FSError` exceptions in preference to any implementation-specific exception classes,
+With the exception of the constructor, FS methods should throw :class:`fs.errors.FSError` exceptions in preference to any implementation-specific exception classes,
so that generic exception handling can be written.
The constructor *may* throw a non-FSError exception, if no appropriate FSError exists.
The rationale for this is that creating an FS interface may require specific knowledge,
@@ -59,7 +59,7 @@ Any code written to catch the generic error, can also retrieve the original exce
Thread Safety
-------------
-All PyFilesystems methods, other than the constructor, should be thread-safe where-ever possible.
+All PyFilesystem methods, other than the constructor, should be thread-safe where-ever possible.
One way to do this is to pass ``threads_synchronize=True`` to the base constructor and use the :func:`~fs.base.synchronize` decorator to lock the FS object when a method is called.
If the implementation can not be made thread-safe for technical reasons, ensure that ``getmeta("thread_safe")`` returns ``False``.
@@ -86,8 +86,8 @@ Essential Methods
The following methods are required for a minimal Filesystem interface:
* :meth:`~fs.base.FS.open` Opens a file for read/writing
- * :meth:`~fs.base.FS.isfile` Check wether the path exists and is a file
- * :meth:`~fs.base.FS.isdir` Check wether a path exists and is a directory
+ * :meth:`~fs.base.FS.isfile` Check whether the path exists and is a file
+ * :meth:`~fs.base.FS.isdir` Check whether a path exists and is a directory
* :meth:`~fs.base.FS.listdir` List the contents of a directory
* :meth:`~fs.base.FS.makedir` Create a new directory
* :meth:`~fs.base.FS.remove` Remove an existing file
@@ -101,11 +101,11 @@ The following methods are required for a minimal Filesystem interface:
Non - Essential Methods
-----------------------
-The following methods have default implementations in :py:class:`fs.base.FS` and aren't required for a functional FS interface. They may be overriden if an alternative implementation can be supplied:
+The following methods have default implementations in :py:class:`fs.base.FS` and aren't required for a functional FS interface. They may be overridden if an alternative implementation can be supplied:
* :meth:`~fs.base.FS.copy` Copy a file to a new location
* :meth:`~fs.base.FS.copydir` Recursively copy a directory to a new location
- * :meth:`~fs.base.FS.desc` Return a short destriptive text regarding a path
+ * :meth:`~fs.base.FS.desc` Return a short descriptive text regarding a path
* :meth:`~fs.base.FS.exists` Check whether a path exists as file or directory
* :meth:`~fs.base.FS.listdirinfo` Get a directory listing along with the info dict for each entry
* :meth:`~fs.base.FS.ilistdir` Generator version of the listdir method
@@ -114,7 +114,7 @@ The following methods have default implementations in :py:class:`fs.base.FS` and
* :meth:`~fs.base.FS.getsyspath` Get a file's name in the local filesystem, if possible
* :meth:`~fs.base.FS.getmeta` Get the value of a filesystem meta value, if it exists
* :meth:`~fs.base.FS.getmmap` Gets an mmap object for the given resource, if supported
- * :meth:`~fs.base.FS.hassyspath` Check if a path maps to a system path (recognised by the OS)
+ * :meth:`~fs.base.FS.hassyspath` Check if a path maps to a system path (recognized by the OS)
* :meth:`~fs.base.FS.haspathurl` Check if a path maps to an external URL
* :meth:`~fs.base.FS.hasmeta` Check if a filesystem meta value exists
* :meth:`~fs.base.FS.move` Move a file to a new location
diff --git a/docs/interface.rst b/docs/interface.rst
index aeb56a1..5ebc4fa 100644
--- a/docs/interface.rst
+++ b/docs/interface.rst
@@ -21,7 +21,7 @@ The following methods are available in all PyFilesystem implementation:
* :meth:`~fs.base.FS.getsyspath` Get a file's name in the local filesystem, if possible
* :meth:`~fs.base.FS.hasmeta` Check if a filesystem meta value exists
* :meth:`~fs.base.FS.haspathurl` Check if a path maps to an external URL
- * :meth:`~fs.base.FS.hassyspath` Check if a path maps to a system path (recognised by the OS)
+ * :meth:`~fs.base.FS.hassyspath` Check if a path maps to a system path (recognized by the OS)
* :meth:`~fs.base.FS.ilistdir` Generator version of the :meth:`~fs.base.FS.listdir` method
* :meth:`~fs.base.FS.ilistdirinfo` Generator version of the :meth:`~fs.base.FS.listdirinfo` method
* :meth:`~fs.base.FS.isdir` Check whether a path exists and is a directory
@@ -49,4 +49,4 @@ The following methods are available in all PyFilesystem implementation:
See :py:class:`fs.base.FS` for the method signature and full details.
-If you intend to implement an FS object, see :ref:`implementers`. \ No newline at end of file
+If you intend to implement an FS object, see :ref:`implementers`.
diff --git a/docs/introduction.rst b/docs/introduction.rst
index 7f1ddd4..cda9575 100644
--- a/docs/introduction.rst
+++ b/docs/introduction.rst
@@ -21,7 +21,7 @@ If you have any problems or questions, please contact the developers through one
Bugs
####
-If you find a bug in PyFilesytem, please file an issue: http://code.google.com/p/pyfilesystem/issues/list
+If you find a bug in PyFilesystem, please file an issue: http://code.google.com/p/pyfilesystem/issues/list
Discussion Group
################
diff --git a/docs/opening.rst b/docs/opening.rst
index 0a0caf6..6ac866b 100644
--- a/docs/opening.rst
+++ b/docs/opening.rst
@@ -1,7 +1,7 @@
Opening Filesystems
===================
-Generally, when you want to work with the files and directories of any of the supported filesytems,
+Generally, when you want to work with the files and directories of any of the supported filesystems,
you create an instance of the appropriate class. For example, the following opens the directory ``/foo/bar``::
from fs.osfs import OSFS
@@ -17,9 +17,9 @@ In these situations you can use an *opener*, which is a generic way of specifyin
The ``fsopendir`` callable takes a string that identifies the filesystem with a URI syntax, but if called with a regular path will return an :class:`~fs.osfs.OSFS` instance.
To open a different kind of filesystem, precede the path with the required protocol.
-For example, the following code opens an FTP filesystem rather than a directory on your harddrive::
+For example, the following code opens an FTP filesystem rather than a directory on your hard-drive::
from fs.opener import fsopendir
my_fs = fsopendir('ftp://example.org/foo/bar')
-For further information regarding filesystem openers see :doc:`opener`. \ No newline at end of file
+For further information regarding filesystem openers see :doc:`opener`.
diff --git a/docs/spelling_wordlist.txt b/docs/spelling_wordlist.txt
index d7287bd..79a3511 100644
--- a/docs/spelling_wordlist.txt
+++ b/docs/spelling_wordlist.txt
@@ -54,3 +54,173 @@ osfs
tempfs
TempFS
mkdtemp
+del
+iter
+WatchableFS
+Mixin
+Filelike
+Filesystems
+utils
+tempfile
+SFTP
+sftp
+paramiko
+hostname
+SFTPClient
+SFTPFS
+AWS
+src
+dst
+filesystem's
+RPCFS
+RPCFSServer
+xmlrpc
+setcontents
+RemoteConnectionError
+ConnectionManagerFS
+CacheFS
+mixin
+CacheFSMixin
+filesystems
+trie
+PathMap
+wildcard
+pathsplit
+ValueError
+abspath
+ftp
+config
+URIs
+builtin
+Indices
+UTF
+sftpfs
+RPC
+rpcfs
+basename
+classmethod
+writeable
+os
+getsyspath
+MultiFS
+multifs
+ResourceNotFoundError
+Unmounts
+MountFS
+mountfs
+StringIO
+memoryfs
+httpfs
+ftpfs
+SpooledTemporaryFile
+truncatable
+filelike
+EOF
+FileLikeBase
+readline
+isatty
+fileno
+docstrings
+Django
+django
+FSStorage
+prepend
+FSImportHook
+uninstalls
+Uninstall
+bytecode
+sourcecode
+automagically
+URLs
+urls
+importhook
+xmlrpclib
+RPFSInterface
+SimpleXmlRPCServer
+Twisted's
+FSError
+BaseSFTPServer
+ThreadingMixin
+SFTPServerInterface
+auth
+transport's
+publickey
+ServerInterface
+MountProcess
+dokan
+FSOperations
+FSOperationsClass
+DOKAN
+bitmask
+unmounts
+fsname
+numthreads
+Popen
+OSError
+autorun
+pickleable
+struct
+SafetyFS
+fusermount
+fds
+nowait
+nothreads
+PyFilesystem
+getmmap
+mmap
+FileWrapper
+py
+pyc
+RPCFSInterface
+SimpleXMLRPCServer
+SocketServer
+TCPServer
+auths
+RequestHandler
+ABI
+ctypes
+IOError
+FileUploadManager
+TahoeLAFS
+api
+tahoelafs
+wxPython
+browsewin
+NullFile
+writeline
+SubFS
+DestinationExistsError
+builtins
+datetime
+bool
+getinfo
+NoSysPathError
+str
+namespaces
+linux
+github
+McGugan
+PyFilesystem's
+OSX
+SVN
+Boto
+Sandboxing
+txt
+mtime
+ascii
+symlink
+namespace
+fsls
+fstree
+fscat
+fsinfo
+fsmv
+fsmount
+fsserver
+fscp
+fsrm
+fsmkdir
+listdirinfo
+override
+overridden
+readme