Commit f3a9528b authored by Hanno Schlichting's avatar Hanno Schlichting

Simplified instance skeleton, removing old `Extensions`, `import`,...

Simplified instance skeleton, removing old `Extensions`, `import`, `lib/python` and `Products` from the default. You can continue to manually add these back.
parent b426828b
...@@ -31,6 +31,10 @@ Features Added ...@@ -31,6 +31,10 @@ Features Added
Restructuring Restructuring
+++++++++++++ +++++++++++++
- Simplified instance skeleton, removing old `Extensions`, `import`,
`lib/python` and `Products` from the default. You can continue to manually
add these back.
- Removed the rarely used support for the `++skin++` traverser. You can enable - Removed the rarely used support for the `++skin++` traverser. You can enable
it in your own applications by defining:: it in your own applications by defining::
......
...@@ -311,11 +311,7 @@ ...@@ -311,11 +311,7 @@
required="yes"> required="yes">
<description> <description>
The top-level directory which contains the "instance" data for the The top-level directory which contains the "instance" data for the
application server. Typically this is a directory which application server. It may also contain "etc", "bin", "log",
may contain a "Products" subdirectory (which holds instance-local
Zope Products), an "Extensions" subdirectory (which holds instance-local
external methods), and an "import" directory (which holds instance-local
importable ZODB exports). It may also contain "etc", "bin", "log",
and "var" directories depending on how you've configured your Zope and "var" directories depending on how you've configured your Zope
instance. instance.
</description> </description>
...@@ -348,32 +344,26 @@ ...@@ -348,32 +344,26 @@
<multikey name="products" datatype="existing-directory"> <multikey name="products" datatype="existing-directory">
<description> <description>
This specifies additional product directories which are added to This specifies a product directory which is added to Products.__path__.
Products.__path__. Directories are added in the order in which Directories are added in the order in which they are specified.
they are specified.
</description> </description>
<metadefault>$instancehome/Products</metadefault> <metadefault></metadefault>
</multikey> </multikey>
<key name="extensions" datatype="existing-directory"> <key name="extensions" datatype="existing-directory">
<description> <description>
This overrides the path to the Extensions directory. This provides a path to an Extensions directory.
</description> </description>
<metadefault>$instancehome/Extensions</metadefault> <metadefault></metadefault>
</key> </key>
<multikey name="path" datatype="string"> <multikey name="path" datatype="string">
<description> <description>
This specifies additional paths directories which are inserted into This specifies additional paths directories which are inserted into
the beginning of Python's module search path. The set of directories the beginning of Python's module search path.
specified is inserted into the beginning of the module search path in </description>
the order which they are specified here. Note that the processing of <metadefault></metadefault>
this directive may happen too late under some circumstances; it is
recommended that you use the PYTHONPATH environment variable if
using this directive doesn't work for you.
</description>
<metadefault>$instancehome/lib/python</metadefault>
</multikey> </multikey>
<key name="pid-filename" datatype="existing-dirpath"> <key name="pid-filename" datatype="existing-dirpath">
......
Additional products for your Zope instance should be installed in this
directory. A freshly created instance should only contain this
README.txt file and an __init__.py in this directory.
# See http://peak.telecommunity.com/DevCenter/setuptools#namespace-packages
try:
__import__('pkg_resources').declare_namespace(__name__)
except ImportError:
from pkgutil import extend_path
__path__ = extend_path(__path__, __name__)
...@@ -4,6 +4,4 @@ server. It contains the following directories: ...@@ -4,6 +4,4 @@ server. It contains the following directories:
bin/ Scripts used to control the Zope instance bin/ Scripts used to control the Zope instance
etc/ Configuration files etc/ Configuration files
log/ Log files log/ Log files
lib/python/ Installed Python packages specific to the instance
Products/ Installed Zope Products specific to the instance
var/ Run-time data files, including the object database var/ Run-time data files, including the object database
...@@ -50,61 +50,6 @@ instancehome $INSTANCE ...@@ -50,61 +50,6 @@ instancehome $INSTANCE
# clienthome /home/chrism/projects/sessions/var # clienthome /home/chrism/projects/sessions/var
# Directive: path
#
# Description:
# Name of a directory which should be inserted into the
# the beginning of Python's module search path. This directive
# may be specified as many times as needed to insert additional
# directories. The set of directories specified is inserted into the
# beginning of the module search path in the order which they are specified
# here. Note that the processing of this directive may happen too late
# under some circumstances; it is recommended that you use the PYTHONPATH
# environment variable if using this directive doesn't work for you.
#
# Default: $INSTANCE/lib/python
#
# Example:
#
# path $INSTANCE/mypymodules
# Directive: products
#
# Description:
# Name of a directory that contains additional Product packages. This
# directive may be used as many times as needed to add additional
# collections of products. Each directory identified will be
# added to the __path__ of the Products package. All Products are
# initialized in ascending alphabetical order by product name. If
# two products with the same name exist in two Products directories,
# the order in which the packages appear here defines the load
# order. The master Products directory exists in Zope's software home,
# and cannot be removed from the products path (and should not be added
# to it here).
#
# Default: $INSTANCE/Products
#
# Example:
#
# products /home/chrism/projects/myproducts
# Directive: extensions
#
# Description:
# Name of a directory that contains additional "extensions"
# (implementations of ExternalMethods or catalog brains). This
# directive will be searched before the 'Extensions' directory
# of the 'instancehome'.
#
# Default: unset
#
# Example:
#
# extensions /home/chrism/extensions
# Directive: environment # Directive: environment
# #
# Description: # Description:
......
This directory is used by the running Zope process to import objects
into the ZODB. Please place any files that you wish to be able to
import into this directy. For more information, please see The Zope
Book.
This directory will hold any additional Python packages installed into
this Zope instance. Installing Distutils-based packages should be
done using the command:
<<PYTHON>> setup.py install --home <<INSTANCE_HOME>>
This will cause the newly installed Python packages to appear in this
directory.
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