[Checkins] SVN: zc.async/trunk/src/zc/async/ address XXX items in TODO
Gary Poster
gary at modernsongs.com
Sat Sep 20 20:26:00 EDT 2008
Log message for revision 91293:
address XXX items in TODO
Changed:
U zc.async/trunk/src/zc/async/CHANGES.txt
U zc.async/trunk/src/zc/async/TODO.txt
-=-
Modified: zc.async/trunk/src/zc/async/CHANGES.txt
===================================================================
--- zc.async/trunk/src/zc/async/CHANGES.txt 2008-09-20 23:03:02 UTC (rev 91292)
+++ zc.async/trunk/src/zc/async/CHANGES.txt 2008-09-21 00:26:00 UTC (rev 91293)
@@ -66,11 +66,24 @@
- zc.async events inherit from 'zc.component.interfaces.IObjectEvent' instead
of a zc.async specific IObjectEvent (thanks to Satchit Haridas).
-- Added new monitoring and introspection tools XXX
+- Added new monitoring and introspection tools: the ``asyncdb`` zc.monitor
+ command (and, for Python, the code in monitordb.py). This code provides
+ easy spellings to examine the database's view of what is happening in
+ zc.async. Because it is the database, it also has a much longer historical
+ view than the ``async`` tools. The best way to learn about these tools is
+ to read the extensive documentation provided within zc.monitor by
+ using ``asyncdb help`` and ``asyncdb help <TOOL NAME>``.
-- Added new preferred way of filtering agent choices: ``filter`` attribute XXX
+- Added new preferred way of filtering agent choices: the new ``filter``
+ attribute. Using filters, rather than "choosers," allows several ``asyncdb``
+ tools to filter pending jobs based on what an agent is willing to do. It
+ also is a smaller contract, and so a filter requires less code than a chooser
+ in the common case. On the other hand, using a filter alone doesn't allow
+ the agent to try to *prefer* certain tasks.
-- deprecated agent.chooseFirst XXX
+- Deprecated agent.chooseFirst. It is no longer necesary, since an agent
+ without a chooser and with a filter of None has the same behavior. It is
+ retained for legacy databases.
- Moved deprecated legacy code to new ``legacy`` module.
Modified: zc.async/trunk/src/zc/async/TODO.txt
===================================================================
--- zc.async/trunk/src/zc/async/TODO.txt 2008-09-20 23:03:02 UTC (rev 91292)
+++ zc.async/trunk/src/zc/async/TODO.txt 2008-09-21 00:26:00 UTC (rev 91293)
@@ -1,12 +1,9 @@
-- need to show in monitordb test that completed, in-agent, and pending jobs
- do a merge sort (esp. completed, because this is important to the semantics
- of lastcompleted.
-- fill out XXXs in CHANGES
-
+- verify that main docs now show that zc.monitor has much fewer dependencies,
+ so can be introduced without Zope 3.
- fix up tips so that it looks better
- write a zc.buildout/grok quickstart
+- would love a module-based API review of docs.
-
Improvements
- queues should be pluggable like agent with filter
More information about the Checkins
mailing list