Re: [OpenSwarm-users] Who wants to test setup for next release?

SourceForge Headquarters 1320 Columbia Street Suite 310 San Diego, CA 92101 +1 (858) 422-6466

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Anastasios Hatzis wrote:
> Hi @all,
> 
> I have changed OpenSwarm installation to distutils setup for the next 
> release (0.6.2).
> 
> Anybody here who wants to test if the new setup works on other OS than W32?
> 
> I can provide source distribution (sdist) and a Windows installer 
> (bdist_wininst). Would be great, if someone could try to install from 
> sources or create a bdist for GNU/Linux or other platforms from sources.
> 
> Anastasios

I've tested installing OpenSwarm on a GNU/Linux box. I even created a
binary distribution for Debian based systems. However since I am using
Python 2.4, I could not create the deb package with bdist (read on the
web that it has been added in Python 2.5.

The installation was relatively painless, but I make some suggestions
which should be taken as _suggestions_!

I created a report in reStructuredText format (so you can easily create
a PDF version or whatever using docutils. It is pretty long. Hope you
like it :)

=============================
OpenSwarm 0.6.2: Setup Report
=============================

:Author: Tryggvi Björgvinsson <try...@hi...>

General
>>>>>>>

The purpose of this setup was to try to install OpenSwarm on a gNewSense
GNU/Linux system, with Python 2.4.3. The following two approaches were
tested:

1. Install directly from source, run test cases
2. Create a debian package, install and run test cases

Setup
>>>>>

3rd party software
- ------------------

As OpenSwarm has not been installed on the test machine before, 3rd
party software was installed first. Following packages were installed
using ``APT``:

* PostgreSQL: ``postgresql-8.1 postgresql-plpython-8.1``
* pgAdminIII: ``pgadmin3``
* mxDateTime: ``python2.4-egenix-mxdatetime`` (Already installed)
* pypgsql: ``python-pgsql`` (Already installed)
* pyxml: ``python2.4-xml`` (Already installed)

OpenSwarm Sources
- -----------------

Installation
............

Successfully installed OpenSwarm using: ``python setup.py install``

Testing
.......

**$ sdk-view.py** - Success!::

  OpenSwarm SDK Preferences

  Loaded from INI: /usr/lib/python2.4/site-packages/OpenSwarm/sdk.ini

  GUI
  Default *.osp directory   : /usr/projects
  Default apps directory    : /usr/projects
  Default *.xml directory   : /usr/projects
  Show tipps on GUI start-up: True

  LOGFILE
  Log-file activated    : True
  Default log-file      : /usr/projects/logs/generation.log
  Default log-file level: DEBUG
  Default log format    : %(asctime)s %(name)-10s %(levelname)-8s
%(message)s
  Default log timestamp : %y-%m-%d %H:%M:%S

  CONSOLE
  Console logging format : %(name)-10s: %(levelname)-8s %(message)s

**$ sdk-edit.py --tips-hide** - Failed!::

  Traceback (most recent call last):
    File "/usr/bin/sdk-edit.py", line 117, in ?
      ScriptHandler().readOpts()
    File "/usr/bin/sdk-edit.py", line 113, in readOpts
      consoleFormat=self.consoleFormat, logfile=self.logfile,
loglevel=self.logLevel, logname=self.logName, logformat=self.logFormat,
logtime=self.logTime)
    File
"/usr/lib/python2.4/site-packages/OpenSwarm/sdklib/cmd_sdk_edit.py",
line 118, in run
      sdk.save()
    File
"/usr/lib/python2.4/site-packages/OpenSwarm/sdklib/preferences.py", line
184, in save
      oStream = codecs.open(OpenSwarm.SDK_INI_LOC, 'w', OpenSwarm.SDK_UTF)
    File "/usr/lib/python2.4/codecs.py", line 666, in open
     file = __builtin__.open(filename, mode, buffering)
  IOError: [Errno 13] Permission denied:
u'/usr/lib/python2.4/site-packages/Open  Swarm/sdk.ini'

**$ sudo sdk-edit.py --tips-hide** - Success!::

  OpenSwarm SDK Preferences

  Loaded from INI: /usr/lib/python2.4/site-packages/OpenSwarm/sdk.ini

  GUI
  Default *.osp directory   : /usr/projects
  Default apps directory    : /usr/projects
  Default *.xml directory   : /usr/projects
  Show tipps on GUI start-up: False

  LOGFILE
  Log-file activated    : True
  Default log-file      : /usr/projects/logs/generation.log
  Default log-file level: DEBUG
  Default log format    : %(asctime)s %(name)-10s %(levelname)-8s
%(message)s
  Default log timestamp : %y-%m-%d %H:%M:%S

  CONSOLE
  Console logging format : %(name)-10s: %(levelname)-8s %(message)s

**$ osp-view.py /usr/projects/test1.osp** - Success!::

  OpenSwarm Project Settings

  OSP file     : /usr/projects/test1.osp
  OSP version  : 0.6.2-dev
  Last changed : 2007-03-05 15:08:04
  OSP generator: OpenSwarm SDK 0.6.2-dev

  Project name :

  XMI: D:\OpenSwarm\SVN\src\patterns\models\PetStore\PetStore.xml
  Application  :

  Console logging
  Format       : None

  Log-file configuration
  Activated    : True
  Location     : None
  Log-level    : None
  Record format: None
  Time format  : None

**$ osp-edit.py /usr/projects/test1.osp -n** - Success!::

  OpenSwarm Project Settings

  OSP file     : /usr/projects/test1.osp
  OSP version  : 0.6.2-dev
  Last changed : 2007-03-12 12:49:36
  OSP generator: OpenSwarm SDK 0.6.2-dev

  Project name :

  XMI: D:\OpenSwarm\SVN\src\patterns\models\PetStore\PetStore.xml
  Application  :

  Console logging
  Format       : None

  Log-file configuration
  Activated    : False
  Location     : None
  Log-level    : None
  Record format: None
  Time format  : None

Debian binary file
- ------------------

Creation
........

The following steps were needed to create a debian binary package:

1. Rename directory from OpenSwarmSDK-0.6.2-dev to openswarmsdk-0.6.2

2. ``$ dh_make -n -s -e try...@hi...``::

     Maintainer name : Tryggvi Björgvinsson
     Email-Address   : try...@hi...
     Date            : Mon, 12 Mar 2007 13:25:51 +0000
     Package Name    : openswarmsdk
     Version         : 0.6.2
     License         : blank
     Type of Package : Single
     Hit <enter> to confirm:
     Currently there is no top level Makefile. This may require
additional tuning.
     Done. Please edit the files in the debian/ subdirectory now. You
should also
     check that the openswarmsdk Makefiles install into $DESTDIR and not
in / .

3. Create a top level Makefile::

     PACKAGE = openswarmsdk
     VERSION = 0.6.2
     PYTHON_BIN = /usr/bin/python
     INSTALL_BIN = /usr/bin/install -m0644

     DEBFILES = \
         debian/changelog \
         debian/compat \
         debian/copyright \
         debian/control \
         debian/rules \
         debian/files \

     EXTRA_DIST = \
         OpenSwarm/AUTHORS.TXT OpenSwarm/CHANGES.TXT \
         OpenSwarm/README.TXT OpenSwarm/LICENSE.TXT

     DISTFILES = \
         Makefile $(DEBFILES) $(EXTRA_DIST)

     all: module

     module:
             $(PYTHON_BIN) setup.py build

     install: module
             $(PYTHON_BIN) setup.py install `test -n "$(DESTDIR)" &&
echo --root $(DESTDIR)`

     clean:
             rm -fr build debian/openswarmsdk debian/DEBIAN
configure-stamp build-stamp *.pyc

     distclean: realclean
             rm -f $(PACKAGE)-$(VERSION).tar.gz

     dist:   mkdir -p $(PACKAGE)-$(VERSION)
             for file in $(DISTFILES); do \
               $(INSTALL_BIN) -D $$file $(PACKAGE)-$(VERSION)/$$file; \
             done
             tar czf $(PACKAGE)-$(VERSION).tar.gz $(PACKAGE)-$(VERSION)
             test -d $(PACKAGE)-$(VERSION) && rm -fr $(PACKAGE)-$(VERSION)

     deb:
             fakeroot dpkg-buildpackage

4. ``rm debian/*.ex debian/*.EX``

5. Modify ``debian/control`` and ``debian/copyright``

6. ``$ fakeroot debian/rules clean``

7. ``debian/rules build``

8. ``fakeroot debian/rules binary``

Installation
............

Successfully installed OpenSwarm using: ``$ sudo dpkg -i
openswarmsdk_0.6.2_i386.deb``

Testing
.......

**$ sdk-view.py** - Success!::

  OpenSwarm SDK Preferences

  Loaded from INI: /usr/lib/python2.4/site-packages/OpenSwarm/sdk.ini

  GUI
  Default *.osp directory   : /usr/projects
  Default apps directory    : /usr/projects
  Default *.xml directory   : /usr/projects
  Show tipps on GUI start-up: True

  LOGFILE
  Log-file activated    : True
  Default log-file      : /usr/projects/logs/generation.log
  Default log-file level: DEBUG
  Default log format    : %(asctime)s %(name)-10s %(levelname)-8s
%(message)s
  Default log timestamp : %y-%m-%d %H:%M:%S

  CONSOLE
  Console logging format : %(name)-10s: %(levelname)-8s %(message)s

**$ sudo sdk-edit.py --tips-hide** - Success!::

  OpenSwarm SDK Preferences

  Loaded from INI: /usr/lib/python2.4/site-packages/OpenSwarm/sdk.ini

  GUI
  Default *.osp directory   : /usr/projects
  Default apps directory    : /usr/projects
  Default *.xml directory   : /usr/projects
  Show tipps on GUI start-up: False

  LOGFILE
  Log-file activated    : True
  Default log-file      : /usr/projects/logs/generation.log
  Default log-file level: DEBUG
  Default log format    : %(asctime)s %(name)-10s %(levelname)-8s
%(message)s
  Default log timestamp : %y-%m-%d %H:%M:%S

  CONSOLE
  Console logging format : %(name)-10s: %(levelname)-8s %(message)s

**$ osp-view.py /usr/projects/test1.osp** - Success!::

  OpenSwarm Project Settings

  OSP file     : /usr/projects/test1.osp
  OSP version  : 0.6.2-dev
  Last changed : 2007-03-05 15:08:04
  OSP generator: OpenSwarm SDK 0.6.2-dev

  Project name :

  XMI: D:\OpenSwarm\SVN\src\patterns\models\PetStore\PetStore.xml
  Application  :

  Console logging
  Format       : None

  Log-file configuration
  Activated    : True
  Location     : None
  Log-level    : None
  Record format: None
  Time format  : None

**$ osp-edit.py /usr/projects/test1.osp -n** - Success!::

  OpenSwarm Project Settings

  OSP file     : /usr/projects/test1.osp
  OSP version  : 0.6.2-dev
  Last changed : 2007-03-12 12:49:36
  OSP generator: OpenSwarm SDK 0.6.2-dev

  Project name :

  XMI: D:\OpenSwarm\SVN\src\patterns\models\PetStore\PetStore.xml
  Application  :

  Console logging
  Format       : None

  Log-file configuration
  Activated    : False
  Location     : None
  Log-level    : None
  Record format: None
  Time format  : None

Proposed TODO list
>>>>>>>>>>>>>>>>>>

- From the setup test, I propose a short TODO list below. Please take the
list as a suggestions.

* Fix spelling error in sdk-view.py: ``tipps`` -> ``tips``

* I do **not** like that the projects folder gets installed into
``/usr``. I propose that it
  should not get installed at all, but should be easily accessible from
the project's website
  instead.

* Rename OpenSwarmSDK-0.6.2-dev to openswarmsdk-0.6.2 to make deb
package creation simpler.

* Most importantly, go through how Debian package was created in this
report and comment. The
  author has never created a Debian package nor Makefile before so it is
wise to get a comment
  from an experienced Debian packager.

* Rename sdk-view.py and sdk-edit.py. These names are IMHO bad as they
do not indicate which
  software they belong to. A simple ``os-`` or ``openswarm-`` prefix
should do the trick. I
  would however find that a simple *frontend* program (e.g. openswarm)
should do the trick.
  This program would combine the four different programs which could be
executed as follows.

  - sdk-view.py: openswarm --sdk --view
  - sdk-edit.py: openswarm --sdk --edit
  - osp-view.py: openswarm --view
  - osp-edit.py: openswarm --edit

-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.2.2 (GNU/Linux)

iD8DBQFF9Y7QTfUwC3N5Fj0RAvw3AJ9lW1QtAtMRsu36UCTYTAzK4w4ovwCgyKdJ
Bis0/xmHRxHI3RZOM5AJZ1k=
=YExF
-----END PGP SIGNATURE-----