September 2000 - Zope

RE: [Zope] Wish for the next Zope Release: Doc tab for every Zope entity
by Chris McDonough 01 Sep '00

01 Sep '00

I agree that instances of DTML methods, DTML documents, SQL methods, Python methods, objects based on ZClasses, etc. should have "docstring" capabilities in some sort of common-denominator fashion. <dtml-comment> is the only way this can be done for DTML methods. The other objects can have properties, which could be documentation. -----Original Message----- From: Philipp Auersperg [mailto:zope@philosoft.at] Sent: Friday, September 01, 2000 6:23 AM To: zope(a)zope.org Subject: [Zope] Wish for the next Zope Release: Doc tab for every Zope entity Mostly when developing a project it should be documented as well :) The best would be a strucutral documentation that can be generated out of the project so that it always keeps track of the software and is up to date - Python has that because there are the doc strings for classes and methods - Java has it (javadoc) - Zope - ? For Zope it would be fine if every entity in the ODB has a 'Documentation' tab So I could when developing a Zope site always on the fly document its structure without having to leave y developing environment. Then its an easy thing to write a doc generator that queries the objects in the ODB and their documentation. Did I miss something and such a beast exists or is there really something to be done? I don't mean documentation in <dtml-comment>, I mean documentation as seperate property for each object and method. Philipp Auersperg (zwork)

2 1

Newbie: ZClass questions
by Nick Trout 01 Sep '00

01 Sep '00

Hi, I'm new to Zope. I'm just flailing around in all the docs and examples at the moment. I'm setting up a small intranet for our office. I've been reading about ZClasses (havent done any SQL). Are these a very efficient way of storing data? Are these more/less efficient than setting up a database and managing it using ZSQL? I read that any changes to a class instance is stored in the Zope database. Is there a way of turning this feature off to avoid the undo facility? ie. if you dont want undo. I'm trying to set up a simple chat room as a teaching exercise. I'm thing I should implement a ZClass which is the room, containg a ZClass which will be a chat item. I've noticed an example, ZRTChat but everything there is implemented in Python (yuck!). It's much nicer to use the interface to create your classes. What are the pros and cons of the 2 approaches. Why implement it all in Python? Cheers, Nick.

1 0

RE: [Zope] Wish for the next Zope Release: Doc tab for every Zope entity
by Chris McDonough 01 Sep '00

01 Sep '00

> Is DC planning to do something in that matter? It's not a priority right now. You may want to propose something on dev.zope.org if you think you have an idea of how it should work. > > also the docstring should perhaps not be just one property, but > structured (author,parameters,prerequisites...) as it is in > javadoc (ok, we don't like java, but thats a point where we > can learn from java) Good point. > > The next point: > if there is a 'Documentation' tab then > every Zope developer is leaded to document his code. > ( DTML is not always simple to read for other people except > the author ;-) Perhaps. It depends on the developer. > > just my 2 cents... Thanks... > phil > *********** REPLY SEPARATOR *********** > > On 01.09.2000 at 08:16 Chris McDonough wrote: > > >I agree that instances of DTML methods, DTML documents, SQL methods, > >Python methods, objects based on ZClasses, etc. should have > "docstring" > >capabilities in some sort of common-denominator fashion. > > > ><dtml-comment> is the only way this can be done for DTML methods. > > > >The other objects can have properties, which could be documentation. > > > >-----Original Message----- > >From: Philipp Auersperg [mailto:zope@philosoft.at] > >Sent: Friday, September 01, 2000 6:23 AM > >To: zope(a)zope.org > >Subject: [Zope] Wish for the next Zope Release: Doc tab for > every Zope > >entity > > > > > >Mostly when developing a project it should be documented as well :) > >The best would be a strucutral documentation that can be generated > >out of the project so that it always keeps track of the > software and is > >up to date > > > >- Python has that because there are the doc strings for classes and > >methods > >- Java has it (javadoc) > >- Zope - ? > > > >For Zope it would be fine if every entity in the ODB has a > >'Documentation' tab > >So I could when developing a Zope site always on the fly document its > >structure > >without having to leave y developing environment. > > > >Then its an easy thing to write a doc generator that queries > the objects > >in the ODB > >and their documentation. > > > >Did I miss something and such a beast exists or is there really > >something to be done? > >I don't mean documentation in <dtml-comment>, I mean documentation as > >seperate > >property for each object and method. > > > >Philipp Auersperg (zwork) > > > > > _______________________________________________ > Zope maillist - Zope(a)zope.org > http://lists.zope.org/mailman/listinfo/zope > ** No cross posts or HTML encoding! ** > (Related lists - > http://lists.zope.org/mailman/listinfo/zope-announce > http://lists.zope.org/mailman/listinfo/zope-dev ) >

1 0

Copying a dtml method when creating a ZClass instance
by kamon ayeva 01 Sep '00

01 Sep '00

Hi, I need some help. I have a DTML method at the root of Zope called 'Template'. How can I make the constructor of a ZClass (folderish) to copy this method to each of its instances ? Can someone provide me with a complete snippet to add in the ZClass constructor ? Many thanks. Kamon _________________________________________________________________________ Get Your Private, Free E-mail from MSN Hotmail at http://www.hotmail.com. Share information about yourself, create your own public profile at http://profiles.msn.com.

3 2

Re: HappySession
by Hung Jung Lu 01 Sep '00

01 Sep '00

My conjecture now is that your error-handling HTML might be accessing attributes from Zope server. A more correct way of handling exceptions should have been using the <dtml-try>...<dtml-except>...</dtml-try> block. But I kind of make a cheat sheet recipe recommendation, tweaking the standard_error_message, which was not a good idea. When Zope arrives to standard_error_message, the transaction has been aborted and if your session_not_found_html is not simple enough and uses more DTML features, I can see that it can cause transaction error. Can you send me your session_not_found_html? I think this was the problem. In the future I will remove the standard_error_message trick from the help file and instead tell people to use proper exception handling, which is the right way of doing things. But it will require people to structure their sites more carefully so they can catch the SessionNotFound exception. Basically, it is recommended that you have single (or few) index_html on your site, and place a <dtml-try>...<dtml-except ...>...</dtml-try> block to capture all exceptions from Zope and deal with them. It's the right way of doing things, it's just that many people tend to have many index_html and it will make their site harder to catch exceptions and deal with them in a centralized way. In short, HappySession itself is probably not the cause of the transaction error. The problem probably comes from bad exception handling. If you want to use the standard_error_message trick, then please use a simple html page for session_not_found_html without additional Zope features. If I find out more, I'll let you know. regards, Hung Jung _________________________________________________________________________ Get Your Private, Free E-mail from MSN Hotmail at http://www.hotmail.com. Share information about yourself, create your own public profile at http://profiles.msn.com.

3 2

RE: [Zope] Is anyone know when Zope was born ???
by Paul Everitt 01 Sep '00

01 Sep '00

As far as I'm concerned, Zope was born Saturday, June 8, 1996. This was Jim Fulton's plane trip back from IPC4: http://www.python.org/workshops/1996-06/ Beyond that, Zope (as a unification of previous software) was announced in November 1998 and released in December 1998. DC had some prior art in the field before IPC4, such as my W3C tech note on the "ILU Requester", technology for making web servers talk CORBA to services. Also, Brian Lloyd had, with someone else here at the time, cooked up an early ORB to handle message dispatch from the web into Python. However, our work was tiny compared to Jim's plane trip back. I pick the 1996 date because, well, from a marketing perspective it makes Zope look more mature. :^) But that's the best date. Here's "the rest of the story". Jim joined Digital Creations about a week before IPC4. He had already scheduled to go to IPC4, and I had scheduled to go and teach a CGI class. Instead, I decided to go on vacation and make him teach the class. Slight problem: he had never heard of CGI. So on the plane ride there he read the CGI spec, some background material, and rewrote my presentation. In the process he decided CGI was broken and needed a bunch of things, primarily object orientation. The "python object publisher" (an ORB) was conceived during the conference and was largely written on the plane ride back. The ORB quickly took over our consulting business. Within a year we added a template system, then a persistent object system, then... That's the story. So there, we have a birthdate! --Paul > -----Original Message----- > From: Chris Withers [mailto:chrisw@nipltd.com] > Sent: Wednesday, August 30, 2000 5:17 AM > To: Frederic Quin > Cc: zope(a)zope.org; paul(a)digicool.com > Subject: Re: [Zope] Is anyone know when Zope was born ??? > > > Frederic Quin wrote: > > > > Is anyone know when Zope was born ??? > > Paul, you must know the answer to this one ;-) > > cheers, > > Chris >

3 2

Wish for the next Zope Release: Doc tab for every Zope entity
by Philipp Auersperg 01 Sep '00

01 Sep '00

Mostly when developing a project it should be documented as well :) The best would be a strucutral documentation that can be generated out of the project so that it always keeps track of the software and is up to date - Python has that because there are the doc strings for classes and methods - Java has it (javadoc) - Zope - ? For Zope it would be fine if every entity in the ODB has a 'Documentation' tab So I could when developing a Zope site always on the fly document its structure without having to leave y developing environment. Then its an easy thing to write a doc generator that queries the objects in the ODB and their documentation. Did I miss something and such a beast exists or is there really something to be done? I don't mean documentation in <dtml-comment>, I mean documentation as seperate property for each object and method. Philipp Auersperg (zwork)

1 0

RE: Good Examples of Zope in Action
by Paul Everitt 01 Sep '00

01 Sep '00

First, note that I can only talk on the record about things that are here now and that I have the OK to talk about. There have been a number of big things we've done over the last year, like our work with HomeGain that you allude to below. It's important for me to work closely with them to get the correct statement on the record. It's not always a fast process, but these things are likely to get accelerated in September. --Paul > -----Original Message----- > From: Chris Withers [mailto:chrisw@nipltd.com] > Sent: Friday, September 01, 2000 2:33 AM > To: paul(a)digicool.com > Cc: Marty McKeever at Work; zope(a)zope.org > Subject: Good Examples of Zope in Action > > > Marty McKeever at Work wrote: > > The question is this: "What are some examples of > high-profile and/or > > enterprise level ecommerce or web production sites using zope?" > > > > Send me examples and i'll post them to the original thread. > > Paul, > > Maybe now would be a good time to chime in with the CBS and > Yahoo!(HomeSite?) examples you mentioned in Paris :-) > > cheers, > > Chris >

1 0

Designing with Zope
by Tim Cook 01 Sep '00

01 Sep '00

Hoefully this is not too ambiguous. But I'm wondering if there are any "gotcha's" in developing an application that would maintain parts of it's data in ZODB and the rest in an RDBMS? This might be better stated as a situation where one application that uses Zope and an RDBMS was a sub-part of a ZODB application. Say, a sales management app in ZODB uses an accounting app that stores its data in an RDBMS through the same Zope server? Thanks, -- Tim Cook -- FreePM Project Coordinator http://www.freepm.org OS Health Care Alliance Supporter http://www.oshca.org

2 1

The Challenge: Zealots vs. Skeptics
by Marty McKeever at Work 01 Sep '00

01 Sep '00

A recent thread has developed on a well established web development list concerning the viability of zope as an appserver. I dont want to continue the thread here, but a good question was asked and no suitable answers have come in. Surely this list can help. The question is this: "What are some examples of high-profile and/or enterprise level ecommerce or web production sites using zope?" Send me examples and i'll post them to the original thread. Marty PS: dont send me to YOUR website, unless you can provide the traffic numbers that back it up. ## Marty McKeever - marty.mckeever(a)goingv.com ## Manager / Web Services Division ## Going Virtual LLC., Matthews NC ## http://www.goingv.com (704) 849-0731

4 3