[Subversion] / PEAK / CHANGES.txt  

Diff of /PEAK/CHANGES.txt

Parent Directory | Revision Log

version 1078, Sat May 3 22:11:56 2003 UTC version 1751, Fri Jun 4 17:02:55 2004 UTC
Line 1 
Line 1 
 Fixes and Enhancements since Version 0.5 alpha 1  Fixes and Enhancements since Version 0.5 alpha 3
   
    - The 'log()' method of PEAK loggers ('logs.ILogger') now accepts a level name
      *or* a number, for convenient invocation.
   
    - SQL transaction semantics have changed.  Now, issuing an SQL statement
      *always* causes the connection to join the active PEAK transaction, even if
      you request that the SQL be issued "outside" a transaction.  Such SQL will
      be issued outside of the *database* transaction, but not outside of the
      PEAK transaction.  This simplifies the overall processing model for dealing
      with "untransacted" SQL such as Sybase DDL or read-only Oracle transactions.
      (In particular, the requirement that triggered this change was to allow
      Oracle read-only transactions to be released at the end of the current PEAK
      transaction.)  Also, got rid of the now-meaningless 'begin' command in n2.
   
    - The 'events.IEventSource' interface now returns a 'canceller' function from
      the 'addCallback()' method, allowing you to cancel a previously-scheduled
      callback.  This fixes a memory leak and performance problem with
      'events.AnyOf()', which previously could accumulate unneeded callbacks on
      the sources it was monitoring.  Note that if you have developed any custom
      event sources with 'addCallback()' methods, you must make sure that they
      return a canceller from now on.
   
    - Added 'ref:factory@addr1||addr2' URL scheme that maps to a corresponding
      'naming.Reference("factory",["addr1","addr2"])'.  'factory' can be either a
      dotted import string referencing a 'naming.IObjectFactory', or you can
      define a factory in the 'peak.naming.factories' property space.
   
    - Added a 'zconfig.schema' factory, so that 'ref:zconfig.schema@streamURL'
      will load a schema loader.  Schema loaders are themselves object factories,
      so you can do something like:
   
        [Named Services]
        peak.naming.factories.myschema = \
            naming.LinkRef('ref:zconfig.schema@pkgfile:mypkg/Schema.xml')
   
      in order to make URLs like 'ref:myschema@filename' work.  Note, by the way,
      that the above could also read:
   
        [Named Services]
        peak.naming.factories.myschema = \
            naming.Reference('zconfig.schema',['pkgfile:mypkg/Schema.xml'])
   
      which runs somewhat faster at lookup time.  Similarly, one can also use
      'naming.Reference("myschema",["somefile"])' in place of a
      'naming.LinkRef("ref:myschema@filename")'.  As well as being faster, for
      some use cases it's easier to 'Reference' directly than to glue together
      a 'ref:' URL string.
   
  - Removed 'LOG_XYZ' convenience functions from 'peak.api', and refactored  
    'peak.running.logs' to use a PEP 282-like interface, 'running.ILogger'.  
    Under the new scheme, messages must be sent to a specific entry point  
    (e.g. 'self.logger.warning("foo")').  Components can bind an attribute  
    directly to a logger object, or via configuration properties or utilities.  
    PEAK components that do logging all define a 'logger' attribute, bound  
    to a configuration property in the 'peak.logs' property namespace.  By  
    a default in 'peak.ini', 'peak.logs.*' is configured to output messages  
    of 'WARNING' priority or higher to 'sys.stderr'.  
   
    For compatibility with the PEP 282 logging package, a 'logging.logger:'  
    URL scheme has been added; looking up the URL '"logging.logger:foo.bar"'  
    is equivalent to 'logging.getLogger("foo.bar")', unless the 'logging'  
    package is not available, in which case the configuration property  
    'peak.logs.foo.bar' will be looked up in the target context of the  
    lookup.  Optionally, you can configure the 'logging.logger' URL scheme so  
    that it only uses PEAK loggers, and never uses the PEP 282 loggers.  
   
  - Added 'binding.metamethod()' wrapper for metaclass methods that might  
    not be accessible from their instances if the instances (classes) also  
    defined the method for *their* instances.  You must now use this wrapper  
    on any such metaclass-defined methods, as PEAK no longer works around  
    this via the 'x.__class__.foo(x,...)' trick that was used previously.  
    In particular, if you have metaclass definitions of 'getParentComponent',  
    '_getConfigData', 'getComponentName', or 'notifyUponAssembly', you need  
    to wrap them with 'binding.metamethod' now.  
   
  - Fixed 'mof2py' generator script not working  
   
  - Fixed model.Element not getting parent component set when passed as a  
    constructor argument.  
   
  - Fixed property/utility lookups not working correctly on model.*  
    objects.  
   
  - Fixed IndentedStream generating all-whitespace lines  
   
  - Made 'NOT_GIVEN' and 'NOT_FOUND' recognizable by humans (they 'repr'  
    and 'str' to their names) and by Python (they can be pickled, and  
    when restored they come back as the same object).  
   


Generate output suitable for use with a patch program
Legend:
Removed from v.1078  
changed lines
  Added in v.1751

cvs-admin@eby-sarna.com

Powered by ViewCVS 1.0-dev

ViewCVS and CVS Help