Version history for the RO Python Package

Warnings:

• RO is now served at PyPI (as of version 2.2.6). Versions older than 2.2.6 are still available from the old repository.
• RO uses numpy instead of numarray and Numeric (as of version 2.1).

2.2.6 2008-01-30

• RO.Comm
  • RO.Comm.TCPConnection: tweaked connect to raise RuntimeError if connecting or connected (instead of just connected).
• RO.StringUtil: removed unused variable (found by pychecker).
• RO.Wdg
  • RO.Wdg.GrayImageDispWdg: added defRange argument to __init__.
• The first version served on PyPI.

2.2.5 2008-01-23

• Modified setup.py to use setuptools for installation.
• RO.Comm
  • RO.Comm.TkSocket: added pre-test for socket existing to write and writeLine.
  • RO.Comm.TCPConnection:
    • Removed getProgress method. It was clumsy and better handled by the user.
    • Modified connect to raise RuntimeError if host and self.host are both blank or if already connected.
• RO.Wdg
  • RO.Wdg.GrayImageDispWdg:
    • Added method evtOnCanvas.
    • Changed default scaling from ASinh 0.01 to Linear by request of Russet McMillan.
  • RO.Wdg.LogWdg.py: fixed incompatibility with Tcl/Tk 8.5 (the Text index method returns an object instead of a string). Note: this and other incompatibilities in Tkinter.Text will eventually be fixed in Tkinter.
  • RO.Wdg.StatusConfigGridder: added numStatusCols argument. This makes it easier to start all configuration widgets in the same column.

2.2.4 2007-11-16

• Corrected download links in documentation (they pointed to an obsolete ftp repository).

2.2.3 2007-10-16

• RO.DS9: updated to find DS9 5.0 on the Mac (SAO changed things yet again).
• RO.Wdg
  • RO.Wdg.GrayImageDispWdg: the test code now demonstrates the use of masks.

2.2.2 2007-09-28

Fixed some bugs found by pychecker.

• RO.Astro.Cnv
  • RO.Astro.Cnv.ObsFromTopo and RO.Astro.Cnv.TopoFromObs mis-called numpy.asarray (which does not accept the copy argument). Fixed by switching to numpy.array to force a copy.
• RO.Wdg
  • RO.Wdg.Gridder: gridWdg ignored the helpText and helpURL arguments.
  • RO.Wdg.LogWdg.py: fixed the setEnable method.

2.2.1 2007-09-10

• RO.Wdg.OptionMenu:
  • Modified to not check the initial value of var (if supplied) even if its value is not in the list of items. This improves backwards compatibility.
  • Added checkCurrent argument to setItems method.
  • Bug fix: defValue not shown as initial value when it should have been.
• RO.Prefs:
  • Font preference improvements:
    • Reduced the minimum font size to 6 from 9.
    • The default font on Windows is now MS Sans Serif instead of Helvetica.
    • The initial value of the font family and size are now shown even if not an option in the menu.
    • The options menu button is now labelled Options instead of being blank.

2.2 2007-09-07

• RO.CnvUtil:
  • Added FloatOrNoneFromStr and IntOrNoneFromStr classes. Unlike asFloatOrNone and asIntOrNone the user may specify one or more bad values (and only string values are accepted for input).
• RO.InputCont: added allDefault method.
• RO.KeyVariable.PVTVar: added hasVel method.
• RO.PVT.PVT: added hasVel method.
• RO.Wdg
  • RO.Wdg.OptionMenu:
    • One can now set the value to None; formerly set(None) was ignored.
    • Added noneDisplay argument: the string to display when the value is None.
    • restoreDefault now updates the display even if defValue = None.
    • Added showDefault argument to setDefault.
    • If ignoreCase is True, setItems retains the current value if it matches a new item case-blind (formerly an exact match was always required).
  • RO.Wdg.OptionPanelControl: added setBool method.
  • RO.Wdg.ScriptRunner: Overhauled helpURL handling. Now it looks in the script for a variable named HelpURL.
  • RO.Wdg.Toplevel: added a workaround for Tk bug 1771916: Bad geometry reported...; geometry is not saved and a warning is printed if y < 0.

2.1 2007-06-07

• Modified to use numpy instead of numarray and Numeric.
• RO.Astro: added runTests.py to run all unit tests in this package. Note that two tests fail for RO.Astro.Sph.AngSideAng; this is a known issue.
• RO.StringUtil.dmsStrFromSec bug fix: gave wrong answer if nFields != 3.
• RO.Wdg:
  • RO.Wdg.LogWdg: added setEnable method.

2.0 2007-01-22

• The first release with an installer and a version number.
• All source code changed to using 4 spaces instead of tabs for indentation.
• RO.DS9:
  • Help and example code improved.
  • Bug fix: on unix there was an error in reporting ds9 not found.
• RO.OS.getResourceDir: modified to support pyinstaller-packaged applications (but if using pyinstaller you must manually expand sys.executable at startup for this to work reliably).
• RO.Wdg:
  • RO.Wdg.AutoIsCurrentMixin: modified to use isDefault method instead of getString and getDefault.
  • RO.Wdg.Checkbutton: added isDefault method.
  • RO.Wdg.Entry:
    • Added label argument.
    • For numeric entries: improved isDefault argument to compare numeric values after comparing string values. This allows 1 to match 1.0, etc.
    • Bug fix: supplying a doneFunc disabled some range checking.
  • RO.Wdg.GrayImageDispWdg: improved compatibility with PIL 1.1.6 and later (by specifying more arguments to frombuffer).

2007-01-02

• RO.Constants: added sevDebug.
• RO.DS9: modified to work with Mac ds9 4.0b10 (SAO keeps unpredictably renaming the Mac application).
• RO.KeyVariable: Added keyVars argument to CmdVar. This allows retrieving data returned as the result of a command.
• RO.KeyDispatcher: overhauled logging.
• RO.OS: added delDir function.
• RO.ScriptRunner:
  • Added waitUser and resumeUser methods.
  • Added checkFail argument to waitCmd and waitCmdVars methods.
  • waitCmd now returns the cmdVar in sr.value.
  • Added keyVars argument to startCmd and waitCmd.
• RO.TkUtil: added addColors function.
• RO.Wdg:
  • Deleted RO.Wdg.CmdReplyWdg. I guessed it was not used, and LogWdg changed enough to make updating a headache. If you need it, let me know.
  • Added RO.Wdg.ResizableRect.
  • RO.Wdg.Entry: added doneFunc argument: a function to call when the user types <return> or the widget loses focus.
  • RO.Wdg.GrayImageDispWdg: added imPosFromArrIJ method.
  • RO.Wdg.OptionMenu: added index method to work around a tk misfeature
  • RO.Wdg.LogWdg: totally overhauled. Now includes just the log area (users are expected to add the extra controls needed). Includes powerful new methods for filtering and searching.
  • RO.Wdg.ScriptWdg: Bug fix: if a script paused itself, the pause button still showed "Pause" instead of "Resume".
  • RO.Wdg.Gridder and StatusConfigGridder: Added support adding help text and URL to created widgets.
  • RO.Wdg.Text: added search method with elide argument because Tkinter's Text.search doesn't yet support elide.
• Minor fixes to the version history.

2006-07-11

• RO.Comm.TkSocket
  • Modified BaseServer to be compatible with Python 2.3.
  • Added BaseServer to __all__.
  • Bug fix: invalid import in test code.
• RO.DS9: modified to handle version 4.0b9 of ds9 (which has a new name on the Mac: "SAOImage DS9.app").
• RO.Wdg
  • FileWdg: bug fix: initial defPath was not shown.
  • GrayImageDispWdg: added imPosFromArrIJ method.

2006-06-07

• RO.KeyDispatcher: bug fix: if a message could not be parsed, logging the error failed (due to logging in a way that involved parsing the message again).
• RO.ScriptRunner:
  • Bug fixes to debug mode:
    • waitCmd miscomputed iterID.
    • startCmd dispatched commands.
  • Improved error handling in _continue.
• RO.Prefs
  • Bug fix: DirectoryPrefVar, FilePrefVar and SoundPrefVar's edit widgets would not restore the initial or current value when requested. To fix this, I now instantiate the editors in the PrefEditor module instead of PrefVar. Thus these vars no longer have useful getEditWdg methods.
• RO.Wdg
  • DirWdg and FileWdg:
    • If the current path is missing when the user selects a new one, the dialog box starts at the parent dir (if found).
    • Bug fix: if the current path was missing, the choose dialog would not come up.
    • Bug fix: FileWdg does not set defPath or path if defPath is a directory (but it still uses the value as the initial directory of the choose dialog).
  • GrayImageDispWdg MaskInfo changes:
    • Added setColor method.
    • Bug fix: mask colors were slightly mishandled (the rgb values ranged to 64k instead of 256).
  • Entry:
    • Added trackDefault argument.
    • Added getNumOrNone to numeric entry types.
    • Improved doc strings for checkValue and _basicCheck methods.
  • LogWdg:
    • Added helpText argument.
    • Made the control frame explicit so it can be easily hidden.
  • OptionMenu:
    • Added trackDefault argument.
    • Bug fix: added isCurrent argument to set.
    • Bug fix: setItems properly preserves non-item-specific help.
  • RadiobuttonSet
    • Added trackDefault argument.
    • Bug fix: added isCurrent argument to set and setDefault.
  • ScriptRunner: modified to report reload failures.
  • Toplevel:
    • Added a patch (an extra call to update_idletasks) for a bug in Tcl/Tk 8.4.13 that caused certain toplevels to be displayed in the wrong place.
    • Removed a patch in makeVisible for an older tk bug; the patch was now causing iconified toplevels to be left iconified.
    • Always pack the widget with expand="yes", fill="both"; this fixes a situation where the user first creates a Toplevel and later decides to make it resizable.
    • Commented out code in makeVisible that supposedly avoids toplevels shifting; I can't see how it can help.

2006-04-17

• RO.Wdg
  • GrayImageDispWdg:
    • Added optional display of bitmasks.
    • Modified to make linear the initial function.
    • Bug fix: initial scaling function was not set.
  • RadioButtonSet:
    • Treat a default value of None as "no default", rather than "the first value".
    • Bug fix: defIfBlank argument was ignored.

2006-04-05

• RO.ScriptRunner: scripts may run subscripts.
• RO.Wdg
  • CmdReplyWdg: bug fix: did not auto-scroll after a command was entered (broken in 2006-03-10).
  • HTTPGetWdg: bug fix: status display failed if state was aborting or aborted.
  • RadioButtonSet:
    • Added "side" argument to pack the widgets as specified.
    • Added isCurrent and autoIsCurrent support.
    • Modified getWdgSet to return a copy.
  • Added isDefault method to the following: xxxEntry, OptionMenu, RadioButtonSet. Warning: it has not yet been tested; also, it may not behave as desired if the default is None.

2006-03-10

• RO.KeyVariable.KeyVar now emulates a normal sequence for read-only access to its values, thus "a in var", var[i], var[i:j] and len(var).
• RO.OS
  • getHomeDir fixed to work on Windows (formerly returned None).
  • getWinDirs: removed py2exe compatibility because it's more appropriate for the py2exe setup.py script (see the module's doc string for the necessary code).
• RO.ScriptRunner: added support for defining a script as a class (scriptClass argument), making it much easier to pass data between the init, run and end functions.
• RO.SQLUtil.NullDBCursor:
  • Added lastrowid.
  • execute's output truncates long values.
• RO.Wdg
  • Added CmdWdg (split off from RO.Wdg.CmdReplyWdg).
  • CmdReplyWdg: modified to use new RO.Wdg.CmdWdg.
  • Added DirWdg and FileWdg: buttons that display a path; press to change it.
  • DMSEntry.setIsHours bug fix: switching from hours to degrees could raise an exception (if it decided the precision of a value in hours was 0, it would try to use -1 for the converted value).
  • ProgressBar: added setUnknown to display an unknown remaining time.
  • ScriptWdg: looks for "ScriptClass" and uses that in preference to "init", "run" and "end" functions.

2006-01-20

• RO.SeqUtil
  • Added asCollection
  • Redefined Collection to mean any non-string-like iterable (adopting a test suggested by Michael Spencer on comp.lang.python).
  • Collection and Sequence are now defined in the module's doc string.
• RO.SQLUtil
  • formatFieldEqVal: added sepStr argument.
  • removed getLastInsertedIDMySQL since it didn't work as advertised; use the cursor's lastrowid instead; for more information, see the MySQLDb manual entry for insert_id(). (Note: despite the 1.2.0 manual, insert_id() is an attribute of the connection, but is used to create the cursor's lastrowid.).

2006-01-09

• RO.StringUtil: Fixed a bug in dmsStrFromDeg: dmsStrFromDeg(-50.650002) = "-50:38:60.0" and a related bug in dmsStrFroMSec. Thanks to John Lucey for the bug report.
• RO.PgSQLUtil renamed to RO.SQLUtil...
  • because all but one function should work with any DBAPI-2.0 database.
  • Renamed getLastInsertedID to getLastInsertedIDPgSQL.
  • Added getLastInsertedIDMySQL.
  • Added NullDBConn and NullDBCursor, for testing database code without actually modifying databases.
  • Modified insertRow so fieldsToAdd defaults to all fields.
  • Modified rowExists so fieldsToCheck defaults to all fields.

2005-11-04

• RO.DS9.DS9Win.showArray: displaying an array in non-native byte order no longer requires copying the input array. Based on code by Tim Axelrod and Rick White.

2005-10-31_2

• RO.DS9.DS9Win.showArray: bug fix: the input array would be altered if it was not in native byte order. Fixed by copying the input array if it is not in native byte order; this is a temporary fix until I figure out how to use the array unaltered. Thanks to Tim Axelrod for the bug report.

2005-10-31

• RO.DS9.DS9Win.showArray bug fix: mis-handled arrays that were not in native byte order. Thanks to Tim Axelrod for the bug report.

2005-10-13

• RO.DS9:
  • MacOS X:
    • Fully supports MacOS X version of ds9 (so long ds9.app is in one of the standard application directories). Thus darwin xpa is no longer necessary (though still usable).
    • Add /usr/local/bin to env var PATH and set env var DISPLAY, if necessary. This makes bundled apps more likely to work because they do not see the user's Terminal login modifications to env variables.
  • Windows: supports xpa installed in its default location (or installed in the same directory as ds9, which is still preferable for command-line use).

2005-10-07

• RO.DS9: fixed Windows bugs introduced in 2005-09-30 release.
• RO.OS
  • Fixed Windows bugs introduced in 2005-09-30 release.
  • Added inclNone argument to all getXXXDirs functions; inclNone defaults to False, giving the pre-2005-09-30 behavior.
  • getWinDirs modified to be compatible with py2exe (one needs trickery to import win32com.shell).
  • splitPath bug fix: on Windows the first element (disk letter) ended with a backslash.

2005-09-30

• RO.DS9:
  • Corrected the instructions for installing xpa and ds9 on Mac and Windows.
  • It explicitly looks for xpaget and ds9 (on all platforms) and complains if it cannot find them. It then checks again each time you try to do anything (so you can install the components and keep working without reloading the module). Warning: this requires a "which" function on unix.
  • MacOS X and Windows: it now looks in the standard locations for applications (rather than typical locations on English systems).
  • MacOS X: DS9Win launches X11 if necessary.
  • Bug fix: used the warnings module without importing it.
• RO.Prefs
  • PrefSet: Changed oldPrefNames argument to oldPrefInfo: one can now map old pref names to new pref names.
  • PrefsWdg:
    • Added getCategories and showCategory methods.
    • Renamed internal method selectCategory to _showSelectedCategory.
• RO.SeqUtil: added get.
• RO.Wdg
  • Bindings: on Mac, added support for Command-Q = quit and Command-W = withdraw toplevel.
  • Checkbutton: If var supplied and defValue left None then the default value is the current value of var.
  • GrayImageViewerWdg: propagates left-mouse-button events (but still does not propagate middle or right mouse-button events, to avoid unwanted copy or paste), making it easier to write code that uses the "normal" mode.

2005-09-07

• RO.Comm.TkSocket
  • Bug fix: an exception could occur in the read callback if the remote host closed the connection. Formerly the internal socket read callback tried to check the connection before calling the user's read callback, but that test could fail due to timing issues. Now the user's read callback is always called and read and readLine always return "" (or default for readLine) if the socket is closed—they never raise an exception.
  • Bug fix: leaked tcl functions.
• RO.TkUtil.TclFunc: Removed useless __del__ from TclFunc and updated the documentation.
• RO.Wdg.StatusBar: bug fix: if text=... was present in a command reply, the info was shown in parenthesis.

2005-08-12

• RO.Alg.OrderedDict:
  • The following changes were kindly suggested by "bearophile":
    • Redefined copy to make subclassing easier and safer (in fact ReverseOrderedDict.copy was broken).
    • Incompatible Change: Renamed checkIntegrity to _checkIntegrity.
    • Eliminated use of obsolete string module
  • Modified __repr__ to return a string that can recreate the OrderedDict. Note: this has an unfortunate side effect for ReverseOrderedDict: the items are shown in reversed order.
  • Added __str__ to return the traditional dict representation formerly returned by __repr__.
• RO.Alg.ReverseOrderedDict: bug fix: copy returned an OrderedDict instead of a ReverseOrderedDict.
• RO.Comm.
  • TCPConnection: added isDone and getProgress methods.
  • TkSocket
    • Incompatible Change: Changed state constants from module constants to class constants.
    • Added class TkServerSocket.
    • Bug fix: TkSocket was not sending binary data through correctly.
• RO.Prefs.PrefVar: changed help text for file, directory and sound prefs to the standard help text.
• RO.Wdg.
  • Bindings: fixed bug in makeReadOnly: was not trapping button-release-2 (which pastes the selection, at least on unix).
  • ProgressBar: modified to handle min=max gracefully: it will display an empty bar instead of raising an exception.
  • StatusBar: bug fix: clear() reset the temporary message ID, which could cause clearTempMsg() to clear the wrong message.
• Refactored the package to separate code and resource files. This will make it easier to package projects that use RO.

2005-07-11

• RO.AddCallback: added method _removeAllCallbacks.
• RO.Alg.OrderedDict:
  • Added index and insert methods
  • Bug fix: the pop method needed to be overridden.
• RO.CanvasUtil: improved Spiral:
  • Keep track of geom ID for more reliable clear during redraw.
  • Use list comprehension to speed computation of coords.
• Plugged various potential memory leaks by making the following perform better cleanup when done (including removing references to callback functions):
  • RO.Comm.TkSocket
  • RO.KeyVariable.CmdVar
  • RO.Comm.FTPGet
  • RO.Comm.FTPLogWdg
• RO.Comm.FTPGet is deprecated (use the new RO.Comm.HTTPGet, instead, if possible). I do not intend to update it any further. However, it did receive some changes for this release:
  • Eliminated callback function support. Callbacks were not Tk safe and that was a nasty trap. Note that RO.Wdg.FTPLogWdg.getFile supports Tk-safe callbacks.
  • Fixed a bug that could cause an existing file to get deleted even if the overwrite argument was false.
• RO.Comm.HTTPGet added. This downloads files using the http protocol. It uses tcl libraries to perform the download and thus is nicely integrated into the tk event loop (unlike RO.Comm.FTPGet, which is now deprecated).
• RO.KeyDispatcher:
  • Modified logMsg to take severity instead of typeChar.
  • Bug fix: _isConnected was not getting set properly if connection was omitted. It may also have not been set correctly for real connections in special cases.
  • Fixed a typo in the test code. It works again.
• RO.KeyVariable:
  • Added getSeverity method to KeyVar and CmdVar.
  • Added getCmdrCmdID method to KeyVar.
  • Changed CmdVar.replies to CmdVar.lastReply. This was to avoid wasting memory; some commands may run for a very long time.
  • Modified TypeDict; 2nd element of each value is now severity (one of RO.Constants.sev...) instead of a logger category.
• RO.OS:
  • Added getDocsDir
  • Changed getAppSuppDirs to return None for unknown dirs (so you can tell which is user-specific and which one is shared).
  • Removed Mac-specific doCreate argument for getAppSuppDirs and getPrefsDir.
• RO.Prefs: improved the file chooser for FilePrefVar so that it does a better job of starting out in the right place.
• RO.Prefs.WdgPrefs: bug fix: was using == for assignment in one location (caught by pychecker).
• RO.ScriptRunner: changed default cmdStatusBar from statusBar to no bar.
• RO.SeqUtil: added isCollection, isString and asSet.
• RO.Wdg.HTTPLogWdg added. This shows the state of RO.Comm.HTTPGet downloads and includes method getFile to initiate such a transfer.
• RO.Wdg.TkUtil moved to RO.TkUtil to reduce the chance of import loops.
• RO.Wdg.Bindings: Modified stdBindings to use TkUtil. Also, may have improved stdBindings's disabling of <<Paste-Selection>> on Windows.
• RO.Wdg.Button: added severity support. However, it does not work on MacOS X Aqua.
• RO.Wdg.Checkbutton: Modified default padding when indicatoron is false so it looks better under Tk 8.4.9, especially on Aqua (something changed in Tk at some point such that the old aqua margins were too small).
• RO.Wdg.Entry:
  • Modify to check value on getString, getStringOrDefault, getNum and getNumOrDefault. Thus these methods will now raise an exception if the value is invalid (e.g. out of range for numeric values).
  • DMSEntry, IntEntry and FloatEntry (changes made in parent class _NumEntry):
    • Modified getNum to return if empty (thus it acts like getString instead of getStringOrDefault) or raise an exception if the current value is invalid.
    • Added getNumOrDefault: return the default if the field is empty (like getStringOrDefault and the old getNum), or raise an exception if the current value is invalid (like the new getNum but not like the old getNum).
    • Mis-handled None as a limit. It might test minLim < maxLim even if one or both were None and it would always reject "-" if minLim was None.
    • Modified to complain if "-" isn't the first character if maxVal < 0.
  • Modified _checkVar (which checks each character as it is entered) to clear the field if both the new value and the previous value are invalid (based on checking partial value). This should only happen if the validity criterion (such as range for numeric entry fields) is changed while the user is entering data.
  • Modified try/except blocks to not swallow system exit and keyboard interrupt.
• RO.Wdg.FTPLogWdg is deprecated (use the new RO.Wdg.HTTPLogWdg, instead, if possible). I do not intend to update it any further. However, it did receive some changes for this release:
  • Bug fix: was not trimming excess log entries correctly.
  • Modified to auto-scroll only when last entry selected (or no entry selected) rather than basing it on scroll position.
• RO.Wdg.GrayImageDispWdg:
  • Added helpURL argument.
  • Added showMsg method.
  • Increased maximum zoom to 10x (and you can make it larger if you like, though you'll have to edit the file).
  • Improved use of memory while zooming.
  • Added memory exception handling.
  • Changed level mode to work on first click.
  • Improved mode handling with no image. The mode icon is now illuminated and the zoom frame appears but nothing else happens.
  • Bug fix: could not display images that were all the same intensity.
  • Bug fix: level mode set incorrect levels if there was a border around the canvas.
• RO.Wdg.HTTPGetWdg added. This includes a getFile method to initiate downloading files to disk via http, and displays the status of such downloads.
• RO.Wdg.InputCont: Bug fix: was referencing TclError, not Tkinter.TclError (caught by pychecker).
• RO.Wdg.OptionPanelControl: modified to use RO.Wdg.Checkbutton's default padding (which is now sensible for unix and Aqua).
• RO.Wdg.ScriptWdg: documented change of default cmdStatusBar from statusBar to no bar. .
• RO.Wdg.StatusBar:
  • Added cmdSummary argument to doCmd.
  • Modified to use severity built into RO.Wdg.EntryWdg (prefs no longer need color prefs and the code is simpler).
  • Modified command output to ignore info messages unless they contain a "Text" keyword.
• RO.Wdg.StatusConfigGridder: bug fix: gridWdg mis-set nextCol if cfgWdg False or None. Also improved error message for units and cfgUnits being the same widget.
• RO.Wdg.TkUtil: added getButtonNumbers to work around a tk misfeature: buttons are numbered 1, 3, 2 on MacOS X Aqua and 1, 2, 3 on Unix/X11 and Windows.
• Cleaned up indentation oddities in many files.
• Changed old-style classes to new-style classes (inherit from object) as follows: RO.AddCallback:BaseMixin; RO.Alg.IDGen, MatchList and MultiListIter; RO.CanvasUtil.Spiral; RO.CnvUtil.StrCnv and StrCnvNoCase; RO.Comm.TCPConnect.TCPConnect; RO.Comm.TkSocket.TkSocket and NullSocket; RO.KeyDispatcher.KeyDispatcher, NullLogger and StdErrLogger; RO.KeyVariable.CmdVar and KeyVarFactory; RO.PVT; RO.PgSQLUtil.FieldDescr; RO.Prefs.PrefEditor; RO.Prefs.PrefVar.PrefVar, PrefSet and ColorUpdate; RO.Wdg.CtxMenu; RO.Wdg.GrayImageDispWdg.Annotation; RO.Wdg.Gridder; RO.InputCont.BasicFmt, BasicContListFmt and VMSQualFmt; RO.Wdg.IsCurrentMixin and AutoIsCurrentMixin; RO.Wdg.SeverityMixin; RO.Wdg.Sound.BellPlay, SoundPlay and NoPlay; RO.Wdg.Toplevel.ToplevelSet; RO.Wdg.WdgPrefs.WdgPrefs.
• Fixed nonfunctional assert statements (assert (cond) -> assert cond) in:
  • RO.Alg.OrderedDict test code
  • RO.PgSQLUtil.insertRow
  • RO.SeqUtil test code
  • RO.StringUtil.splitDMSStr

2005-05-24

• RO.CnvUtil: added StrCnvNoCase.
• RO.Comm.FTPGet: modified to not check for "file exists" until download starts; the old behavior made error checking too messy.
• RO.DS9: added doRaise argument to xpaget, xpaset and DS9Win; the default is False so the default behavior has changed.
• RO.InputCont.BasicFmt: removed the obsolete omitHidden argument that was being ignored. Use blankIfDisabled, instead, or write your own format function.
• RO.Wdg.Checkbutton: bug fix: setBool ignored isCurrent and severity.
• Ro.Wdg.Entry: improved the default appearance and behavior of read-only widgets. The insertion cursor is now hidden and there is no longer any special highlighting to indicate that the widget has focus.

2005-04-26

• RO.Alg: added ReverseOrderedDict.
• RO.Wdg.FTPLogWdg: added support for callbacks to getFile.
• RO.Wdg.GrayImageDispWdg (still in progress but now quite usable). Major improvements! Too extensive to list here; see the doc string.
• RO.Wdg.RadiobuttonSet: added support for bitmaps.
• Added directory RO.Wdg.Resources to contain bitmaps used by RO.Wdg.GrayImageDispWdg. Since these are not python files you may find you have to do some extra steps to package executables that use the RO package.
• RO.procFiles:
  • Continue on error; report traceback unless RuntimeError.
  • Removed use of (deprecated) xreadlines in docs.
  • bug fix: was setting outPath to "" instead of outDir if outFile="".

• RO.Astro.Cnv.CoordConv: bug fix: conversions requiring a App Topo<->Observed step were broken (thanks to Emmanouil Angelakis for the report).
• RO.KeyVariable: bug fix: in an error occurred early in instantiation, formatting the exception message failed because there was no self.actor.

2005-01-28

• RO.Wdg: added isCurrent and severity support, as implemented in RO.Wdg.Label, to a number of additional widgets.
  • Added RO.Wdg.IsCurrentMixin, a set of mixin classes that allow widgets to have an isCurrent flag and display a suitable background color when not current. AutoIsCurrentMixin also allows input widgets to automatically display not-current when their value is not the default value (indicating that the user has changed something).
  • Added RO.Wdg.SeverityMixin, a set of mixin classes that allow widgets to have a state (one of RO.Constants.sevNormal, sevWarning or sevError) and display a suitable foreground color.
  • Enhanced the following classes to use these new mixin classes, including autoIsCurrent support where it makes sense (all but Label):
    • RO.Wdg.Checkbutton
    • RO.Wdg.Entry
    • RO.Wdg.Label (no new functionality, but see incompatible changes below)
    • RO.Wdg.OptionMenu
  • This change produced the following incompatible changes:
    • RO.Constants.st_Normal, st_Warning and st_Error renamed to sevNormal, sevWarning and sevError.
    • RO.Wdg.Label.set() now uses the argument "severity" instead of "state", and setState() was renamed to setSeverity().
    • RO.Wdg.StatusBar.setMsg() now uses the argument "severity" instead of "level".
• RO.Wdg.ModalDialogBase major overhaul:
  • Combined the apply and validate methods into setResult.
  • The buttons method now receives the button's master as an argument. Buttons now have their own frame so you can pack or grid them as you prefer.
  • The buttons method is now called before the body method. Also, the default buttons (OK and Cancel) are now RO.Wdg.Buttons. These changes allow one to add help text to the default buttons in the body method (by setting their helpText attribute).
  • Modified to restore original focus and to generally work more like the example in Welch's Practical Programming in Tcl and Tk.
• RO.ScriptRunner: added a basic debug mode which prints messages as the script runs and prevents commands from going out over the network.
• RO.Wdg.WdgPrefs: added two new prefs to prefDict: "Active Background Color" and "Bad Active Background". These are automatically computed from "Background Color" and "Bad Background"; they should not be set by users.

• RO.Astro.Cnv.coordConv and RO.Astro.Sph.coordConv bug fix: mis-computing proper motion.
• RO.Wdg.GrayImageViewer bug fix; was sorting the input data.

2004-12-13

• RO.DS9 bug fix: the 2004-12-01 version was missing the code that waited for DS9 to launch.
• RO.Wdg.GrayImageDispWdg enhanced, but still very preliminary.
• RO.InputCont overhauled:
  • Made ContList a subclass of WdgCont to clean up the code.
  • WdgCont modified to be like ContList in the following ways:
    • restoreDefault and setValueDict now make just one callback,instead of one callback per input container.
    • Added removeCallback.
  • Renamed doEnable to setEnable to match RO.Wdg widgets.
  • Eliminated formatNow argument (it was not being used and was broken).
• RO.Wdg.InputContFrame: added removeCallback; added callNow argument to addCallback.
• RO.Wdg.OptionButton: renamed doEnable to setEnable to match RO.Wdg widgets.
• RO.Wdg.RadioButtonSet: renamed doEnable to setEnable to match RO.Wdg widgets.

2004-12-01

• RO.DS9
  • Bug fix in xpaset: if data does not end in \n, an \n is appended. This fixes an incompatily with older versions. Warning: dataFunc must supply a final \n if needed; fortunately when sending array data (the main use for which dataFunc was envisioned), a final \n does not appear to be needed.
  • Modified to use the subprocess module (one is supplied from RO.Future if your python is too old to have one).
• RO.Future.subprocess added, so one can safely use subprocess with older versions of Python.
• RO.Wdg.GrayImageDispWdg added: a preliminary implementation of a grayscale image viewer. It is not yet imported into RO.Wdg (that will be done once it is released).
• RO.Wdg.OptionMenu: rearranged a few methods into alphabetical order.
• RO.Wdg.ScrolledWdg: corrected a doc string error.
• RO.Wdg.StatusConfigGridder: ConfigCat is now a class constant.

2004-11-19

• Bug fix in RO.Comm.GetFile: was downloading binary files as text files. Fixed by explicitly sending TYPE I or TYPE A before any transfer.

2004-11-18

• RO.Comm.GetFile renamed to RO.Comm.FTPGet; the UI changed because I started using ftplib instead of urllib to avoid a bug in urllib, and so only ftp is now supported.
• RO.Wdg.Checkbutton: more sensible defaults; if showValue true then defaults to indicatoron false. If indicatoron false then defaults to padx = 5, pady = 2.
• RO.Wdg.FTPLogWdg: getFile arguments overhauled to match the changes in RO.Comm.GetFile -> RO.Comm.FTPGet mentioned above.
• RO.Wdg.Label: renamed method _setStatus to setStatus (it is a useful public method).

2004-11-04

• Improved RO.DS9 as follows:
  • Improved Mac compatibility (formerly required ds9 to be on the $PATH. Now DS9 first looks for ds9.app in ~/Applications and /Applications, then looks on the $PATH. Note: this means MacOS X users cannot put ds9.app "just anywhere" unless they also make a link from somewhere on their path to ds9.app/ds9.
  • Added Windows compatibility (but showArray is broken, probably due to a bug in ds9 3.0.3).
  • Changed order of indices for 3-d images from (y,x,z) to (z,y,x).
  • loadFITSFile no longer tests the file name's extension.
  • Eliminated showBinFile because I could not get it to work; this seems to be an bug or documentation bug in ds9
  • Bug fix: could only communicate with one ds9; fixed by specifying port=0 when opening ds9.
• RO.Wdg.PatchedCanvas: the corrections applied by this module are no longer needed and have been disabled. This module now issues a deprecation warning when used, and really doesn't do anything else. Please use Tkinter.Canvas instead.

2004-10-13

• New modules:
  • RO.Comm.BrowseURL: opens a URL in the user's default web browser. The launching is done in a background thread.
  • RO.Constants: centralize widely used RO.Wdg constants. includes state constants have a prefix st_: st_Normal, st_Warning, st_Error.
  • RO.ScriptRunner and RO.Wdg.ScriptWdg: executes python scripts that can simply ask to wait for things to happen without tying up the event loop. This saves the script author from having to explicitly worry about asynchronous programming and writing a tangle of callback funcions. This has proven so useful that my application user interface now makes heavy use of it internally.
  • RO.Wdg.Text added to simplify read-only and contextual menu support.
  • RO.Wdg.TkUtil: implements colorOK and getWindowingSystem.
• Other changes:
  • RO.Comm.TkSocket now works at the tcl level using fileevents and tcl sockets. This fixes a Windows incompatibility.
  • RO.CnvUtil: added asBoolOrNone
  • RO.InputCont.ContList: the callback gets the entire ContList, not just the changed container(s), and only one callback is issued for setValueDict and restoreDefault, rather than one callback per container.
  • RO.KeyDispatcher: many improvements, including: Pending commands are aborted when disconnected. Improved the multitasking while refreshing variables and checking for command timouts. Added _replyCmdVar method to unify the sending of replies to command variables. No longer issues regular KeyVariable updates while disconnected.
  • RO.Prefs.PrefVar: DirectoryPrefVar and FilePrefVar modified to have no text entry field. This solves a focus infinite loop issue: if the user typed in an invalid value and then tried to use Choose..., the dialog box would never get focus because the edit field would take it back. This left the user no choice but to close the dialog box.
  • RO.Wdg changes:
    • The contextual menu for editable RO.Wdg widgets now includes Cut, Copy, Clear, Paste and Select All (read-only widgets only have Copy).
    • RO.Wdg.CmdReplyWdg: added support for the command message callback to report an error. Renamed event callbacks with leading _ to indicate they are internal functions. Deleted the old and redundant method showCmd.
    • RO.Wdg.CtxMenu changes:
      • Renamed AddCtxMenu to addCtxMenu, since it is a function.
      • Changed ctxShowHelp so that if a file: URL with an anchor cannot be loaded, it tries the same URL with the anchor stripped. This works around a limitation in MacOS X and possibly other platforms. (Note: in some earlier versions of MacOS X the anchor was silently ignored, but in 10.3.3 the file is not found.)
      • CtxMenu no longer checks if the widget already has a contextual menu. This was done to allow RO.Wdg.StatusBar to inherit from CtxMenuMixin.
      • Help url base handling moved to new RO.Wdg.Constants module.
    • RO.Wdg.Entry:
      • DMSEntry: added unitsSuffix (for velocity).
      • Removed DirectoryEntry and FileEntry. Dir and file preferences no longer use entry widgets (see RO.Prefs item below), so they are no longer useful.
    • Renamed RO.Wdg.ScriptWindow to RO.Wdg.PythonWdg to better reflect what it does and to avoid confusion with the new RO.ScriptRunner and RO.Wdg.ScriptWdg modules. Also modified to add a contextual menu.
    • RO.Wdg.StatusBar changes:
      • No longer shows informational messages while executing commands. Just showns warnings, errors and completion. This was done to make the display easier to read.
      • Added a helpText argument. Warning: if specified, this prevents the status bar from trying to show help and entry errors for other widgets in the same toplevel. helpText is typically only specified if you have more than one status bar in a toplevel, in which case one status bar should show help (as usual) and the others should have helpText strings (and thus not show help).
      • Inherits from RO.Wdg.CtxMenu, making it easier to customize its contextual menu.
      • Message levels documented to use RO.Wdg.st_Normal, st_Warning and st_Error constants. The numerical values have not changed, so old code will still work.
    • Renamed RO.Wdg.PythonTk to RO.Wdg.PythonTk for the same reason.
    • RO.Wdg.Toplevel closeMode constants now have prefix tl_: tl_CloseDestroys, tl_CloseWithdraws, tl_CloseDisabled
    • RO.Wdg.WdgPrefs: handles internal RO.Wdg prefs. This combines code that was formerly in RO.Wdg.Label and RO.Wdg.CxtMenu.
• Bug fixes:
  • RO.AddCallback: used sys and traceback for error reporting but did not import them.
  • RO.Comm.TkSocket: fixed documentation for setReadCallback.
  • RO.Comm.TCPConnection: fixed documentation for addReadCallback and addStateCallback.
  • RO.Entry.DMSEntry: units for relative dms fields had ' and " swapped.
  • RO.KeyVariable: major overhaul, including renaming KeyVar to CmdVar, adding abort capability and adding refreshOptional argument to KeyVarFactory.
  • RO.Wdg.RadiobuttonSet fixes:
    • set and setDefault could reject valid values and set invalid values because they were checking the new value against textList (the list of button names) not valueList (the list of button values).
    • The module was using importing RO.AddCallback but not importing it.
  • RO.Wdg.Toplevel fixes:
    • If wdgFunc fails, Toplevel propogates the error. As a result, ToplevelSet.createToplevel no longer creates an erroneous entry to a nonexistent toplevel if wdgFunc fails.
    • Toplevels that were distroyed were not handled well. Now getToplevel returns None if a toplevel has been destroyed (or does not exist). Also, a name can be reused if the old toplevel has been destroyed.

2004-05-21

• Overhauled DS9 so it can talk to multiple copies (e.g. windows) by name. Added the ability to launch copies of ds9 automatically as needed. Added xpaget.
• Fixed the following bugs (most found by pychecker):
  • RO.Comm.GetFile and RO.Wdg.StatusBar: used sys.stderr to report some errors but did not import sys.
  • RO.SeqUtil: flatten was called flattenList in a few places, breaking the flatten function.
  • RO.Wdg.CmdReplyWdg: did not create self.cmdText if helpURL not supplied.
  • RO.Wdg.Toplevel.ToplevelSet: referred to defGeomFixDict instead of defGeomVisDict

2004-04-30

• Added xpaset to DS9. This can be used to display regions, etc.

2004-04-21

• Fixed some bugs in DS9.showArray (x and y axes sizes were swapped and it failed for any integral type except Int32) and made it more flexible (it will now accept any type of array so long as the data is in range of Int32).

2004-04-16

• Added the DS9 module for displaying images in the ds9 image viewer.

2004-02-06

• Combined RO.OS.walkDirs and RO.OS.expandPathList into RO.OS.findFiles.
• Modified RO.procFiles to take advantage of RO.OS.findFiles. Arguments have changed.
• Fixed a bug in RO.procFiles that caused specifying an output file to fail.

2004-02-05

• Added functions to RO.OS including getPrefsDir.
• Modified RO.KeyDispatcher.logMsg to make it easier to use; the changes are not backwards compatible.
• Fixed a bug in RO.Prefs.DirectoryPrefVar that prevented the Choose... button from working.

Russell Owen
University of Washington
PO Box 351580
Seattle, WA 98195-1580
rowen u washington edu
     @ .          .