{
"info": {
"author": "Roger Ineichen and the Zope Community",
"author_email": "zope-dev@zope.org",
"bugtrack_url": null,
"classifiers": [
"Development Status :: 4 - Beta",
"Environment :: Web Environment",
"Framework :: Zope3",
"Intended Audience :: Developers",
"License :: OSI Approved :: Zope Public License",
"Natural Language :: English",
"Operating System :: Microsoft :: Windows",
"Programming Language :: Python",
"Topic :: Internet :: WWW/HTTP"
],
"description": "The ``z3c.recipe.paster:serve`` generates a paste deploy serve scripts and \nconfiguration files for starting a paste deploy based Zope 3 setup. The \npaste deploy ``*.ini`` file content can get defined in the buildout.cfg file.\n\nNote, you have to define an entry_point in your projects setup.py file for\nusing a application_factory via the section name.\n\n\nDetailed Documentation\n**********************\n\n\n=======================\nz3c.recipe.paster:serve\n=======================\n\nThis Zope 3 recipes offers a Paste Deploy setup for Zope3 projects. It requires\nto define a Paste Deploy *.ini file in the buoldout.cfg. If you need a simple\nPasteScript setup you can use the z3c.recipe.paster:paster recipe which allows\nto run already existing ``*.ini`` files.\n\n\nOptions\n-------\n\nThe 'serve' recipe accepts the following options:\n\neggs\n The names of one or more eggs, with their dependencies that should\n be included in the Python path of the generated scripts.\n\nini\n The paste deploy ``*.ini`` file content.\n\nzope.conf\n The zope.conf file defining the DB used in the WSGI app and the error log\n section.\n\nsite.zcml\n The zope site.zcml file used by the zope application.\n\n\nTest\n----\n\nLets define a (bogus) eggs that we can use in our application:\n\n >>> mkdir('demo')\n >>> write('demo', 'setup.py',\n ... '''\n ... from setuptools import setup\n ... setup(name = 'demo')\n ... ''')\n\nNow check if the setup was correct:\n\n >>> ls('bin')\n - buildout\n\nWe'll create a ``buildout.cfg`` file that defines our paster serve configuration:\n\n >>> write('buildout.cfg',\n ... '''\n ... [buildout]\n ... develop = demo\n ... parts = var myapp\n ...\n ... [var]\n ... recipe = zc.recipe.filestorage\n ...\n ... [myapp]\n ... eggs = demo\n ... recipe = z3c.recipe.paster:serve\n ... ini =\n ... [app:main]\n ... use = egg:demo\n ...\n ... [server:main]\n ... use = egg:Paste#http\n ... host = 127.0.0.1\n ... port = 8080\n ...\n ... zope.conf =\n ...\n ... ${var:zconfig}\n ...\n ... \n ... \n ... formatter zope.exceptions.log.Formatter\n ... path ${buildout:directory}/parts/myapp/error.log\n ... \n ... \n ... formatter zope.exceptions.log.Formatter\n ... path STDOUT\n ... \n ... \n ...\n ... devmode on\n ...\n ... site.zcml =\n ... \n ... \n ...\n ... ''' % globals())\n\nNow, Let's run the buildout and see what we get:\n\n >>> print system(join('bin', 'buildout')),\n Develop: '/sample-buildout/demo'\n Installing var.\n Installing myapp.\n Generated script '/sample-buildout/bin/myapp'.\n\nThe bin folder contains the scripts for serve our new created paste deploy\nserver:\n\n >>> ls('bin')\n - buildout\n - myapp\n\nCheck the content of our new generated myapp script. As you can see, the\ngenerated script uses the ``paste.script.command.run`` for starting our server:\n\n >>> cat('bin', 'myapp')\n #!\"C:\\Python24\\python.exe\"\n \n import sys\n sys.path[0:0] = [\n '/sample-buildout/demo',\n '/sample-pyN.N.egg',\n ...\n '/sample-pyN.N.egg',\n ]\n \n import os\n sys.argv[0] = os.path.abspath(sys.argv[0])\n \n \n import paste.script.command\n \n if __name__ == '__main__':\n paste.script.command.run([\n 'serve', '...myapp.ini',\n ]+sys.argv[1:])\n\nThose ``sample-pyN.N.egg`` lines should be PasteScript and it's dependencies.\n\nCheck the content of our new generated myapp.ini file:\n\n >>> cat('parts', 'myapp', 'myapp.ini')\n \n [app:main]\n use = egg:demo\n [server:main]\n use = egg:Paste#http\n host = 127.0.0.1\n port = 8080\n\n\nEntry point\n-----------\n\nAs you probably know, there is some magic going on during startup. The section\n``app:main`` in the myapp.ini file above must be defined as entry_point in your\nprojects setup.py file. Without them, the ``app:main`` isn't available. You can\ndefine such a app:main entry point using the default ``application_factory``\noffered from the ``z3c.recipe.paster.wsgi`` package. Of corse you can define\nyour own application factory if you need to pass some additional configuration\nfor your app to the factroy defined in your custom ``*.ini`` file.\n\nThe default entry_point offered from the z3c.recipe.paster could be included in\nyour custom setup.py file like::\n\n setup(\n name = 'something',\n version = '0.5.0dev',\n ...\n include_package_data = True,\n package_dir = {'':'src'},\n namespace_packages = [],\n install_requires = [\n 'some.package',\n ],\n entry_points = \"\"\"\n [paste.app_factory]\n main = z3c.recipe.paster.wsgi:application_factory\n \"\"\",\n )\n\n\n========================\nz3c.recipe.paster:paster\n========================\n\nThis Zope 3 recipes offers a Paste Deploy script setup for Zope3 projects.\n\nThe paster part allows us to setup a plain paster executable which could be\nused for start up your zope server using the paste deploy \".ini file like:\n``bin/paster serve app.ini``. This recipe inherits the zc.recipe.egg class\nand will setup the paster within your egg dependency. All you have to do is\nto define your eggs. The benefit of this recipe compared with the built in\nPasteScript it the option to choose another name if you need more then one\npaster script. This is required if you have paster with different egg\ndependencies in one buildout configuration.\n\n\nOptions\n-------\n\nThe 'serve' recipe accepts the following options:\n\neggs\n The names of one or more eggs, with their dependencies that should\n be included in the Python path of the generated scripts.\n\nini\n The paste deploy ``*.ini`` file content.\n\nzope.conf\n The zope.conf file defining the DB used in the WSGI app and the error log\n section.\n\nsite.zcml\n The zope site.zcml file used by the zope application.\n\n\nTest\n----\n\nLets define a (bogus) eggs that we can use in our application:\n\n >>> mkdir('sample')\n >>> write('sample', 'setup.py',\n ... '''\n ... from setuptools import setup\n ... setup(name = 'sample')\n ... ''')\n\nNow check if the setup was correct:\n\n >>> ls('bin')\n - buildout-script.py\n - buildout.exe\n\nWe'll create a ``buildout.cfg`` file that defines our paster configuration:\n\n >>> write('buildout.cfg',\n ... '''\n ... [buildout]\n ... develop = sample\n ... parts = mypaster\n ...\n ... [mypaster]\n ... recipe = z3c.recipe.paster:paster\n ... eggs = sample\n ...\n ... ''' % globals())\n\n >>> ls('bin')\n - buildout-script.py\n - buildout.exe\n\nNow, Let's run the buildout and see what we get:\n\n >>> print system(join('bin', 'buildout')),\n Develop: '/sample-buildout/sample'\n Installing mypaster.\n Generated script '/sample-buildout/bin/mypaster'.\n\nNow check if the setup was correct:\n\n >>> ls('bin')\n - buildout-script.py\n - buildout.exe\n - mypaster-script.py\n - mypaster.exe\n\nCheck the content of our new generated paster script. As you can see, the\ngenerated script uses the ``paste.script.command.run`` for starting our server.\nThis script is generic but uses the path of our eggs and uses the given name:\n\n >>> cat('bin', 'mypaster')\n \n import sys\n sys.path[0:0] = [\n '/sample-buildout/sample',\n '/sample-pyN.N.egg',\n ...\n '/sample-pyN.N.egg',\n ]\n \n import paste.script.command\n \n if __name__ == '__main__':\n paste.script.command.run()\n\n\n=======\nCHANGES\n=======\n\n0.5.3 (2010-02-08)\n------------------\n\n- Fix: add z3c.recipe.paster egg for debugging if it's not there to\n make sure it's installed\n\n0.5.2 (2010-01-28)\n------------------\n\n- Fix: add PasteScript egg if it's not there to make sure it's installed\n\n0.5.1 (2010-01-22)\n------------------\n\n- Added ``debug``, an interactive debug prompt.\n\n- Fixed tests and fix all eggs in test setup.\n\n- Fixed test normalizer.\n\n- Updated tests, so they work with current packages.\n\n- Fixed tests, so they run both an Windows-like and Unix-like OS.\n\n\n0.5.0 (2009-02-22)\n------------------\n\n- Initial Release",
"description_content_type": null,
"docs_url": null,
"download_url": "UNKNOWN",
"downloads": {
"last_day": -1,
"last_month": -1,
"last_week": -1
},
"home_page": "http://pypi.python.org/pypi/z3c.recipe.paster",
"keywords": "zope zope3 z3c paste deploy recipe",
"license": "ZPL 2.1",
"maintainer": null,
"maintainer_email": null,
"name": "z3c.recipe.paster",
"package_url": "https://pypi.org/project/z3c.recipe.paster/",
"platform": "UNKNOWN",
"project_url": "https://pypi.org/project/z3c.recipe.paster/",
"project_urls": {
"Download": "UNKNOWN",
"Homepage": "http://pypi.python.org/pypi/z3c.recipe.paster"
},
"release_url": "https://pypi.org/project/z3c.recipe.paster/0.5.3/",
"requires_dist": null,
"requires_python": null,
"summary": "Zope3 paste deploy setup recipe",
"version": "0.5.3"
},
"last_serial": 802082,
"releases": {
"0.5.0": [
{
"comment_text": "",
"digests": {
"md5": "e6ea0663169c864a6238c437361669b3",
"sha256": "f00548594c78189c62f03aa98c55d6965f48926a0aac9682983e3f1f82b99b2f"
},
"downloads": -1,
"filename": "z3c.recipe.paster-0.5.0.zip",
"has_sig": false,
"md5_digest": "e6ea0663169c864a6238c437361669b3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 20107,
"upload_time": "2009-02-22T07:53:43",
"url": "https://files.pythonhosted.org/packages/3b/28/4ddd367b795f297a5ce4d3d86a162b0183eeaa4c21955a60ada65f9b7ba9/z3c.recipe.paster-0.5.0.zip"
}
],
"0.5.1": [
{
"comment_text": "",
"digests": {
"md5": "25a0acc35f54af36971476e327676f64",
"sha256": "46f9d57ca7d26efb2f3ce5ec50b3b2f417dc795e9eef9255618b102335f6ba31"
},
"downloads": -1,
"filename": "z3c.recipe.paster-0.5.1.tar.gz",
"has_sig": false,
"md5_digest": "25a0acc35f54af36971476e327676f64",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9740,
"upload_time": "2010-01-22T14:54:28",
"url": "https://files.pythonhosted.org/packages/7b/06/b4b67e78a50a797aaa0a89d3a7fbd74d5d9fa0cf6d16fccce46d12dd37fe/z3c.recipe.paster-0.5.1.tar.gz"
}
],
"0.5.2": [
{
"comment_text": "",
"digests": {
"md5": "121735bfc0e9a1d795b387ffd72ba878",
"sha256": "08780d303a914a7bcc70e614f3bcee51b92b0a28a4f0a556afdd3fbf417e545d"
},
"downloads": -1,
"filename": "z3c.recipe.paster-0.5.2.tar.gz",
"has_sig": false,
"md5_digest": "121735bfc0e9a1d795b387ffd72ba878",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9807,
"upload_time": "2010-01-28T14:12:21",
"url": "https://files.pythonhosted.org/packages/a0/df/6794f8c3fc2b6627fecd691f5e5b4e61d7da615e6927a43debb42ae50743/z3c.recipe.paster-0.5.2.tar.gz"
}
],
"0.5.3": [
{
"comment_text": "",
"digests": {
"md5": "3682134ee32bae395b2bf7484739ddab",
"sha256": "7419f3d2995578704e3f18f1fd0b1270d1759af6e04ba3473dd50672dbede6e8"
},
"downloads": -1,
"filename": "z3c.recipe.paster-0.5.3.tar.gz",
"has_sig": false,
"md5_digest": "3682134ee32bae395b2bf7484739ddab",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9854,
"upload_time": "2010-02-08T16:16:41",
"url": "https://files.pythonhosted.org/packages/16/f3/baabd3ea1540c96d8bc1baec9528f5031eeb16bb1c8139cfbfcc3a41104b/z3c.recipe.paster-0.5.3.tar.gz"
}
]
},
"urls": [
{
"comment_text": "",
"digests": {
"md5": "3682134ee32bae395b2bf7484739ddab",
"sha256": "7419f3d2995578704e3f18f1fd0b1270d1759af6e04ba3473dd50672dbede6e8"
},
"downloads": -1,
"filename": "z3c.recipe.paster-0.5.3.tar.gz",
"has_sig": false,
"md5_digest": "3682134ee32bae395b2bf7484739ddab",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 9854,
"upload_time": "2010-02-08T16:16:41",
"url": "https://files.pythonhosted.org/packages/16/f3/baabd3ea1540c96d8bc1baec9528f5031eeb16bb1c8139cfbfcc3a41104b/z3c.recipe.paster-0.5.3.tar.gz"
}
]
}