src/source/developer_guide/developerguide.rst
branchdoc-dc
changeset 109 31b3d00edb8a
equal deleted inserted replaced
108:1de74ac0628f 109:31b3d00edb8a
       
     1 .. _developerguide:
       
     2 
       
     3 
       
     4 Developer's Guide
       
     5 =================
       
     6 
       
     7 Introduction
       
     8 ++++++++++++
       
     9 
       
    10 Pyams packages are...
       
    11 
       
    12 
       
    13 What is Pyramid?
       
    14 ++++++++++++++++
       
    15 
       
    16 Pyramid is an open source Python web application framework. It is designed to make creating web applications easier.
       
    17 
       
    18 
       
    19 What is Zope?
       
    20 +++++++++++++
       
    21 
       
    22 Zope 2 is a free and open-source, object-oriented web application server written in the Python programming language. The term ZOPE is an acronym for “Z Object Publishing Environment” (the Z doesn’t really mean anything in particular). However, nowadays ZOPE is simply written as Zope. It has three distinct audiences.
       
    23 
       
    24 
       
    25 This guide is intended to document Zope for the second audience, Developers, as defined above. If you fit more into the “user” audience defined above, you’ll probably want to start by reading The Zope Book .
       
    26 
       
    27 Throughout this guide, it is assumed that you know how to program in the Python programming language. Most of the examples in this guide will be in Python. There are a number of great resources and books for learning Python; the best online resource is the python.org web site and many books can be found on the shelves of your local bookstore.
       
    28 1.2. Organization of the book
       
    29 
       
    30 This book describes Zope’s services to the developer from a hands on, example-oriented standpoint. This book is not a complete reference to the Zope API, but rather a practical guide to applying Zope’s services to develop and deploy your own web applications. This book covers the following topics:
       
    31 
       
    32 Components and Interfaces
       
    33     Zope use a component-centric development model. This chapter describes the component model in Zope and how Zope components are described through interfaces.
       
    34 Object Publishing
       
    35     Developing applications for Zope involves more than just creating a component, that component must be publishable on the web. This chapter describes publication, and how your components need to be designed to be published.
       
    36 Zope Products
       
    37     New Zope components are distributed and installed in packages called “Products”. This chapter explains Products in detail.
       
    38 Persistent Components
       
    39     Zope provides a built-in, transparent Python object database called ZODB. This chapter describes how to create persistent components, and how they work in conjunction with the ZODB.
       
    40 Acquisition
       
    41     Zope relies heavily on a dynamic technique called acquisition. This chapter explores acquisition thoroughly.
       
    42 Security
       
    43     When your component is used by many different people through the web, security becomes a big concern. This chapter describes Zope’s security API and how you can use it to make security assertions about your object.
       
    44 Debugging and Testing
       
    45     Zope has built in debugging and testing support. This chapter describes these facilities and how you can debug and test your components.
       
    46 
       
    47 
       
    48 .. toctree::
       
    49    :maxdepth: 2
       
    50 
       
    51    Package directory layout <package_layout>
       
    52    appextend
       
    53    traverser
       
    54    tales