• to Share - to copy, distribute and transmit the work
• to Remix - to adapt the work

• Attribution. You must attribute the work in the manner specified by the author or licensor (but not in any way that suggests that they endorse you or your use of the work).
• Share Alike. If you alter, transform, or build upon this work, you may distribute the resulting work only under the same, similar or a compatible license.
• For any reuse or distribution, you must make clear to others the license terms of this work. The best way to do this is with a link to this web page.
• Any of the above conditions can be waived if you get permission from the copyright holder.
• Nothing in this license impairs or restricts the author's moral rights.

$ wget -c http://python.org/ftp/python/2.4.4/Python-2.4.4.tar.bz2
$ tar jxvf Python-2.4.4.tar.bz2
$ cd Python-2.4.4
$ ./configure --prefix=/home/baiju/usr
$ make
$ make install

$ ~/usr/bin/python2.4
>>> print "Hello, world!"
Hello, world!

$ mkdir ticketcollector
$ cd ticketcollector
$ echo "#Buildout configuration" > buildout.cfg
$ svn co svn://svn.zope.org/repos/main/zc.buildout/trunk/bootstrap
$ ~/usr/bin/python2.4 bootstrap/bootstrap.py

$ mkdir src
$ mkdir src/ticketcollector
$ echo "#Python package" > src/ticketcollector/__init__.py 

$ ./bin/buildout
$ ./bin/instance fg

$ mkdir explore-zope.component
$ cd explore-zope.component
$ echo "#Buildout configuration" > buildout.cfg
$ svn co svn://svn.zope.org/repos/main/zc.buildout/trunk/bootstrap
$ ~/usr/bin/python2.4 bootstrap/bootstrap.py

[buildout]
parts = py

[py]
recipe = zc.recipe.egg
interpreter = mypython
eggs = zope.component

$ ./bin/buildout
$ ./bin/mypython
>>> import zope.component

$ mkdir hello
$ cd hello
$ echo "#Buildout configuration" > buildout.cfg
$ svn co svn://svn.zope.org/repos/main/zc.buildout/trunk/bootstrap
$ ~/usr/bin/python2.4 bootstrap/bootstrap.py

$ mkdir src
$ mkdir src/hello
$ echo "#Python package" > src/hello/__init__.py 

def say_hello():
    print "Hello"

from setuptools import setup, find_packages

setup(
    name='hello',
    version='0.1',

    packages=find_packages('src'),
    package_dir={'': 'src'},
  
    install_requires=['setuptools',
                      ],
    entry_points = {'console_scripts':
                    ['print_hello = hello.say:say_hello']}, 
    include_package_data=True,
    zip_safe=False,
    )

[buildout]
develop = .
parts = py

[py]
recipe = zc.recipe.egg
scripts = print_hello
eggs = hello

$ ./bin/buildout
$ ./bin/print_hello
Hello

$ mkdir explore-zope.component
$ cd explore-zope.component
$ echo "#Buildout configuration" > buildout.cfg
$ svn co svn://svn.zope.org/repos/main/zc.buildout/trunk/bootstrap
$ ~/usr/bin/python2.4 bootstrap/bootstrap.py

[buildout]
parts = py

[py]
recipe = zc.recipe.egg
eggs = zope.component
interpreter = mypython

$ ./bin/buildout
$ ./bin/mypython
>>> import zope.component

  Interfaces are objects that specify (document) the external behavior
  of objects that "provide" them.  An interface specifies behavior
  through:

  - Informal documentation in a doc string

  - Attribute definitions

  - Invariants, which are conditions that must hold for objects that
    provide the interface

  >>> class Host(object):
  ...
  ...     def goodmorning(self, name):
  ...         """Say good morning to guests"""
  ...
  ...         return "Good morning, %s!" % name

  >>> host = Host()
  >>> host.goodmorning('Jack')
  'Good morning, Jack!'

  >>> from zope.interface import Interface

  >>> class IHost(Interface):
  ...
  ...     def goodmorning(guest):
  ...         """Say good morning to guest"""

  >>> from zope.interface import Interface
  >>> from zope.interface import Attribute

  >>> class IHost(Interface):
  ...     """A host object"""
  ...
  ...     name = Attribute("""Name of host""")
  ...
  ...     def goodmorning(guest):
  ...         """Say good morning to guest"""

  >>> from zope.interface import implements

  >>> class Host(object):
  ...
  ...     implements(IHost)
  ...
  ...     name = u''
  ...
  ...     def goodmorning(self, guest):
  ...         """Say good morning to guest"""
  ...
  ...         return "Good morning, %s!" % guest

  >>> from zope.interface import implements
  >>> from zope.component import adapts

  >>> class FrontDeskNG(object):
  ...
  ...     implements(IDesk)
  ...     adapts(IGuest)
  ...
  ...     def __init__(self, guest):
  ...         self.guest = guest
  ...
  ...     def register(self):
  ...         guest = self.guest
  ...         next_id = get_next_id()
  ...         bookings_db[next_id] = {
  ...         'name': guest.name,
  ...         'place': guest.place,
  ...         'phone': guest.phone
  ...         }

  >>> class Guest(object):
  ...
  ...     implements(IGuest)
  ...
  ...     def __init__(self, name, place):
  ...         self.name = name
  ...         self.place = place

  >>> jack = Guest("Jack", "Bangalore")
  >>> jack_frontdesk = FrontDeskNG(jack)

  >>> IDesk.providedBy(jack_frontdesk)
  True

  >>> from zope.component import getGlobalSiteManager
  >>> gsm = getGlobalSiteManager()
  >>> gsm.registerAdapter(FrontDeskNG,
  ...                     (IGuest,), IDesk, 'ng')

  >>> gsm.registerAdapter(FrontDeskNG, name='ng')

  >>> from zope.component import getAdapter
  >>> from zope.component import queryAdapter

  >>> getAdapter(jack, IDesk, 'ng') #doctest: +ELLIPSIS
  <FrontDeskNG object at ...>
  >>> queryAdapter(jack, IDesk, 'ng') #doctest: +ELLIPSIS
  <FrontDeskNG object at ...>

  >>> getAdapter(jack, IDesk, 'not-exists') #doctest: +ELLIPSIS
  Traceback (most recent call last):
  ...
  ComponentLookupError: ...
  >>> reg = queryAdapter(jack,
  ...           IDesk, 'not-exists') #doctest: +ELLIPSIS
  >>> reg is None
  True

  >>> getAdapter(jack, IDesk) #doctest: +ELLIPSIS
  Traceback (most recent call last):
  ...
  ComponentLookupError: ...
  >>> reg = queryAdapter(jack, IDesk) #doctest: +ELLIPSIS
  >>> reg is None
  True

  >>> IDesk(jack, alternate='default-output')
  'default-output'

  Keyword name can be omitted:

  >>> IDesk(jack, 'default-output')
  'default-output'

  If second argument is not given, it will raise `TypeError`:

  >>> IDesk(jack) #doctest: +NORMALIZE_WHITESPACE +ELLIPSIS
  Traceback (most recent call last):
  ...
  TypeError: ('Could not adapt',
    <Guest object at ...>,
    <InterfaceClass __builtin__.IDesk>)

  Here `FrontDeskNG` is registered without name:

  >>> gsm.registerAdapter(FrontDeskNG)

  Now the adapter lookup should succeed:

  >>> IDesk(jack, 'default-output') #doctest: +ELLIPSIS
  <FrontDeskNG object at ...>

  >>> from zope.interface import Interface
  >>> from zope.interface import implements

  >>> class IGreeter(Interface):
  ...
  ...     def greet(name):
  ...         """Say hello"""

  >>> class Greeter(object):
  ...
  ...     implements(IGreeter)
  ...
  ...     def greet(self, name):
  ...         return "Hello " + name

  >>> from zope.component import getGlobalSiteManager
  >>> gsm = getGlobalSiteManager()

  >>> greet = Greeter()
  >>> gsm.registerUtility(greet, IGreeter)

  >>> from zope.component import queryUtility
  >>> from zope.component import getUtility

  >>> queryUtility(IGreeter).greet('Jack')
  'Hello Jack'

  >>> getUtility(IGreeter).greet('Jack')
  'Hello Jack'

  >>> greet = Greeter()
  >>> gsm.registerUtility(greet, IGreeter, 'new')

  >>> from zope.component import queryUtility
  >>> from zope.component import getUtility

  >>> queryUtility(IGreeter, 'new').greet('Jill')
  'Hello Jill'

  >>> getUtility(IGreeter, 'new').greet('Jill')
  'Hello Jill'

def goodmorning(name):
    "This returns a good morning message"

  >>> import example1

  >>> example1.goodmorning()
  Traceback (most recent call last):
  ...
  TypeError: goodmorning() takes exactly 1 argument (0 given)

  >>> example1.goodmorning('Jack')
  'Good morning, Jack!'

import unittest
import doctest

def test_suite():
    return unittest.TestSuite((
        doctest.DocFileSuite('example1.txt'),
        ))

if __name__ == '__main__':
    unittest.main(defaultTest='test_suite')

File "example1.txt", line 16, in example1.txt
Failed example:
    example1.goodmorning('Jack')
Expected:
    'Good morning, Jack!'
Got nothing

def goodmorning(name):
    "This returns a good morning message"
    return "Good morning, %s!" % name

$ cd ticketcollector
$ ./bin/test

Hello, I am a Zope 3 Resource Component!

<browser:resource
    name="resource.txt"
    file="resource.txt"
    layer="default" />

<browser:resource
    name="img.png"
    image="img.png"
    permission="zope.ManageContent" />

<browser:resourceDirectory
    name="resources"
    directory="../resource" />

    <img src="./images/logo.png" />

    <resource
        name="logo.png"
        file="images/logo.png"
        />

    <!--
      /* zrt-replace: "./images/logo.png" \
                      tal"string:${context/++resource++logo.png}" */
    -->

    <zrt-resource
        name="helloworld.html"
        file="helloworld.html"
        />