[Subversion] / PEAK / README.txt  

Diff of /PEAK/README.txt

Parent Directory | Revision Log

version 276, Wed Feb 28 22:03:10 2001 UTC version 340, Fri Mar 1 19:57:23 2002 UTC
Line 1 
Line 1 
 TransWarp Preview Release 0.1  TransWarp Release 0.2 preview 1
   
  Copyright (C) 2001 Phillip J. Eby, All rights reserved.   Copyright (C) 2001,2002 by Phillip J. Eby, All rights reserved.
  This software may be used under the same terms as Zope or Python.   This software may be used under the same terms as Zope or Python.
    THERE ARE ABSOLUTELY NO WARRANTIES OF ANY KIND.  Code quality varies
    from "alpha" to "experimental pre-alpha".  :)
   
  Please see http://www.zope.org/Members/pje/Wikis/TransWarp for tutorials,  
  FAQs, package layout, etc.  Selected pages from the Wiki are included  
  in the docs/ directory for your convenience.  
   
  At this time, the 'Features', 'Aspects', 'SOX', and 'tests' modules   Package Description
  and packages are usable, if not necessarily full-featured.  All other  
  modules/packages (except as imported by the above) are under heavy  
  construction - don't enter without a hard hat!  (That is,  
  use them at your own risk.  Although, there's no warranty that any of  
  the other stuff works, beyond the fact that the tests run on my  
  home computer.)  
   
       TransWarp is a toolkit for software automation in Python, where the term
       "software automation" is considered to include CASE, code templating,
       metaprogramming, generative programming, subject- and aspect-oriented
       programming, etc.  It is also a collection of frameworks which use the
       toolkit for integration with applications and other frameworks.
   
  INSTALLATION INSTRUCTIONS      As Zope is to web publishing, as Twisted Python is to internet protocols,
       and as AnyGUI is to graphical user interfaces, so TransWarp is (or wants
       to be) to the guts of your application, whatever its external interface.
   
   To use this package, you will need to install it by placing the TW/ directory      The high-level vision of TransWarp is "Metadata + Metaclasses = Programs".
   inside a directory which is listed in your Python path.  You will also need  
   to install Aaron Watters' "kjbuckets" library, and Jim Fulton's "Scarecrow"  
   Interfaces package.  
   
   Later versions will hopefully automate some of this as we learn to use the  
   Python distutils, but for now, you have to do everything yourself...  
   
   Getting and Installing kjbuckets   Changes Since Last Release
   
    Unix Platforms      Darn near everything.  :)  Read the new docs and tutorials.
   
     You can download the C source code for kjbuckets at:  
   
      http://www.chordate.com/kjbuckets/   Installation Instructions
   
     And build as you would any other Python module.  
   
    Windows Platforms  
   
     If you're using Python 1.5, you can download a pre-built kjbuckets.pyd at:  
   
      http://www.chordate.com/kwParsing/kjbuckets.pyd  
   
     And then place it in your Python path.  If you're using Python 2.0,  
     or can't get this to work, see "If You Can't Compile kjbuckets" below.  
   
    If You Can't Compile kjbuckets  
   
     If for whatever reason you can't get the C version of kjbuckets to work  
     on your system, download this file:  
   
      http://www.chordate.com/kwParsing/kjbuckets0.py  
   
     Rename it to "kjbuckets.py", and place it in your Python path.  This runs  
     slower than the C version, but it'll do in a pinch.  
   
   Getting and Installing the Interface package (aka "The Scarecrow")  
   
    The easiest place to find a copy of the Interface package is in the  
    lib/python directory of a Zope installation.  Just copy it over to your  
    main Python path, or add the lib/python directory to your Python path.  
   
    Failing that, you can look at this URL for downloads:  
   
     http://www.zope.org/Members/michel/Products/Interfaces/  
   
    This may not be the best place for an up-to-date copy, but the current  
    TransWarp code doesn't do much with interfaces yet, so it probably doesn't  
    matter right now.  
   
   
  TESTING YOUR INSTALLATION  
   
   TransWarp comes with a fairly hefty built-in test suite.  If you have  
   the Python "unittest" module installed in your Python path, you can use  
   it to run the test suites, like this::  
   
    python unittest.py TW.tests.suite  
   
   This will run about 114 tests on various parts of TransWarp.  If you have  
   installed everything correctly, 100% of the tests should succeed.  If  
   you're missing any needed parts, you will probably experience a massive  
   number of failures and errors.  
   
       See the INSTALL.txt file.


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

cvs-admin@eby-sarna.com

Powered by ViewCVS 1.0-dev

ViewCVS and CVS Help