[ Home Page ] [ Eiffel Archive ] [ Eiffel Classes and Clusters]

GOTE: GTK+ Objects To Eiffel Converter

Version 1.9

ISE Eiffel 4.5
04 December 1999 .
GNU General Public License.

gote_0_4.tar.gz (247,000 bytes) - source code
Sam@OConnor.net Sam O'Connor (maintainer) mail address.

Readme

The GOTE converter. It converts GTK+ Objects To Eiffel. REL0_4

Copyright Sam O'Connor 1999. Sam@OConnor.net
http://sam.oconnor.net/gote.html
$Id: README,v 1.9 1999/12/04 23:17:55 sam Exp $

This is very pre release, I'm putting it in CVS now because I hope some of it may be useful. Expect to see it change a fair bit soon and please send me your ideas and changes.

The GOTE converter (The GTK+ Objects To Eiffel converter) automaticaly generates external C access features for Eiffel. It works by analysing C header files and generating corresponding Eiffel code, no human intervention is required. At the moment it works quite well with the GTK+ headers as input. For GTK it generates Eiffel classes corresponding to the GTK classes complete with mirrored inheritance structure, polymorphism and type conversion. For vanila C code, wrappers are generated for enums, function prototypes and structs (read/write/create). I hope to seperate the GTK specific stuff from the more general C stuff soon to make it more widely useful.

The GOTE works with ISE Eiffel 4.5.

I would very much appreciate any comments, suggestions, patches etc. Especialy from anyone who has ideas on what would be required to get it to work on other Eiffel compilers.

Latest version:

cvs -d :pserver:cvs@cvs.debian.org:/cvs/eiflib co eiflibs/gote
(login first with empty password)

The next version is under development at:
cvs -d :pserver:cvs@cvs.debian.org:/cvs/eiflib co eiflibs/gote -r DEVEL

Files

GOTE converter source is in this directory.
Files that become part of the output library are in "static".
The generated output plus the static files end up in "gel".
Test program is in "test".

Howto

Only works on ISE Eiffel as far as I know
Check Ace.ace to set up local paths.
To compile using the included scanners and parsers:
- Just pointer your compiler to Ace.ace
Or to generate the scanners and parsers:
- Have gelex & geyacc in your path.
- Type make, then complie from Ace.ace
To run: gote /usr/local/include/gtk/gtk.h You should get a gel directory full of classes after a while.
To test: In the test directory compile gel.c (gcc -c gel.c)
Check the Ace file to make sure it will find everything ok run the compiler

TODO

Make code generation more modular to ease porting to different compilers.
Run this stuff through ispell :)
Find a way to get rid of the nasty hack in STRING_EDITOR that calls sed OR come up with a rationale along the lines of: this is a unix program, unix programs should call other unix programs to get stuff done, i have to call gcc anyway, anyone who hasn't got sed should upgrage thier OS
s/nasty_hacked_code/elegant_engineered_code/
Use gobo for everything to make small e people happy (Or ask a gobo guru to port my code for me)
Parse out information about events from gtk source. Determine what slots each widget should have and provide features to add commands to slots, order them etc. Build a drop in mashaler that passes the gtk signals to the appropriate slots when event happen.
load macros names, put them in a c file each wrapped in a c function. run the preprocessor to get the expanded code. Analyse the code to determine the return type and or argument type (a bit tricky). Mabey a "works mostly" heuristic would be better that a full blown C scanner/parser. Mabey we can just pull the full blown C scanner/parser out of something else. (gcc?)
Review code and find more things to do.

Release Notes

REL0_4 - Unions in structs and arrays in structs handled better.
REL0_3 - Structs access classes now include externals to access sub structs. GtkObject access classes now inherit object struct access features.
REL0_2 Better support for structs, get and set features for members, size feature and malloc feature for creating new structs.
REL0_1 - First release tag, see CVS logs for prior changes.

License

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

See file "licence" for more information.

Sam O'Connor: Sam@OConnor.net
Homepage: http://sam.oconnor.net/gote.html
04 December 1999 (Added to Eiffel Forum Archive: 23 December 1999)

[ Home Page ] [ Eiffel Archive ] [ Eiffel Classes and Clusters]