Index: /tags/ipp-1-X/rel-0_16/glueforge/.cvsignore =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/.cvsignore (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/.cvsignore (revision 22030) @@ -0,0 +1,11 @@ +Makefile +Makefile.in +aclocal.m4 +configure +autom4te.cache +config.log +config.status +install-sh +missing +glueforge +glueforge.1 Index: /tags/ipp-1-X/rel-0_16/glueforge/INSTALL =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/INSTALL (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/INSTALL (revision 22030) @@ -0,0 +1,95 @@ +# $Id: INSTALL,v 1.6 2006-01-11 02:12:34 jhoblitt Exp $ + +Using the glueforge meta-database API generator +-- + +- Step 0 + +Setup your shell's environment for Pan-STARRS CVS. If you need help setting up +CVS please see this article: + + http://pan-starrs.ifa.hawaii.edu/project/resources/ps-cvs.html + +- Step 1 + +Install the PS:IPP::Metadata::Config and Template modules. + +# PS:IPP::Metadata::Config +$ cvs co PS-IPP-Metadata-Config +$ cd PS-IPP-Metadata-Config +$ perl Build.PL +$ ./Build +$ ./Build test +# if you have sudo +$ sudo ./Build install +# if not +$ su +$ ./Build install + +# Template +# if you have sudo +$ sudo perl -MCPAN -e 'install Template' +# if not +$ su - +$ perl -MCPAN -e 'install Template' + +If you have never used CPAN before you will be given a series of prompts to +configure the module. + +- Step 2 + +Checkout the glueforge module from Pan-STARRS CVS and build it. If you need +help setting up CVS please see this article: + + http://pan-starrs.ifa.hawaii.edu/project/resources/ps-cvs.html + +$ cvs co glueforge +$ cd glueforge +$ ./autogen.sh +$ make + +- Step 3 + +Create a MetadataConfig file that describes the table you want to access. The +MetadataConfig file syntax is described in the pslib SDRS. glueforge specific +details are included in the "glueforge" man page. For reference, both a simple +and complex config example is provided in the examples directory. + +$ perldoc glueforge + +or + +$ man glueforge + +$ cat examples/simple.md + +or + +$ cat examples/complex.md + +- Step 4 + +Generate the database bindings with the "glueforge" executable. The example +simple.md file will generate code under the directory "foodb". + +$./glueforge -t templates/psdb -i examples/simple.md +$ cd foodb + +- Step 5 + +Package the software for distribution. This is the same as for any 'standard' +autotools package. Please note that you must have pslib installed for the step +to complete. If you need help installing pslib please see this article: + + http://pan-starrs.ifa.hawaii.edu/project/IPP/software/jhbuild/ + +$ jhbuild shell +$ ./autogen.sh && make dist + +This should generate two packages suitable for distribution. + +$ ls -la foodb-* +-rw-r--r-- 1 jhoblitt users 216367 Jul 28 17:54 foodb-0.0.1.tar.bz2 +-rw-r--r-- 1 jhoblitt users 324926 Jul 28 17:54 foodb-0.0.1.tar.gz + +The End. Index: /tags/ipp-1-X/rel-0_16/glueforge/Makefile.am =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/Makefile.am (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/Makefile.am (revision 22030) @@ -0,0 +1,35 @@ +SUBDIRS = templates/psdb templates/latex + +bin_SCRIPTS = glueforge +CLEANFILES = $(bin_SCRIPTS) + +do_subst = sed \ + -e 's,[@]datadir[@],$(datadir),g' \ + -e 's,[@]PACKAGE_NAME[@],$(PACKAGE_NAME),g' \ + -e 's,[@]PACKAGE_VERSION[@],$(PACKAGE_VERSION),g' + +glueforge: glueforge.in + $(do_subst) < $(srcdir)/glueforge.in > glueforge + chmod +x glueforge + +example_files = \ + examples/simple.md \ + examples/complex.md + +glueforgedatadir = $(datadir)/@PACKAGE_NAME@ +exampledir = $(glueforgedatadir)/examples +example_DATA = $(example_files) + +install-data-local: + -chmod 0755 $(glueforgedatadir) $(exampledir) + +man_MANS = \ + $(top_builddir)/@PACKAGE_NAME@.1 + +@PACKAGE@.1: glueforge + $(POD2MAN) glueforge > @PACKAGE@.1 + +clean-local: + -rm -rf docs @PACKAGE@.1 + +EXTRA_DIST = autogen.sh glueforge.in $(example_files) Index: /tags/ipp-1-X/rel-0_16/glueforge/autogen.sh =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/autogen.sh (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/autogen.sh (revision 22030) @@ -0,0 +1,103 @@ +#!/bin/sh +# Run this to generate all the initial makefiles, etc. + +srcdir=`dirname $0` +test -z "$srcdir" && srcdir=. + +ORIGDIR=`pwd` +cd $srcdir + +PROJECT=glueforge +TEST_TYPE=-f +# change this to be a unique filename in the top level dir +FILE=autogen.sh + +DIE=0 + +LIBTOOLIZE=libtoolize +ACLOCAL=aclocal +AUTOHEADER=autoheader +AUTOMAKE=automake +AUTOCONF=autoconf + +#($LIBTOOLIZE --version) < /dev/null > /dev/null 2>&1 || { +# echo +# echo "You must have $LIBTOOlIZE installed to compile $PROJECT." +# echo "Download the appropriate package for your distribution," +# echo "or get the source tarball at http://ftp.gnu.org/gnu/libtool/" +# DIE=1 +#} + +($ACLOCAL --version) < /dev/null > /dev/null 2>&1 || { + echo + echo "You must have $ACLOCAL installed to compile $PROJECT." + echo "Download the appropriate package for your distribution," + echo "or get the source tarball at http://ftp.gnu.org/gnu/automake/" + DIE=1 +} + +#($AUTOHEADER --version) < /dev/null > /dev/null 2>&1 || { +# echo +# echo "You must have $AUTOHEADER installed to compile $PROJECT." +# echo "Download the appropriate package for your distribution," +# echo "or get the source tarball at http://ftp.gnu.org/gnu/autoconf/" +# DIE=1 +#} + +($AUTOMAKE --version) < /dev/null > /dev/null 2>&1 || { + echo + echo "You must have $AUTOMAKE installed to compile $PROJECT." + echo "Download the appropriate package for your distribution," + echo "or get the source tarball at http://ftp.gnu.org/gnu/automake/" + DIE=1 +} + +($AUTOCONF --version) < /dev/null > /dev/null 2>&1 || { + echo + echo "You must have $AUTOCONF installed to compile $PROJECT." + echo "Download the appropriate package for your distribution," + echo "or get the source tarball at http://ftp.gnu.org/gnu/autoconf/" + DIE=1 +} + +if test "$DIE" -eq 1; then + exit 1 +fi + +test $TEST_TYPE $FILE || { + echo "You must run this script in the top-level $PROJECT directory" + exit 1 +} + +if test -z "$*"; then + echo "I am going to run ./configure with no arguments - if you wish " + echo "to pass any to it, please specify them on the $0 command line." +fi + +#$LIBTOOLIZE --copy --force || echo "$LIBTOOlIZE failed" +$ACLOCAL -I m4 || echo "$ACLOCAL failed" +#$AUTOHEADER || echo "$AUTOHEADER failed" +$AUTOMAKE --add-missing --force-missing --copy || echo "$AUTOMAKE failed" +$AUTOCONF || echo "$AUTOCONF failed" + +cd $ORIGDIR + +run_configure=true +for arg in $*; do + case $arg in + --no-configure) + run_configure=false + ;; + *) + ;; + esac +done + +if $run_configure; then + $srcdir/configure --enable-maintainer-mode "$@" + echo + echo "Now type 'make' to compile $PROJECT." +else + echo + echo "Now run 'configure' and 'make' to compile $PROJECT." +fi Index: /tags/ipp-1-X/rel-0_16/glueforge/configure.ac =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/configure.ac (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/configure.ac (revision 22030) @@ -0,0 +1,31 @@ +AC_PREREQ(2.59) + +AC_INIT([glueforge], [0.16], [jhoblitt@cpan.org]) +AC_CONFIG_SRCDIR([glueforge.in]) + +AM_INIT_AUTOMAKE([1.6 foreign dist-bzip2]) +AM_MAINTAINER_MODE + +AC_PROG_INSTALL + +AC_PROG_PERL_MODULES( + [PS::IPP::Metadata::Config], , + [AC_MSG_ERROR(perl module PS::IPP::Metadata::Config is required)] +) + +AC_PROG_PERL_MODULES( + [Template], , + [AC_MSG_ERROR(perl module Template is required)] +) + +AC_PATH_PROG([POD2MAN], [pod2man], [missing]) +if test "$POD2MAN" = "missing" ; then + AC_MSG_ERROR([pod2man is required]) +fi + +AC_CONFIG_FILES([ + Makefile + templates/latex/Makefile + templates/psdb/Makefile +]) +AC_OUTPUT Index: /tags/ipp-1-X/rel-0_16/glueforge/examples/complex.md =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/examples/complex.md (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/examples/complex.md (revision 22030) @@ -0,0 +1,20 @@ +glueforge METADATA + pkg_name STR foodb + pkg_namespace STR foo +END + +foo METADATA + foo STR 60 # Primary Key # the name of foo thing + bar S32 0 ## count of bar + baz F32 0.0 + boing F64 0.0 + zot BOOL t # Key +END + +bar METADATA + zot BOOL t # Key + boing F64 0.0 + baz F32 0.0 + bar S32 0 ## count of bar + foo STR 60 # Primary Key # the name of foo thing +END Index: /tags/ipp-1-X/rel-0_16/glueforge/examples/simple.md =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/examples/simple.md (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/examples/simple.md (revision 22030) @@ -0,0 +1,6 @@ +table STR foo +foo STR 60 # Primary Key # the name of foo thing +bar S32 0 ## count of bar +baz F32 0.0 +boing F64 0.0 +zot BOOL t # Key Index: /tags/ipp-1-X/rel-0_16/glueforge/glueforge.in =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/glueforge.in (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/glueforge.in (revision 22030) @@ -0,0 +1,477 @@ +#!/usr/bin/env perl + +# Copyright (C) 2005-2006 Joshua Hoblitt +# +# $Id: glueforge.in,v 1.48 2006-02-22 02:30:09 jhoblitt Exp $ + +use strict; +use warnings FATAL => qw( all ); + +use vars qw( $VERSION ); +$VERSION = '@PACKAGE_VERSION@'; + +use PS::IPP::Metadata::Config; +use Template; + +use Getopt::Long qw( GetOptions :config auto_help auto_version ); +use Pod::Usage qw( pod2usage ); + +my ( $input, $output, $template ); +GetOptions( + 'input=s' => \$input, + 'output=s' => \$output, + 'template=s' => \$template, +) || pod2usage( 2 ); + +pod2usage( -msg => "Unknown option: @ARGV", -exitval => 2 ) if @ARGV; +pod2usage( -msg => "Required option: --input|-i", -exitval => 2 ) unless $input; + +$template = "@datadir@/@PACKAGE_NAME@/templates/psdb" unless $template; + +die "file doesn't exist: $input" unless -e $input; +die "file isn't readable: $input" unless -r $input; + +my $config = parse_config( $input ); + +die "file doesn't not contain a valid config" unless defined $config->[0]; + +# if the first hash has a class of "metadata" then this is a complex config. +# Otherwise it is a simple config. +my $complex = ($config->[0]->{class} eq "metadata") ? 1 : 0; + +my $data; # hashref +if ($complex) { + $data = complex_config($config); +} else { + $data = simple_config($config); +} + +# determine output path +$output = $data->{pkg_name} unless defined $output; + +my $ttconfig; +{ + # slurp config.pl + open(my $fh, "$template/config.pl") + or die "can't open $template/config.pl: $!"; + $ttconfig = do {local $/; <$fh>}; + close($fh) or die "can't close $template/config.pl: $!"; +} + +# configure template file paths +my %tt; +eval $ttconfig; +die "can't eval contents of $template/config.pl: $@" if $@; + +my $mangler = Template->new({ INCLUDE_PATH => $template, EVAL_PERL => 1 }); + +foreach my $t ( keys %tt ) { + $mangler->process( $t, $data, $tt{$t}) + or die $mangler->error; +} + +# make autogen.sh executable +# permissions are in octal +#chmod 0744, $tt{'autogen_sh.tt'}; + +sub parse_config { + my $file = shift; + + my $mdparser = PS::IPP::Metadata::Config->new; + $mdparser->overwrite( 1 ); + + open( my $data, $file ) or die "can't open file: $!"; + my $example = do { local $/; <$data> }; + close( $data ) or die "can't close file: $!"; + + my $config = $mdparser->parse( $example ) + or die "error parsing file: $input"; + + return $config; +} + +sub lookup_type { + my $type = shift; + + my %primitives = map { $_ => 1 } qw( S8 S16 S32 S64 U8 U16 U32 U64 F32 F64 ); + my %mtypes = map { $_ => "PS_DATA_$_" } keys %primitives; + my %ctypes = map { $_ => "ps$_" } keys %primitives; + + my %ttypes = ( + S8 => -8, + S16 => -16, + S32 => -32, + S64 => -64, + U8 => 8, + U16 => 16, + U32 => 32, + U64 => 64, + F32 => 32.32, + F64 => 64.64, + ); + + if ( $primitives{$type} ) { + return { + ctype => $ctypes{$type}, + mtype => $mtypes{$type}, + test => $ttypes{$type}, + }; + } elsif ( $type =~ /STR|STRING/ ) { + return { + ctype => "char*", + mtype => 'PS_DATA_STR', + test => '"a string"', + }; + } elsif ( $type =~ /BOOL/ ) { + return { + ctype => "bool", + mtype => 'PS_DATA_BOOL', + test => 'true', + }; + } else { + return undef; + } +} + +sub simple_config { + my $config = shift; + + # find table name + my $table_name; + for (my $i = 0; $i < @{$config}; $i++) { + my $elem = $config->[$i]; + + if ( $elem->{name} eq "table" ) { + $table_name = $elem->{value}; + + # delete element from array + splice @$config, $i, 1; + + last; + } + } + + my %data; + + # global data + $data{pkg_name} = $table_name . "db"; + $data{pkg_namespace} = $table_name; + + # per table data + my %table; + $table{name} = $table_name; + $table{namespace} = $table_name; + $table{object_name} = $table{namespace} . "Row"; + + my @items; + + # setup items + for (my $i = 0; $i < @{$config}; $i++) { + my $elem = $config->[$i]; + + my $mdtypes = lookup_type( $elem->{type} ); + next if ! defined $mdtypes; + + push @items, { + name => $elem->{name}, + type => $elem->{type}, + ctype => $mdtypes->{ctype}, + mtype => $mdtypes->{mtype}, + test => $mdtypes->{test}, + comment => $elem->{comment}, + value => $elem->{value}, + }; + } + + $table{columns} = \@items; + $data{tables} = [ \%table ]; + + return \%data; +} + +sub complex_config { + my $config = shift; + + # find the glueforge metadata + my $glueforge_meta; + for (my $i = 0; $i < @{$config}; $i++) { + my $elem = $config->[$i]; + + if ($elem->{name} eq "glueforge") { + $glueforge_meta = $elem; + + # delete element from array + splice @$config, $i, 1; + + last; + } + } + + # global data + + my ($pkg_name, $pkg_namespace); + unless (defined $glueforge_meta) { + # set default values + warn "missing glueforge METADATA, using default values"; + $pkg_name = "foodb"; + $pkg_namespace = "foo"; + } else { + # process glueforge metadata for global data + + foreach my $item (@{$glueforge_meta->{value}}) { + if ($item->{name} eq 'pkg_name') { + $pkg_name = $item->{value}; + } elsif ($item->{name} eq 'pkg_namespace') { + $pkg_namespace = $item->{value}; + } else { + die "invalid glueforge METADATA key: $item->{name}"; + } + } + } + + die "pkg_name is required in complex config" unless defined $pkg_name; + die "pkg_namespace is required in complex config" unless defined + $pkg_namespace; + + my %data; + $data{pkg_name} = $pkg_name; + $data{pkg_namespace} = $pkg_namespace; + + # setup one table per nested metadata + my @tables; + foreach my $meta (@{$config}) { + push @tables, tabledata_from_meta($meta); + } + + $data{tables} = \@tables; + + return \%data; +} + +sub tabledata_from_meta { + my $meta = shift; # hashref + + die "not a valid metadata" unless $meta->{class} eq 'metadata'; + + my $table_name = $meta->{name}; + + my @fields; + foreach my $column (@{$meta->{value}}) { + my $mdtypes = lookup_type( $column->{type} ); + next if not defined $mdtypes; + + push @fields, { + name => $column->{name}, + type => $column->{type}, + ctype => $mdtypes->{ctype}, + mtype => $mdtypes->{mtype}, + test => $mdtypes->{test}, + comment => $column->{comment}, + value => $column->{value}, + }; + } + + my %table = ( + name => $table_name, + namespace => $table_name, + object_name => $table_name . "Row", + columns => \@fields, + ); + + return \%table; +} + +__END__ + +=pod + +=head1 NAME + +@PACKAGE_NAME@ - auto-generate Pan-STARRS IPP 'meta' database bindings + +=head1 SYNOPSIS + + @PACKAGE_NAME@ --input [--output ] [--template ] + +=head1 DESCRIPTION + +This program generates a set of database table format specific bindings in the +ANSI C language. The code generated is largely just wrapper functions around +the C C API. Table information is read in from a configuration +file in the pslib C format. A complete autotools configured +package that builds both static & shared libraries is generated. + +=head2 Features + +=over 4 + +=item * Generates a complete autoconf/automake/libtool package. + +=item * Generated packages include an C script. + +=item * Installs a pkgconfig C<.pc> data file. + +=item * Includes a table format specific autotest test suite. + +=item * Builds both shared and static libraries by default. + +=item * Generates man pages and HTML documentation with Doxygen. + +=item * Header files should be C++ safe. + +=item * Functions to open and close database connections. + +=item * Functions to create and destroy a table of the appropriate format. + +=item * Functions to insert and pop a row. + +=item * Functions to insert and pop a simple object representing a row. + +=item * Functions to insert, select, and pop to/from FITS files. + +=item * Functions to convert between row structs and pslib Cs. + +=back + +=head1 TABLE DESCRIPTION FORMAT + +There are two slightly different configuration file forms. A C format +for describing a single table and a C format for describing more then +one table and/or configuring specific details as to how the package is +generated. The syntax for both of these forms follows the C format as described in C. + +=head2 Simple configuration + +A simple config file specifies the name of the table, the name and types of all +columns, and can optionally specify which column(s) are to be used as indexes. + +=head2 Example simple configuration + + table STR foo + foo STR 60 # Primary Key # the name of foo thing + bar S32 0 ## count of bar + baz F32 0.0 + boing F64 0.0 + zot BOOL t # Key + +The key name C is reserved and specifies the name of the database table. +It may appear any where in the file but it is most I to have it as +the first line of the table description. + +The key name C is reserved and I be used. + +The value of a C column specifies the maximum number of characters that +the database is required to store for that field. The values for C, +C, C, & C columns are ignored. + +Indexes maybe specified as comment value of either C or C. +Only one C may be specified per table. + +Description comments may specified as either a C<# ...> after an index +specifier or as stand alone comment value of C<## ...>. + +The key name C is also reserved as it is used internally by the +database bindings. + +=head2 Complex configuration + +A complex config file consists of a series of C blocks. One (and +only one) of these blocks I be named C. This block +contains the global package configuration data. Only the keys C and +C are allowed in this block and they are both required. + +All other C blocks describe a single table with the name of the +C block being the tables name. Otherwise, the format of items +contained in a C block is the same as for the simple configuration. + +Note that nested C blocks are not allowed. + +=head2 Example complex configuration + +glueforge METADATA + pkg_name STR foodb + pkg_namespace STR foo +END + +foo METADATA + foo STR 60 # Primary Key # the name of foo thing + bar S32 0 ## count of bar + baz F32 0.0 + boing F64 0.0 + zot BOOL t # Key +END + +bar METADATA + zot BOOL t # Key + boing F64 0.0 + baz F32 0.0 + bar S32 0 ## count of bar + foo STR 60 # Primary Key # the name of foo thing +END + +=head1 OPTIONS + +=over 4 + +=item * --input|-i + +File to read table description from. + +=item * --output|-o + +Send the generate files to this directory name. + +Defaults to the name of the database table. + +=item * --template|-t + +Directory to load template files from. + +Defaults to C<@datadir@/@PACKAGE_NAME@/templates/psdb>. + +=back + +=head1 BUGS + +The format of configuration files is not rigorously checked. Improperly +formatted files may not be caught and cause random (possibly silent) errors +and/or improperly code generation. + +=head1 CREDITS + +Just me, myself, and I. + +=head1 SUPPORT + +Please contact the author directly via e-mail. + +=head1 AUTHOR + +Joshua Hoblitt + +=head1 COPYRIGHT + +Copyright (C) 2005-2006 Joshua Hoblitt. All rights reserved. + +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. + +The full text of the license can be found in the L Pod as supplied +with Perl 5.8.1 and later. + +=head1 SEE ALSO + +C, C. L + +=cut Index: /tags/ipp-1-X/rel-0_16/glueforge/m4/ac_prog_perl_modules.m4 =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/m4/ac_prog_perl_modules.m4 (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/m4/ac_prog_perl_modules.m4 (revision 22030) @@ -0,0 +1,53 @@ +dnl @synopsis AC_PROG_PERL_MODULES([MODULES], [ACTION-IF-TRUE], [ACTION-IF-FALSE]) +dnl +dnl Checks to see if the the given perl modules are available. If true +dnl the shell commands in ACTION-IF-TRUE are executed. If not the shell +dnl commands in ACTION-IF-FALSE are run. Note if $PERL is not set (for +dnl example by calling AC_CHECK_PROG, or AC_PATH_PROG), +dnl AC_CHECK_PROG(PERL, perl, perl) will be run. +dnl +dnl Example: +dnl +dnl AC_CHECK_PERL_MODULES(Text::Wrap Net::LDAP, , +dnl AC_MSG_WARN(Need some Perl modules) +dnl +dnl @category InstalledPackages +dnl @author Dean Povey +dnl @version 2002-09-25 +dnl @license AllPermissive + +AC_DEFUN([AC_PROG_PERL_MODULES],[ + ac_perl_modules="$1" + # Make sure we have perl + if test -z "$PERL"; then + AC_CHECK_PROG(PERL,perl,perl) + fi + + if test "x$PERL" != x; then + ac_perl_modules_failed=0 + for ac_perl_module in $ac_perl_modules; do + AC_MSG_CHECKING(for perl module $ac_perl_module) + + # Would be nice to log result here, but can't rely on autoconf + # internals + $PERL "-M$ac_perl_module" -e exit > /dev/null 2>&1 + if test $? -ne 0; then + AC_MSG_RESULT(no); + ac_perl_modules_failed=1 + else + AC_MSG_RESULT(ok); + fi + done + + # Run optional shell commands + if test "$ac_perl_modules_failed" = 0; then + : + $2 + else + : + $3 + fi + else + AC_MSG_WARN(could not find perl) + fi +]) Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/.cvsignore =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/.cvsignore (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/.cvsignore (revision 22030) @@ -0,0 +1,2 @@ +Makefile +Makefile.in Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/Makefile.am =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/Makefile.am (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/Makefile.am (revision 22030) @@ -0,0 +1,12 @@ +template_files = \ + config.pl \ + tables.tt + +templatedir = $(datadir)/@PACKAGE_NAME@/templates +latextemplatedir = $(templatedir)/latex +latextemplate_DATA = $(template_files) + +install-data-hook: + chmod 0755 $(templatedir) $(latextemplatedir) + +EXTRA_DIST = $(template_files) Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/config.pl =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/config.pl (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/config.pl (revision 22030) @@ -0,0 +1,3 @@ +%tt = ( + 'tables.tt' => "$output/tables.tex", +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/tables.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/tables.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/latex/tables.tt (revision 22030) @@ -0,0 +1,21 @@ +[% FOREACH table = tables -%] +[% PERL %] print "\\clearpage\n\n" if not [% loop.count %] % 10 [% END -%] +\begin{table}[ht] +\begin{center} +\caption{\label{[% table.namespace %]}[% table.namespace.replace('_', '\\_') %]} +\begin{tabular}{|l|l|l|} +\hline +\textbf{name} & \textbf{type} & \textbf{description} \\ +\hline +[% FOREACH item = table.columns -%] +[%- IF item.type == 'STR' -%] +[% item.name.replace('_', '\\_') %] & [% item.type %] (up to [% item.value %] chars) & \parbox[t]{3.0in}{[% item.comment.replace('\#', '') %]} \\ \hline +[% ELSE -%] +[% item.name.replace('_', '\\_') %] & [% item.type %] & \parbox[t]{3.0in}{[% item.comment.replace('\#', '') %]} \\ \hline +[% END -%] +[% END -%] +\end{tabular} +\end{center} +\end{table} + +[% END %] Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/.cvsignore =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/.cvsignore (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/.cvsignore (revision 22030) @@ -0,0 +1,2 @@ +Makefile +Makefile.in Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/Makefile.am =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/Makefile.am (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/Makefile.am (revision 22030) @@ -0,0 +1,92 @@ +template_files = \ + config.pl \ + alloc.tt \ + alloc_at.tt \ + alloc_c.tt \ + alloc_h.tt \ + autogen_sh.tt \ + bootstrap_sh.tt \ + cleanup.tt \ + cleanup_at.tt \ + cleanup_c.tt \ + cleanup_h.tt \ + code.tt \ + configure_ac.tt \ + createtable.tt \ + createtable_at.tt \ + createtable_c.tt \ + createtable_h.tt \ + dbcleanup_c.tt \ + dbsetup_c.tt \ + delete.tt \ + delete_h.tt \ + deleterowobjects.tt \ + deleterowobjects_h.tt \ + doxyfile_in.tt \ + droptable.tt \ + droptable_at.tt \ + droptable_c.tt \ + droptable_h.tt \ + header.tt \ + init.tt \ + init_at.tt \ + init_c.tt \ + init_h.tt \ + insert.tt \ + insert_at.tt \ + insert_c.tt \ + insert_h.tt \ + insertfits.tt \ + insertfits_at.tt \ + insertfits_c.tt \ + insertfits_h.tt \ + insertobject.tt \ + insertobject_at.tt \ + insertobject_c.tt \ + insertobject_h.tt \ + makefile.tt \ + metadatafromobject.tt \ + metadatafromobject_at.tt \ + metadatafromobject_c.tt \ + metadatafromobject_h.tt \ + object_h.tt \ + objectfrommetadata.tt \ + objectfrommetadata_at.tt \ + objectfrommetadata_c.tt \ + objectfrommetadata_h.tt \ + pkgconfig_pc_in.tt \ + pop.tt \ + pop_at.tt \ + pop_c.tt \ + pop_h.tt \ + popfits.tt \ + popfits_at.tt \ + popfits_c.tt \ + popfits_h.tt \ + popobject.tt \ + popobject_at.tt \ + popobject_c.tt \ + popobject_h.tt \ + printmetadatas.tt \ + printmetadatas_h.tt \ + printobjects.tt \ + printobjects_h.tt \ + selectrowobjects.tt \ + selectrowobjects_h.tt \ + selectrowsfits.tt \ + selectrowsfits_at.tt \ + selectrowsfits_c.tt \ + selectrowsfits_h.tt \ + src_makefile_am.tt \ + tests_makefile_am.tt \ + testsuite_at.tt \ + top_makefile_am.tt + +templatedir = $(datadir)/@PACKAGE_NAME@/templates +psdbtemplatedir = $(templatedir)/psdb +psdbtemplate_DATA = $(template_files) + +install-data-hook: + chmod 0755 $(templatedir) $(psdbtemplatedir) + +EXTRA_DIST = $(template_files) Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc.tt (revision 22030) @@ -0,0 +1,40 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +static void [% table.object_name %]Free([% table.object_name %] *object); + +[% table.object_name %] *[% table.object_name %]Alloc( +[%- SET i = 0 -%] +[% FOREACH item = table.columns -%] +[% IF i == 0 %][% i = 1 %][% ELSE %], [% END -%] +[% IF item.type == "STR" -%] +const char *[% item.name %] +[%- ELSE -%] +[% item.ctype %] [% item.name %] +[%- END -%] +[% END -%] +) +{ + [% indented(table.object_name, "*object") %]; + + object = psAlloc(sizeof([% table.object_name %])); + psMemSetDeallocator(object, (psFreeFunc)[% table.object_name %]Free); + +[% FOREACH item = table.columns -%] +[% IF item.type == "STR" -%] + object->[% item.name %] = psStringCopy([% item.name %]); +[% ELSE -%] + object->[% item.name %] = [% item.name %]; +[% END -%] +[% END -%] + + return object; +} + +static void [% table.object_name %]Free([% table.object_name %] *object) +{ +[% FOREACH item = table.columns -%] +[% IF item.type == "STR" -%] + psFree(object->[% item.name %]); +[% END -%] +[% END -%] +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc_at.tt (revision 22030) @@ -0,0 +1,6 @@ +AT_SETUP([[% table.object_name %]Alloc()]) +AT_KEYWORDS([[% table.object_name %]Alloc]) + +AT_CHECK([alloc]) + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc_c.tt (revision 22030) @@ -0,0 +1,42 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +#include +#include <[% pkg_name %].h> +#include + +#define MAX_STRING_LENGTH 1024 + +int main () +{ +[% FOREACH table = tables -%] + { + [% indented(table.object_name, "*object") %]; + + object = [% table.object_name %]Alloc( +[%- SET i = 0 -%] +[%- FOREACH item = table.columns -%] + [%- IF i == 0 -%][%- i = 1 -%][%- ELSE -%], [% END -%] [%- item.test -%] +[%- END -%] + ); + + if (!object) { + exit(EXIT_FAILURE); + } + +[% FOREACH item = table.columns -%] +[% IF item.type == "S32" or item.type == "F32" or item.type == "F64" or item.type == "BOOL" -%] + if (!object->[% item.name %] == [% item.test %]) { +[% ELSIF item.type == "STR" -%] + if (strncmp(object->[% item.name %], [% item.test %], MAX_STRING_LENGTH)) { +[% END -%] + psFree(object); + exit(EXIT_FAILURE); + } +[% END -%] + + psFree(object); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/alloc_h.tt (revision 22030) @@ -0,0 +1,18 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +/** Creates a new [% table.object_name %] object + * + * @return A new [% table.object_name %] object or NULL on failure. + */ + +[% table.object_name %] *[% table.object_name %]Alloc( +[%- SET i = 0 -%] +[% FOREACH item = table.columns -%] +[% IF i == 0 %][% i = 1 %][% ELSE %],[% END %] +[% IF item.type == "STR" -%] + [% indented("const char", "*$item.name") %] +[%- ELSE -%] + [% indented("$item.ctype", "$item.name") %] +[%- END -%] +[% END %] +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/autogen_sh.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/autogen_sh.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/autogen_sh.tt (revision 22030) @@ -0,0 +1,103 @@ +#!/bin/sh +# Run this to generate all the initial makefiles, etc. + +srcdir=`dirname $0` +test -z "$srcdir" && srcdir=. + +ORIGDIR=`pwd` +cd $srcdir + +PROJECT=[% pkg_name %] +TEST_TYPE=-f +# change this to be a unique filename in the top level dir +FILE=autogen.sh + +DIE=0 + +LIBTOOLIZE=libtoolize +ACLOCAL=aclocal +AUTOHEADER=autoheader +AUTOMAKE=automake +AUTOCONF=autoconf + +($LIBTOOLIZE --version) < /dev/null > /dev/null 2>&1 || { + echo + echo "You must have $LIBTOOlIZE installed to compile $PROJECT." + echo "Download the appropriate package for your distribution," + echo "or get the source tarball at http://ftp.gnu.org/gnu/libtool/" + DIE=1 +} + +($ACLOCAL --version) < /dev/null > /dev/null 2>&1 || { + echo + echo "You must have $ACLOCAL installed to compile $PROJECT." + echo "Download the appropriate package for your distribution," + echo "or get the source tarball at http://ftp.gnu.org/gnu/automake/" + DIE=1 +} + +($AUTOHEADER --version) < /dev/null > /dev/null 2>&1 || { + echo + echo "You must have $AUTOHEADER installed to compile $PROJECT." + echo "Download the appropriate package for your distribution," + echo "or get the source tarball at http://ftp.gnu.org/gnu/autoconf/" + DIE=1 +} + +($AUTOMAKE --version) < /dev/null > /dev/null 2>&1 || { + echo + echo "You must have $AUTOMAKE installed to compile $PROJECT." + echo "Download the appropriate package for your distribution," + echo "or get the source tarball at http://ftp.gnu.org/gnu/automake/" + DIE=1 +} + +($AUTOCONF --version) < /dev/null > /dev/null 2>&1 || { + echo + echo "You must have $AUTOCONF installed to compile $PROJECT." + echo "Download the appropriate package for your distribution," + echo "or get the source tarball at http://ftp.gnu.org/gnu/autoconf/" + DIE=1 +} + +if test "$DIE" -eq 1; then + exit 1 +fi + +test $TEST_TYPE $FILE || { + echo "You must run this script in the top-level $PROJECT directory" + exit 1 +} + +if test -z "$*"; then + echo "I am going to run ./configure with no arguments - if you wish " + echo "to pass any to it, please specify them on the $0 command line." +fi + +$LIBTOOLIZE --copy --force || echo "$LIBTOOlIZE failed" +$ACLOCAL || echo "$ACLOCAL failed" +$AUTOHEADER || echo "$AUTOHEADER failed" +$AUTOMAKE --add-missing --force-missing --copy || echo "$AUTOMAKE failed" +$AUTOCONF || echo "$AUTOCONF failed" + +cd $ORIGDIR + +run_configure=true +for arg in $*; do + case $arg in + --no-configure) + run_configure=false + ;; + *) + ;; + esac +done + +if $run_configure; then + $srcdir/configure --enable-maintainer-mode "$@" + echo + echo "Now type 'make' to compile $PROJECT." +else + echo + echo "Now run 'configure' and 'make' to compile $PROJECT." +fi Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/bootstrap_sh.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/bootstrap_sh.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/bootstrap_sh.tt (revision 22030) @@ -0,0 +1,7 @@ +#!/bin/sh + +libtoolize --automake --copy \ +&& aclocal \ +&& autoheader \ +&& automake --foreign --add-missing --copy \ +&& autoconf Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup.tt (revision 22030) @@ -0,0 +1,4 @@ +void [% pkg_namespace %]Cleanup(psDB *dbh) +{ + psDBCleanup(dbh); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup_at.tt (revision 22030) @@ -0,0 +1,6 @@ +AT_SETUP([[% table.namespace %]Cleanup()]) +AT_KEYWORDS([[% table.namespace %]Cleanup]) + +AT_CHECK([cleanup]) + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup_c.tt (revision 22030) @@ -0,0 +1,17 @@ +#include +#include <[% pkg_name %].h> +#include + +int main () +{ + psDB *dbh; + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + [% pkg_namespace %]Cleanup(dbh); + + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/cleanup_h.tt (revision 22030) @@ -0,0 +1,6 @@ +/** Closes a database connection + */ + +void [% pkg_namespace %]Cleanup( + psDB *dbh ///< Database handle +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/code.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/code.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/code.tt (revision 22030) @@ -0,0 +1,31 @@ +#include + +#include "[% pkg_name %].h" + +[% FOREACH table = tables -%] +#define [% table.namespace FILTER upper %]_TABLE_NAME "[% table.name %]" +#define [% table.namespace FILTER upper %]_INDEX_NAME "position" +[% END -%] +#define MAX_STRING_LENGTH 1024 + +[% INCLUDE init.tt %] +[% INCLUDE cleanup.tt %] +[% INCLUDE printmetadatas.tt %] +[% FOREACH table = tables -%] +[% INCLUDE alloc.tt %] +[% INCLUDE createtable.tt %] +[% INCLUDE droptable.tt %] +[% INCLUDE insert.tt %] +[% INCLUDE delete.tt -%] +[% INCLUDE pop.tt %] +[% INCLUDE insertobject.tt %] +[% INCLUDE popobject.tt %] +[% INCLUDE insertfits.tt %] +[% INCLUDE popfits.tt %] +[% INCLUDE selectrowsfits.tt %] +[% INCLUDE metadatafromobject.tt %] +[% INCLUDE objectfrommetadata.tt -%] +[% INCLUDE selectrowobjects.tt -%] +[% INCLUDE deleterowobjects.tt -%] +[% INCLUDE printobjects.tt -%] +[% END -%] Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/config.pl =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/config.pl (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/config.pl (revision 22030) @@ -0,0 +1,28 @@ +%tt = ( + 'autogen_sh.tt' => "$output/autogen.sh", + 'configure_ac.tt' => "$output/configure.ac", + 'pkgconfig_pc_in.tt' => "$output/$data->{pkg_name}.pc.in", + 'doxyfile_in.tt' => "$output/Doxyfile.in", + 'top_makefile_am.tt' => "$output/Makefile.am", + 'src_makefile_am.tt' => "$output/src/Makefile.am", + 'header.tt' => "$output/src/$data->{pkg_name}.h", + 'code.tt' => "$output/src/$data->{pkg_name}.c", + 'tests_makefile_am.tt' => "$output/tests/Makefile.am", + 'testsuite_at.tt' => "$output/tests/testsuite.at", + 'dbsetup_c.tt' => "$output/tests/dbsetup.c", + 'dbcleanup_c.tt' => "$output/tests/dbcleanup.c", + 'alloc_c.tt' => "$output/tests/alloc.c", + 'init_c.tt' => "$output/tests/init.c", + 'cleanup_c.tt' => "$output/tests/cleanup.c", + 'createtable_c.tt' => "$output/tests/createtable.c", + 'droptable_c.tt' => "$output/tests/droptable.c", + 'insert_c.tt' => "$output/tests/insert.c", + 'pop_c.tt' => "$output/tests/pop.c", + 'insertobject_c.tt' => "$output/tests/insertobject.c", + 'popobject_c.tt' => "$output/tests/popobject.c", + 'insertfits_c.tt' => "$output/tests/insertfits.c", + 'popfits_c.tt' => "$output/tests/popfits.c", + 'selectrowsfits_c.tt' => "$output/tests/selectrowsfits.c", + 'metadatafromobject_c.tt' => "$output/tests/metadatafromobject.c", + 'objectfrommetadata_c.tt' => "$output/tests/objectfrommetadata.c", +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/configure_ac.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/configure_ac.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/configure_ac.tt (revision 22030) @@ -0,0 +1,39 @@ +AC_PREREQ(2.59) + +AC_INIT([[% pkg_name %]], [0.0.1], [pan-starrs.ifa.hawaii.edu]) +AC_CONFIG_SRCDIR([[% pkg_name %].pc.in]) + +AM_INIT_AUTOMAKE([1.6 foreign dist-bzip2]) +AM_CONFIG_HEADER([config.h]) +AM_MAINTAINER_MODE + +AC_CONFIG_TESTDIR([tests]) +AC_CONFIG_FILES([tests/Makefile]) +AM_MISSING_PROG([AUTOM4TE], [autom4te]) + +AC_LANG(C) +AC_PROG_CC +AC_PROG_INSTALL +AC_PROG_LIBTOOL + +PKG_CHECK_MODULES([PSLIB], [pslib >= 0.9.0]) + +AC_PATH_PROG([PERL], [perl], [missing]) +if test "$PERL" = "missing" ; then + AC_MSG_ERROR([perl is required]) +fi + +AC_PATH_PROG([doxygen], [doxygen], [missing]) +AM_CONDITIONAL([DOXYGEN], test "x$doxygen" = "xmissing") + +dnl is this the best was to setup recursive CFLAGS? +[% pkg_name %]_CFLAGS="-Wall -pedantic -std=c99 -fno-strict-aliasing" +AC_SUBST([[% pkg_name %]_CFLAGS]) + +AC_CONFIG_FILES([ + Makefile + src/Makefile + [% pkg_name %].pc + Doxyfile +]) +AC_OUTPUT Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable.tt (revision 22030) @@ -0,0 +1,43 @@ +bool [% table.namespace %]CreateTable(psDB *dbh) +{ + psMetadata *md; + bool status; + + md = psMetadataAlloc(); + if (!psMetadataAdd(md, PS_LIST_TAIL, [% table.namespace FILTER upper %]_INDEX_NAME, PS_DATA_S32, "AUTO_INCREMENT", 0.0)) { + psError(PS_ERR_UNKNOWN, false, "failed to add item %s", [% table.namespace FILTER upper %]_INDEX_NAME); + psFree(md); + return false; + } +[% FOREACH item = table.columns -%] +[% IF item.comment; + SET item.comment = "\"$item.comment\""; +ELSE; + SET item.comment = 'NULL'; +END; +-%] +[% IF item.type == "S32" or item.type == "F32" or item.type == "F64" -%] + if (!psMetadataAdd[% item.type %](md, PS_LIST_TAIL, "[% item.name %]", 0, [% item.comment %], [% item.value %])) { +[% ELSIF item.type == "STR" -%] + if (!psMetadataAddStr(md, PS_LIST_TAIL, "[% item.name %]", 0, [% item.comment %], "[% item.value %]")) { +[% ELSIF item.type == "BOOL" -%] +[% IF item.value == 1; + SET item.value = "true"; +ELSE; + SET item.value = "false"; +END; +-%] + if (!psMetadataAdd(md, PS_LIST_TAIL, "[% item.name %]", PS_DATA_BOOL, [% item.comment %], [% item.value %])) { +[% END -%] + psError(PS_ERR_UNKNOWN, false, "failed to add item [% item.name %]"); + psFree(md); + return false; + } +[% END -%] + + status = psDBCreateTable(dbh, [% table.namespace FILTER upper %]_TABLE_NAME, md); + + psFree(md); + + return status; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable_at.tt (revision 22030) @@ -0,0 +1,9 @@ +AT_SETUP([[% table.namespace %]CreateTable()]) +AT_KEYWORDS([[% table.namespace %]CreateTable]) + +# make sure the table is not there. +AT_CHECK([dbcleanup]) +AT_CHECK([createtable]) +AT_CHECK([dbcleanup]) + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable_c.tt (revision 22030) @@ -0,0 +1,25 @@ +#include +#include <[% pkg_name %].h> +#include + +int main () +{ +[% FOREACH table = tables -%] + { + psDB *dbh; + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + if(![% table.namespace %]CreateTable(dbh)) { + exit(EXIT_FAILURE); + } + + psDBCleanup(dbh); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/createtable_h.tt (revision 22030) @@ -0,0 +1,8 @@ +/** Creates a new [% table.name %] table + * + * @return true on success + */ + +bool [% table.namespace %]CreateTable( + psDB *dbh ///< Database handle +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/dbcleanup_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/dbcleanup_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/dbcleanup_c.tt (revision 22030) @@ -0,0 +1,20 @@ +#include +#include + +int main () +{ + psDB *dbh; + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + +[% FOREACH table = tables -%] + p_psDBRunQuery(dbh, "DROP TABLE IF EXISTS [% table.name %]"); +[% END -%] + + psDBCleanup(dbh); + + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/dbsetup_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/dbsetup_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/dbsetup_c.tt (revision 22030) @@ -0,0 +1,23 @@ +#include +#include <[% pkg_name %].h> +#include + +int main () +{ + psDB *dbh; + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + // remove the table if it already exists +[% FOREACH table = tables -%] + p_psDBRunQuery(dbh, "DROP TABLE IF EXISTS [% table.name %]"); + [% table.namespace %]CreateTable(dbh); + +[% END -%] + psDBCleanup(dbh); + + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/delete.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/delete.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/delete.tt (revision 22030) @@ -0,0 +1,14 @@ +long long [% table.namespace %]Delete(psDB *dbh, const psMetadata *where, unsigned long long limit) +{ + long long deleted = 0; + + long long count = psDBDeleteRows(dbh, [% table.namespace FILTER upper %]_TABLE_NAME, where, limit); + if (count < 0) { + psError(PS_ERR_UNKNOWN, true, "failed to delete row from [% table.namespace %]"); + return count; + + deleted += count; + } + + return deleted; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/delete_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/delete_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/delete_h.tt (revision 22030) @@ -0,0 +1,10 @@ +/** Deletes up to limit rows from the database and returns the number of rows actually deleted. + * + * @return A The number of rows removed or a negative value on error + */ + +long long [% table.namespace %]Delete( + psDB *dbh, ///< Database handle + const psMetadata *where, ///< Row match criteria + unsigned long long limit ///< Maximum number of elements to delete +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/deleterowobjects.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/deleterowobjects.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/deleterowobjects.tt (revision 22030) @@ -0,0 +1,19 @@ +long long [% table.namespace %]DeleteRowObjects(psDB *dbh, const psArray *objects, unsigned long long limit) +{ + long long deleted = 0; + + for (long long i = 0; i < objects->n; i++) { + [% table.object_name %] *object = objects->data[i]; + psMetadata *where = [% table.namespace %]MetadataFromObject(object); + long long count = psDBDeleteRows(dbh, [% table.namespace FILTER upper %]_TABLE_NAME, where, limit); + psFree(where) + if (count < 0) { + psError(PS_ERR_UNKNOWN, true, "failed to delete row from [% table.namespace %]"); + return count; + } + + deleted += count; + } + + return deleted; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/deleterowobjects_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/deleterowobjects_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/deleterowobjects_h.tt (revision 22030) @@ -0,0 +1,13 @@ +/** Deletes up to limit rows from the database and returns the number of rows actually deleted. + * + * Note that a 'where' search psMetadata is constructed from each object and + * used to find rows to delete. + * + * @return A The number of rows removed or a negative value on error + */ + +long long [% table.namespace %]DeleteRowObjects( + psDB *dbh, ///< Database handle + const psArray *objects, ///< Array of objects to delete + unsigned long long limit ///< Maximum number of elements to delete +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/doxyfile_in.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/doxyfile_in.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/doxyfile_in.tt (revision 22030) @@ -0,0 +1,1219 @@ +# Doxyfile 1.4.2 + +# This file describes the settings to be used by the documentation system +# doxygen (www.doxygen.org) for a project +# +# All text after a hash (#) is considered a comment and will be ignored +# The format is: +# TAG = value [value, ...] +# For lists items can also be appended using: +# TAG += value [value, ...] +# Values that contain spaces should be placed between quotes (" ") + +#--------------------------------------------------------------------------- +# Project related configuration options +#--------------------------------------------------------------------------- + +# The PROJECT_NAME tag is a single word (or a sequence of words surrounded +# by quotes) that should identify the project. + +PROJECT_NAME = @PACKAGE_NAME@ + +# The PROJECT_NUMBER tag can be used to enter a project or revision number. +# This could be handy for archiving the generated documentation or +# if some version control system is used. + +PROJECT_NUMBER = @PACKAGE_VERSION@ + +# The OUTPUT_DIRECTORY tag is used to specify the (relative or absolute) +# base path where the generated documentation will be put. +# If a relative path is entered, it will be relative to the location +# where doxygen was started. If left blank the current directory will be used. + +# @top_builddir@ doesn't work for some reason +OUTPUT_DIRECTORY = @builddir@/docs + +# If the CREATE_SUBDIRS tag is set to YES, then doxygen will create +# 4096 sub-directories (in 2 levels) under the output directory of each output +# format and will distribute the generated files over these directories. +# Enabling this option can be useful when feeding doxygen a huge amount of +# source files, where putting all generated files in the same directory would +# otherwise cause performance problems for the file system. + +CREATE_SUBDIRS = NO + +# The OUTPUT_LANGUAGE tag is used to specify the language in which all +# documentation generated by doxygen is written. Doxygen will use this +# information to generate all constant output in the proper language. +# The default language is English, other supported languages are: +# Brazilian, Catalan, Chinese, Chinese-Traditional, Croatian, Czech, Danish, +# Dutch, Finnish, French, German, Greek, Hungarian, Italian, Japanese, +# Japanese-en (Japanese with English messages), Korean, Korean-en, Norwegian, +# Polish, Portuguese, Romanian, Russian, Serbian, Slovak, Slovene, Spanish, +# Swedish, and Ukrainian. + +OUTPUT_LANGUAGE = English + +# This tag can be used to specify the encoding used in the generated output. +# The encoding is not always determined by the language that is chosen, +# but also whether or not the output is meant for Windows or non-Windows users. +# In case there is a difference, setting the USE_WINDOWS_ENCODING tag to YES +# forces the Windows encoding (this is the default for the Windows binary), +# whereas setting the tag to NO uses a Unix-style encoding (the default for +# all platforms other than Windows). + +USE_WINDOWS_ENCODING = NO + +# If the BRIEF_MEMBER_DESC tag is set to YES (the default) Doxygen will +# include brief member descriptions after the members that are listed in +# the file and class documentation (similar to JavaDoc). +# Set to NO to disable this. + +BRIEF_MEMBER_DESC = YES + +# If the REPEAT_BRIEF tag is set to YES (the default) Doxygen will prepend +# the brief description of a member or function before the detailed description. +# Note: if both HIDE_UNDOC_MEMBERS and BRIEF_MEMBER_DESC are set to NO, the +# brief descriptions will be completely suppressed. + +REPEAT_BRIEF = YES + +# This tag implements a quasi-intelligent brief description abbreviator +# that is used to form the text in various listings. Each string +# in this list, if found as the leading text of the brief description, will be +# stripped from the text and the result after processing the whole list, is +# used as the annotated text. Otherwise, the brief description is used as-is. +# If left blank, the following values are used ("$name" is automatically +# replaced with the name of the entity): "The $name class" "The $name widget" +# "The $name file" "is" "provides" "specifies" "contains" +# "represents" "a" "an" "the" + +ABBREVIATE_BRIEF = + +# If the ALWAYS_DETAILED_SEC and REPEAT_BRIEF tags are both set to YES then +# Doxygen will generate a detailed section even if there is only a brief +# description. + +ALWAYS_DETAILED_SEC = NO + +# If the INLINE_INHERITED_MEMB tag is set to YES, doxygen will show all +# inherited members of a class in the documentation of that class as if those +# members were ordinary class members. Constructors, destructors and assignment +# operators of the base classes will not be shown. + +INLINE_INHERITED_MEMB = NO + +# If the FULL_PATH_NAMES tag is set to YES then Doxygen will prepend the full +# path before files name in the file list and in the header files. If set +# to NO the shortest path that makes the file name unique will be used. + +FULL_PATH_NAMES = NO + +# If the FULL_PATH_NAMES tag is set to YES then the STRIP_FROM_PATH tag +# can be used to strip a user-defined part of the path. Stripping is +# only done if one of the specified strings matches the left-hand part of +# the path. The tag can be used to show relative paths in the file list. +# If left blank the directory from which doxygen is run is used as the +# path to strip. + +STRIP_FROM_PATH = + +# The STRIP_FROM_INC_PATH tag can be used to strip a user-defined part of +# the path mentioned in the documentation of a class, which tells +# the reader which header file to include in order to use a class. +# If left blank only the name of the header file containing the class +# definition is used. Otherwise one should specify the include paths that +# are normally passed to the compiler using the -I flag. + +STRIP_FROM_INC_PATH = + +# If the SHORT_NAMES tag is set to YES, doxygen will generate much shorter +# (but less readable) file names. This can be useful is your file systems +# doesn't support long names like on DOS, Mac, or CD-ROM. + +SHORT_NAMES = NO + +# If the JAVADOC_AUTOBRIEF tag is set to YES then Doxygen +# will interpret the first line (until the first dot) of a JavaDoc-style +# comment as the brief description. If set to NO, the JavaDoc +# comments will behave just like the Qt-style comments (thus requiring an +# explicit @brief command for a brief description. + +JAVADOC_AUTOBRIEF = NO + +# The MULTILINE_CPP_IS_BRIEF tag can be set to YES to make Doxygen +# treat a multi-line C++ special comment block (i.e. a block of //! or /// +# comments) as a brief description. This used to be the default behaviour. +# The new default is to treat a multi-line C++ comment block as a detailed +# description. Set this tag to YES if you prefer the old behaviour instead. + +MULTILINE_CPP_IS_BRIEF = NO + +# If the DETAILS_AT_TOP tag is set to YES then Doxygen +# will output the detailed description near the top, like JavaDoc. +# If set to NO, the detailed description appears after the member +# documentation. + +DETAILS_AT_TOP = NO + +# If the INHERIT_DOCS tag is set to YES (the default) then an undocumented +# member inherits the documentation from any documented member that it +# re-implements. + +INHERIT_DOCS = YES + +# If member grouping is used in the documentation and the DISTRIBUTE_GROUP_DOC +# tag is set to YES, then doxygen will reuse the documentation of the first +# member in the group (if any) for the other members of the group. By default +# all members of a group must be documented explicitly. + +DISTRIBUTE_GROUP_DOC = NO + +# If the SEPARATE_MEMBER_PAGES tag is set to YES, then doxygen will produce +# a new page for each member. If set to NO, the documentation of a member will +# be part of the file/class/namespace that contains it. + +SEPARATE_MEMBER_PAGES = NO + +# The TAB_SIZE tag can be used to set the number of spaces in a tab. +# Doxygen uses this value to replace tabs by spaces in code fragments. + +TAB_SIZE = 4 + +# This tag can be used to specify a number of aliases that acts +# as commands in the documentation. An alias has the form "name=value". +# For example adding "sideeffect=\par Side Effects:\n" will allow you to +# put the command \sideeffect (or @sideeffect) in the documentation, which +# will result in a user-defined paragraph with heading "Side Effects:". +# You can put \n's in the value part of an alias to insert newlines. + +ALIASES = + +# Set the OPTIMIZE_OUTPUT_FOR_C tag to YES if your project consists of C +# sources only. Doxygen will then generate output that is more tailored for C. +# For instance, some of the names that are used will be different. The list +# of all members will be omitted, etc. + +OPTIMIZE_OUTPUT_FOR_C = NO + +# Set the OPTIMIZE_OUTPUT_JAVA tag to YES if your project consists of Java sources +# only. Doxygen will then generate output that is more tailored for Java. +# For instance, namespaces will be presented as packages, qualified scopes +# will look different, etc. + +OPTIMIZE_OUTPUT_JAVA = NO + +# Set the SUBGROUPING tag to YES (the default) to allow class member groups of +# the same type (for instance a group of public functions) to be put as a +# subgroup of that type (e.g. under the Public Functions section). Set it to +# NO to prevent subgrouping. Alternatively, this can be done per class using +# the \nosubgrouping command. + +SUBGROUPING = YES + +#--------------------------------------------------------------------------- +# Build related configuration options +#--------------------------------------------------------------------------- + +# If the EXTRACT_ALL tag is set to YES doxygen will assume all entities in +# documentation are documented, even if no documentation was available. +# Private class members and static file members will be hidden unless +# the EXTRACT_PRIVATE and EXTRACT_STATIC tags are set to YES + +EXTRACT_ALL = NO + +# If the EXTRACT_PRIVATE tag is set to YES all private members of a class +# will be included in the documentation. + +EXTRACT_PRIVATE = NO + +# If the EXTRACT_STATIC tag is set to YES all static members of a file +# will be included in the documentation. + +EXTRACT_STATIC = NO + +# If the EXTRACT_LOCAL_CLASSES tag is set to YES classes (and structs) +# defined locally in source files will be included in the documentation. +# If set to NO only classes defined in header files are included. + +EXTRACT_LOCAL_CLASSES = YES + +# This flag is only useful for Objective-C code. When set to YES local +# methods, which are defined in the implementation section but not in +# the interface are included in the documentation. +# If set to NO (the default) only methods in the interface are included. + +EXTRACT_LOCAL_METHODS = NO + +# If the HIDE_UNDOC_MEMBERS tag is set to YES, Doxygen will hide all +# undocumented members of documented classes, files or namespaces. +# If set to NO (the default) these members will be included in the +# various overviews, but no documentation section is generated. +# This option has no effect if EXTRACT_ALL is enabled. + +HIDE_UNDOC_MEMBERS = NO + +# If the HIDE_UNDOC_CLASSES tag is set to YES, Doxygen will hide all +# undocumented classes that are normally visible in the class hierarchy. +# If set to NO (the default) these classes will be included in the various +# overviews. This option has no effect if EXTRACT_ALL is enabled. + +HIDE_UNDOC_CLASSES = NO + +# If the HIDE_FRIEND_COMPOUNDS tag is set to YES, Doxygen will hide all +# friend (class|struct|union) declarations. +# If set to NO (the default) these declarations will be included in the +# documentation. + +HIDE_FRIEND_COMPOUNDS = NO + +# If the HIDE_IN_BODY_DOCS tag is set to YES, Doxygen will hide any +# documentation blocks found inside the body of a function. +# If set to NO (the default) these blocks will be appended to the +# function's detailed documentation block. + +HIDE_IN_BODY_DOCS = NO + +# The INTERNAL_DOCS tag determines if documentation +# that is typed after a \internal command is included. If the tag is set +# to NO (the default) then the documentation will be excluded. +# Set it to YES to include the internal documentation. + +INTERNAL_DOCS = NO + +# If the CASE_SENSE_NAMES tag is set to NO then Doxygen will only generate +# file names in lower-case letters. If set to YES upper-case letters are also +# allowed. This is useful if you have classes or files whose names only differ +# in case and if your file system supports case sensitive file names. Windows +# and Mac users are advised to set this option to NO. + +CASE_SENSE_NAMES = YES + +# If the HIDE_SCOPE_NAMES tag is set to NO (the default) then Doxygen +# will show members with their full class and namespace scopes in the +# documentation. If set to YES the scope will be hidden. + +HIDE_SCOPE_NAMES = NO + +# If the SHOW_INCLUDE_FILES tag is set to YES (the default) then Doxygen +# will put a list of the files that are included by a file in the documentation +# of that file. + +SHOW_INCLUDE_FILES = YES + +# If the INLINE_INFO tag is set to YES (the default) then a tag [inline] +# is inserted in the documentation for inline members. + +INLINE_INFO = YES + +# If the SORT_MEMBER_DOCS tag is set to YES (the default) then doxygen +# will sort the (detailed) documentation of file and class members +# alphabetically by member name. If set to NO the members will appear in +# declaration order. + +SORT_MEMBER_DOCS = YES + +# If the SORT_BRIEF_DOCS tag is set to YES then doxygen will sort the +# brief documentation of file, namespace and class members alphabetically +# by member name. If set to NO (the default) the members will appear in +# declaration order. + +SORT_BRIEF_DOCS = NO + +# If the SORT_BY_SCOPE_NAME tag is set to YES, the class list will be +# sorted by fully-qualified names, including namespaces. If set to +# NO (the default), the class list will be sorted only by class name, +# not including the namespace part. +# Note: This option is not very useful if HIDE_SCOPE_NAMES is set to YES. +# Note: This option applies only to the class list, not to the +# alphabetical list. + +SORT_BY_SCOPE_NAME = NO + +# The GENERATE_TODOLIST tag can be used to enable (YES) or +# disable (NO) the todo list. This list is created by putting \todo +# commands in the documentation. + +GENERATE_TODOLIST = YES + +# The GENERATE_TESTLIST tag can be used to enable (YES) or +# disable (NO) the test list. This list is created by putting \test +# commands in the documentation. + +GENERATE_TESTLIST = YES + +# The GENERATE_BUGLIST tag can be used to enable (YES) or +# disable (NO) the bug list. This list is created by putting \bug +# commands in the documentation. + +GENERATE_BUGLIST = YES + +# The GENERATE_DEPRECATEDLIST tag can be used to enable (YES) or +# disable (NO) the deprecated list. This list is created by putting +# \deprecated commands in the documentation. + +GENERATE_DEPRECATEDLIST= YES + +# The ENABLED_SECTIONS tag can be used to enable conditional +# documentation sections, marked by \if sectionname ... \endif. + +ENABLED_SECTIONS = + +# The MAX_INITIALIZER_LINES tag determines the maximum number of lines +# the initial value of a variable or define consists of for it to appear in +# the documentation. If the initializer consists of more lines than specified +# here it will be hidden. Use a value of 0 to hide initializers completely. +# The appearance of the initializer of individual variables and defines in the +# documentation can be controlled using \showinitializer or \hideinitializer +# command in the documentation regardless of this setting. + +MAX_INITIALIZER_LINES = 30 + +# Set the SHOW_USED_FILES tag to NO to disable the list of files generated +# at the bottom of the documentation of classes and structs. If set to YES the +# list will mention the files that were used to generate the documentation. + +SHOW_USED_FILES = YES + +# If the sources in your project are distributed over multiple directories +# then setting the SHOW_DIRECTORIES tag to YES will show the directory hierarchy +# in the documentation. + +SHOW_DIRECTORIES = YES + +# The FILE_VERSION_FILTER tag can be used to specify a program or script that +# doxygen should invoke to get the current version for each file (typically from the +# version control system). Doxygen will invoke the program by executing (via +# popen()) the command , where is the value of +# the FILE_VERSION_FILTER tag, and is the name of an input file +# provided by doxygen. Whatever the progam writes to standard output +# is used as the file version. See the manual for examples. + +FILE_VERSION_FILTER = + +#--------------------------------------------------------------------------- +# configuration options related to warning and progress messages +#--------------------------------------------------------------------------- + +# The QUIET tag can be used to turn on/off the messages that are generated +# by doxygen. Possible values are YES and NO. If left blank NO is used. + +QUIET = NO + +# The WARNINGS tag can be used to turn on/off the warning messages that are +# generated by doxygen. Possible values are YES and NO. If left blank +# NO is used. + +WARNINGS = YES + +# If WARN_IF_UNDOCUMENTED is set to YES, then doxygen will generate warnings +# for undocumented members. If EXTRACT_ALL is set to YES then this flag will +# automatically be disabled. + +WARN_IF_UNDOCUMENTED = YES + +# If WARN_IF_DOC_ERROR is set to YES, doxygen will generate warnings for +# potential errors in the documentation, such as not documenting some +# parameters in a documented function, or documenting parameters that +# don't exist or using markup commands wrongly. + +WARN_IF_DOC_ERROR = YES + +# This WARN_NO_PARAMDOC option can be abled to get warnings for +# functions that are documented, but have no documentation for their parameters +# or return value. If set to NO (the default) doxygen will only warn about +# wrong or incomplete parameter documentation, but not about the absence of +# documentation. + +WARN_NO_PARAMDOC = NO + +# The WARN_FORMAT tag determines the format of the warning messages that +# doxygen can produce. The string should contain the $file, $line, and $text +# tags, which will be replaced by the file and line number from which the +# warning originated and the warning text. Optionally the format may contain +# $version, which will be replaced by the version of the file (if it could +# be obtained via FILE_VERSION_FILTER) + +WARN_FORMAT = "$file:$line: $text" + +# The WARN_LOGFILE tag can be used to specify a file to which warning +# and error messages should be written. If left blank the output is written +# to stderr. + +WARN_LOGFILE = + +#--------------------------------------------------------------------------- +# configuration options related to the input files +#--------------------------------------------------------------------------- + +# The INPUT tag can be used to specify the files and/or directories that contain +# documented source files. You may enter file names like "myfile.cpp" or +# directories like "/usr/src/myproject". Separate the files or directories +# with spaces. + +INPUT = @top_srcdir@/src + +# If the value of the INPUT tag contains directories, you can use the +# FILE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp +# and *.h) to filter out the source-files in the directories. If left +# blank the following patterns are tested: +# *.c *.cc *.cxx *.cpp *.c++ *.java *.ii *.ixx *.ipp *.i++ *.inl *.h *.hh *.hxx +# *.hpp *.h++ *.idl *.odl *.cs *.php *.php3 *.inc *.m *.mm + +FILE_PATTERNS = *.h + +# The RECURSIVE tag can be used to turn specify whether or not subdirectories +# should be searched for input files as well. Possible values are YES and NO. +# If left blank NO is used. + +RECURSIVE = YES + +# The EXCLUDE tag can be used to specify files and/or directories that should +# excluded from the INPUT source files. This way you can easily exclude a +# subdirectory from a directory tree whose root is specified with the INPUT tag. + +EXCLUDE = + +# The EXCLUDE_SYMLINKS tag can be used select whether or not files or +# directories that are symbolic links (a Unix filesystem feature) are excluded +# from the input. + +EXCLUDE_SYMLINKS = NO + +# If the value of the INPUT tag contains directories, you can use the +# EXCLUDE_PATTERNS tag to specify one or more wildcard patterns to exclude +# certain files from those directories. + +EXCLUDE_PATTERNS = + +# The EXAMPLE_PATH tag can be used to specify one or more files or +# directories that contain example code fragments that are included (see +# the \include command). + +EXAMPLE_PATH = + +# If the value of the EXAMPLE_PATH tag contains directories, you can use the +# EXAMPLE_PATTERNS tag to specify one or more wildcard pattern (like *.cpp +# and *.h) to filter out the source-files in the directories. If left +# blank all files are included. + +EXAMPLE_PATTERNS = + +# If the EXAMPLE_RECURSIVE tag is set to YES then subdirectories will be +# searched for input files to be used with the \include or \dontinclude +# commands irrespective of the value of the RECURSIVE tag. +# Possible values are YES and NO. If left blank NO is used. + +EXAMPLE_RECURSIVE = NO + +# The IMAGE_PATH tag can be used to specify one or more files or +# directories that contain image that are included in the documentation (see +# the \image command). + +IMAGE_PATH = + +# The INPUT_FILTER tag can be used to specify a program that doxygen should +# invoke to filter for each input file. Doxygen will invoke the filter program +# by executing (via popen()) the command , where +# is the value of the INPUT_FILTER tag, and is the name of an +# input file. Doxygen will then use the output that the filter program writes +# to standard output. If FILTER_PATTERNS is specified, this tag will be +# ignored. + +INPUT_FILTER = + +# The FILTER_PATTERNS tag can be used to specify filters on a per file pattern +# basis. Doxygen will compare the file name with each pattern and apply the +# filter if there is a match. The filters are a list of the form: +# pattern=filter (like *.cpp=my_cpp_filter). See INPUT_FILTER for further +# info on how filters are used. If FILTER_PATTERNS is empty, INPUT_FILTER +# is applied to all files. + +FILTER_PATTERNS = + +# If the FILTER_SOURCE_FILES tag is set to YES, the input filter (if set using +# INPUT_FILTER) will be used to filter the input files when producing source +# files to browse (i.e. when SOURCE_BROWSER is set to YES). + +FILTER_SOURCE_FILES = NO + +#--------------------------------------------------------------------------- +# configuration options related to source browsing +#--------------------------------------------------------------------------- + +# If the SOURCE_BROWSER tag is set to YES then a list of source files will +# be generated. Documented entities will be cross-referenced with these sources. +# Note: To get rid of all source code in the generated output, make sure also +# VERBATIM_HEADERS is set to NO. + +SOURCE_BROWSER = NO + +# Setting the INLINE_SOURCES tag to YES will include the body +# of functions and classes directly in the documentation. + +INLINE_SOURCES = NO + +# Setting the STRIP_CODE_COMMENTS tag to YES (the default) will instruct +# doxygen to hide any special comment blocks from generated source code +# fragments. Normal C and C++ comments will always remain visible. + +STRIP_CODE_COMMENTS = YES + +# If the REFERENCED_BY_RELATION tag is set to YES (the default) +# then for each documented function all documented +# functions referencing it will be listed. + +REFERENCED_BY_RELATION = YES + +# If the REFERENCES_RELATION tag is set to YES (the default) +# then for each documented function all documented entities +# called/used by that function will be listed. + +REFERENCES_RELATION = YES + +# If the VERBATIM_HEADERS tag is set to YES (the default) then Doxygen +# will generate a verbatim copy of the header file for each class for +# which an include is specified. Set to NO to disable this. + +VERBATIM_HEADERS = YES + +#--------------------------------------------------------------------------- +# configuration options related to the alphabetical class index +#--------------------------------------------------------------------------- + +# If the ALPHABETICAL_INDEX tag is set to YES, an alphabetical index +# of all compounds will be generated. Enable this if the project +# contains a lot of classes, structs, unions or interfaces. + +ALPHABETICAL_INDEX = NO + +# If the alphabetical index is enabled (see ALPHABETICAL_INDEX) then +# the COLS_IN_ALPHA_INDEX tag can be used to specify the number of columns +# in which this list will be split (can be a number in the range [1..20]) + +COLS_IN_ALPHA_INDEX = 5 + +# In case all classes in a project start with a common prefix, all +# classes will be put under the same header in the alphabetical index. +# The IGNORE_PREFIX tag can be used to specify one or more prefixes that +# should be ignored while generating the index headers. + +IGNORE_PREFIX = + +#--------------------------------------------------------------------------- +# configuration options related to the HTML output +#--------------------------------------------------------------------------- + +# If the GENERATE_HTML tag is set to YES (the default) Doxygen will +# generate HTML output. + +GENERATE_HTML = YES + +# The HTML_OUTPUT tag is used to specify where the HTML docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `html' will be used as the default path. + +HTML_OUTPUT = html + +# The HTML_FILE_EXTENSION tag can be used to specify the file extension for +# each generated HTML page (for example: .htm,.php,.asp). If it is left blank +# doxygen will generate files with .html extension. + +HTML_FILE_EXTENSION = .html + +# The HTML_HEADER tag can be used to specify a personal HTML header for +# each generated HTML page. If it is left blank doxygen will generate a +# standard header. + +HTML_HEADER = + +# The HTML_FOOTER tag can be used to specify a personal HTML footer for +# each generated HTML page. If it is left blank doxygen will generate a +# standard footer. + +HTML_FOOTER = + +# The HTML_STYLESHEET tag can be used to specify a user-defined cascading +# style sheet that is used by each HTML page. It can be used to +# fine-tune the look of the HTML output. If the tag is left blank doxygen +# will generate a default style sheet. Note that doxygen will try to copy +# the style sheet file to the HTML output directory, so don't put your own +# stylesheet in the HTML output directory as well, or it will be erased! + +HTML_STYLESHEET = + +# If the HTML_ALIGN_MEMBERS tag is set to YES, the members of classes, +# files or namespaces will be aligned in HTML using tables. If set to +# NO a bullet list will be used. + +HTML_ALIGN_MEMBERS = YES + +# If the GENERATE_HTMLHELP tag is set to YES, additional index files +# will be generated that can be used as input for tools like the +# Microsoft HTML help workshop to generate a compressed HTML help file (.chm) +# of the generated HTML documentation. + +GENERATE_HTMLHELP = NO + +# If the GENERATE_HTMLHELP tag is set to YES, the CHM_FILE tag can +# be used to specify the file name of the resulting .chm file. You +# can add a path in front of the file if the result should not be +# written to the html output directory. + +CHM_FILE = + +# If the GENERATE_HTMLHELP tag is set to YES, the HHC_LOCATION tag can +# be used to specify the location (absolute path including file name) of +# the HTML help compiler (hhc.exe). If non-empty doxygen will try to run +# the HTML help compiler on the generated index.hhp. + +HHC_LOCATION = + +# If the GENERATE_HTMLHELP tag is set to YES, the GENERATE_CHI flag +# controls if a separate .chi index file is generated (YES) or that +# it should be included in the master .chm file (NO). + +GENERATE_CHI = NO + +# If the GENERATE_HTMLHELP tag is set to YES, the BINARY_TOC flag +# controls whether a binary table of contents is generated (YES) or a +# normal table of contents (NO) in the .chm file. + +BINARY_TOC = NO + +# The TOC_EXPAND flag can be set to YES to add extra items for group members +# to the contents of the HTML help documentation and to the tree view. + +TOC_EXPAND = NO + +# The DISABLE_INDEX tag can be used to turn on/off the condensed index at +# top of each HTML page. The value NO (the default) enables the index and +# the value YES disables it. + +DISABLE_INDEX = NO + +# This tag can be used to set the number of enum values (range [1..20]) +# that doxygen will group on one line in the generated HTML documentation. + +ENUM_VALUES_PER_LINE = 4 + +# If the GENERATE_TREEVIEW tag is set to YES, a side panel will be +# generated containing a tree-like index structure (just like the one that +# is generated for HTML Help). For this to work a browser that supports +# JavaScript, DHTML, CSS and frames is required (for instance Mozilla 1.0+, +# Netscape 6.0+, Internet explorer 5.0+, or Konqueror). Windows users are +# probably better off using the HTML help feature. + +GENERATE_TREEVIEW = NO + +# If the treeview is enabled (see GENERATE_TREEVIEW) then this tag can be +# used to set the initial width (in pixels) of the frame in which the tree +# is shown. + +TREEVIEW_WIDTH = 250 + +#--------------------------------------------------------------------------- +# configuration options related to the LaTeX output +#--------------------------------------------------------------------------- + +# If the GENERATE_LATEX tag is set to YES (the default) Doxygen will +# generate Latex output. + +GENERATE_LATEX = NO + +# The LATEX_OUTPUT tag is used to specify where the LaTeX docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `latex' will be used as the default path. + +LATEX_OUTPUT = latex + +# The LATEX_CMD_NAME tag can be used to specify the LaTeX command name to be +# invoked. If left blank `latex' will be used as the default command name. + +LATEX_CMD_NAME = latex + +# The MAKEINDEX_CMD_NAME tag can be used to specify the command name to +# generate index for LaTeX. If left blank `makeindex' will be used as the +# default command name. + +MAKEINDEX_CMD_NAME = makeindex + +# If the COMPACT_LATEX tag is set to YES Doxygen generates more compact +# LaTeX documents. This may be useful for small projects and may help to +# save some trees in general. + +COMPACT_LATEX = NO + +# The PAPER_TYPE tag can be used to set the paper type that is used +# by the printer. Possible values are: a4, a4wide, letter, legal and +# executive. If left blank a4wide will be used. + +PAPER_TYPE = a4wide + +# The EXTRA_PACKAGES tag can be to specify one or more names of LaTeX +# packages that should be included in the LaTeX output. + +EXTRA_PACKAGES = + +# The LATEX_HEADER tag can be used to specify a personal LaTeX header for +# the generated latex document. The header should contain everything until +# the first chapter. If it is left blank doxygen will generate a +# standard header. Notice: only use this tag if you know what you are doing! + +LATEX_HEADER = + +# If the PDF_HYPERLINKS tag is set to YES, the LaTeX that is generated +# is prepared for conversion to pdf (using ps2pdf). The pdf file will +# contain links (just like the HTML output) instead of page references +# This makes the output suitable for online browsing using a pdf viewer. + +PDF_HYPERLINKS = NO + +# If the USE_PDFLATEX tag is set to YES, pdflatex will be used instead of +# plain latex in the generated Makefile. Set this option to YES to get a +# higher quality PDF documentation. + +USE_PDFLATEX = NO + +# If the LATEX_BATCHMODE tag is set to YES, doxygen will add the \\batchmode. +# command to the generated LaTeX files. This will instruct LaTeX to keep +# running if errors occur, instead of asking the user for help. +# This option is also used when generating formulas in HTML. + +LATEX_BATCHMODE = NO + +# If LATEX_HIDE_INDICES is set to YES then doxygen will not +# include the index chapters (such as File Index, Compound Index, etc.) +# in the output. + +LATEX_HIDE_INDICES = NO + +#--------------------------------------------------------------------------- +# configuration options related to the RTF output +#--------------------------------------------------------------------------- + +# If the GENERATE_RTF tag is set to YES Doxygen will generate RTF output +# The RTF output is optimized for Word 97 and may not look very pretty with +# other RTF readers or editors. + +GENERATE_RTF = NO + +# The RTF_OUTPUT tag is used to specify where the RTF docs will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `rtf' will be used as the default path. + +RTF_OUTPUT = rtf + +# If the COMPACT_RTF tag is set to YES Doxygen generates more compact +# RTF documents. This may be useful for small projects and may help to +# save some trees in general. + +COMPACT_RTF = NO + +# If the RTF_HYPERLINKS tag is set to YES, the RTF that is generated +# will contain hyperlink fields. The RTF file will +# contain links (just like the HTML output) instead of page references. +# This makes the output suitable for online browsing using WORD or other +# programs which support those fields. +# Note: wordpad (write) and others do not support links. + +RTF_HYPERLINKS = NO + +# Load stylesheet definitions from file. Syntax is similar to doxygen's +# config file, i.e. a series of assignments. You only have to provide +# replacements, missing definitions are set to their default value. + +RTF_STYLESHEET_FILE = + +# Set optional variables used in the generation of an rtf document. +# Syntax is similar to doxygen's config file. + +RTF_EXTENSIONS_FILE = + +#--------------------------------------------------------------------------- +# configuration options related to the man page output +#--------------------------------------------------------------------------- + +# If the GENERATE_MAN tag is set to YES (the default) Doxygen will +# generate man pages + +GENERATE_MAN = YES + +# The MAN_OUTPUT tag is used to specify where the man pages will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `man' will be used as the default path. + +MAN_OUTPUT = man + +# The MAN_EXTENSION tag determines the extension that is added to +# the generated man pages (default is the subroutine's section .3) + +MAN_EXTENSION = .3 + +# If the MAN_LINKS tag is set to YES and Doxygen generates man output, +# then it will generate one additional man file for each entity +# documented in the real man page(s). These additional files +# only source the real man page, but without them the man command +# would be unable to find the correct page. The default is NO. + +MAN_LINKS = NO + +#--------------------------------------------------------------------------- +# configuration options related to the XML output +#--------------------------------------------------------------------------- + +# If the GENERATE_XML tag is set to YES Doxygen will +# generate an XML file that captures the structure of +# the code including all documentation. + +GENERATE_XML = NO + +# The XML_OUTPUT tag is used to specify where the XML pages will be put. +# If a relative path is entered the value of OUTPUT_DIRECTORY will be +# put in front of it. If left blank `xml' will be used as the default path. + +XML_OUTPUT = xml + +# The XML_SCHEMA tag can be used to specify an XML schema, +# which can be used by a validating XML parser to check the +# syntax of the XML files. + +XML_SCHEMA = + +# The XML_DTD tag can be used to specify an XML DTD, +# which can be used by a validating XML parser to check the +# syntax of the XML files. + +XML_DTD = + +# If the XML_PROGRAMLISTING tag is set to YES Doxygen will +# dump the program listings (including syntax highlighting +# and cross-referencing information) to the XML output. Note that +# enabling this will significantly increase the size of the XML output. + +XML_PROGRAMLISTING = YES + +#--------------------------------------------------------------------------- +# configuration options for the AutoGen Definitions output +#--------------------------------------------------------------------------- + +# If the GENERATE_AUTOGEN_DEF tag is set to YES Doxygen will +# generate an AutoGen Definitions (see autogen.sf.net) file +# that captures the structure of the code including all +# documentation. Note that this feature is still experimental +# and incomplete at the moment. + +GENERATE_AUTOGEN_DEF = NO + +#--------------------------------------------------------------------------- +# configuration options related to the Perl module output +#--------------------------------------------------------------------------- + +# If the GENERATE_PERLMOD tag is set to YES Doxygen will +# generate a Perl module file that captures the structure of +# the code including all documentation. Note that this +# feature is still experimental and incomplete at the +# moment. + +GENERATE_PERLMOD = NO + +# If the PERLMOD_LATEX tag is set to YES Doxygen will generate +# the necessary Makefile rules, Perl scripts and LaTeX code to be able +# to generate PDF and DVI output from the Perl module output. + +PERLMOD_LATEX = NO + +# If the PERLMOD_PRETTY tag is set to YES the Perl module output will be +# nicely formatted so it can be parsed by a human reader. This is useful +# if you want to understand what is going on. On the other hand, if this +# tag is set to NO the size of the Perl module output will be much smaller +# and Perl will parse it just the same. + +PERLMOD_PRETTY = YES + +# The names of the make variables in the generated doxyrules.make file +# are prefixed with the string contained in PERLMOD_MAKEVAR_PREFIX. +# This is useful so different doxyrules.make files included by the same +# Makefile don't overwrite each other's variables. + +PERLMOD_MAKEVAR_PREFIX = + +#--------------------------------------------------------------------------- +# Configuration options related to the preprocessor +#--------------------------------------------------------------------------- + +# If the ENABLE_PREPROCESSING tag is set to YES (the default) Doxygen will +# evaluate all C-preprocessor directives found in the sources and include +# files. + +ENABLE_PREPROCESSING = YES + +# If the MACRO_EXPANSION tag is set to YES Doxygen will expand all macro +# names in the source code. If set to NO (the default) only conditional +# compilation will be performed. Macro expansion can be done in a controlled +# way by setting EXPAND_ONLY_PREDEF to YES. + +MACRO_EXPANSION = NO + +# If the EXPAND_ONLY_PREDEF and MACRO_EXPANSION tags are both set to YES +# then the macro expansion is limited to the macros specified with the +# PREDEFINED and EXPAND_AS_PREDEFINED tags. + +EXPAND_ONLY_PREDEF = NO + +# If the SEARCH_INCLUDES tag is set to YES (the default) the includes files +# in the INCLUDE_PATH (see below) will be search if a #include is found. + +SEARCH_INCLUDES = YES + +# The INCLUDE_PATH tag can be used to specify one or more directories that +# contain include files that are not input files but should be processed by +# the preprocessor. + +INCLUDE_PATH = + +# You can use the INCLUDE_FILE_PATTERNS tag to specify one or more wildcard +# patterns (like *.h and *.hpp) to filter out the header-files in the +# directories. If left blank, the patterns specified with FILE_PATTERNS will +# be used. + +INCLUDE_FILE_PATTERNS = + +# The PREDEFINED tag can be used to specify one or more macro names that +# are defined before the preprocessor is started (similar to the -D option of +# gcc). The argument of the tag is a list of macros of the form: name +# or name=definition (no spaces). If the definition and the = are +# omitted =1 is assumed. To prevent a macro definition from being +# undefined via #undef or recursively expanded use the := operator +# instead of the = operator. + +PREDEFINED = + +# If the MACRO_EXPANSION and EXPAND_ONLY_PREDEF tags are set to YES then +# this tag can be used to specify a list of macro names that should be expanded. +# The macro definition that is found in the sources will be used. +# Use the PREDEFINED tag if you want to use a different macro definition. + +EXPAND_AS_DEFINED = + +# If the SKIP_FUNCTION_MACROS tag is set to YES (the default) then +# doxygen's preprocessor will remove all function-like macros that are alone +# on a line, have an all uppercase name, and do not end with a semicolon. Such +# function macros are typically used for boiler-plate code, and will confuse +# the parser if not removed. + +SKIP_FUNCTION_MACROS = YES + +#--------------------------------------------------------------------------- +# Configuration::additions related to external references +#--------------------------------------------------------------------------- + +# The TAGFILES option can be used to specify one or more tagfiles. +# Optionally an initial location of the external documentation +# can be added for each tagfile. The format of a tag file without +# this location is as follows: +# TAGFILES = file1 file2 ... +# Adding location for the tag files is done as follows: +# TAGFILES = file1=loc1 "file2 = loc2" ... +# where "loc1" and "loc2" can be relative or absolute paths or +# URLs. If a location is present for each tag, the installdox tool +# does not have to be run to correct the links. +# Note that each tag file must have a unique name +# (where the name does NOT include the path) +# If a tag file is not located in the directory in which doxygen +# is run, you must also specify the path to the tagfile here. + +TAGFILES = + +# When a file name is specified after GENERATE_TAGFILE, doxygen will create +# a tag file that is based on the input files it reads. + +GENERATE_TAGFILE = + +# If the ALLEXTERNALS tag is set to YES all external classes will be listed +# in the class index. If set to NO only the inherited external classes +# will be listed. + +ALLEXTERNALS = NO + +# If the EXTERNAL_GROUPS tag is set to YES all external groups will be listed +# in the modules index. If set to NO, only the current project's groups will +# be listed. + +EXTERNAL_GROUPS = YES + +# The PERL_PATH should be the absolute path and name of the perl script +# interpreter (i.e. the result of `which perl'). + +PERL_PATH = @PERL@ + +#--------------------------------------------------------------------------- +# Configuration options related to the dot tool +#--------------------------------------------------------------------------- + +# If the CLASS_DIAGRAMS tag is set to YES (the default) Doxygen will +# generate a inheritance diagram (in HTML, RTF and LaTeX) for classes with base +# or super classes. Setting the tag to NO turns the diagrams off. Note that +# this option is superseded by the HAVE_DOT option below. This is only a +# fallback. It is recommended to install and use dot, since it yields more +# powerful graphs. + +CLASS_DIAGRAMS = YES + +# If set to YES, the inheritance and collaboration graphs will hide +# inheritance and usage relations if the target is undocumented +# or is not a class. + +HIDE_UNDOC_RELATIONS = YES + +# If you set the HAVE_DOT tag to YES then doxygen will assume the dot tool is +# available from the path. This tool is part of Graphviz, a graph visualization +# toolkit from AT&T and Lucent Bell Labs. The other options in this section +# have no effect if this option is set to NO (the default) + +HAVE_DOT = NO + +# If the CLASS_GRAPH and HAVE_DOT tags are set to YES then doxygen +# will generate a graph for each documented class showing the direct and +# indirect inheritance relations. Setting this tag to YES will force the +# the CLASS_DIAGRAMS tag to NO. + +CLASS_GRAPH = YES + +# If the COLLABORATION_GRAPH and HAVE_DOT tags are set to YES then doxygen +# will generate a graph for each documented class showing the direct and +# indirect implementation dependencies (inheritance, containment, and +# class references variables) of the class with other documented classes. + +COLLABORATION_GRAPH = YES + +# If the GROUP_GRAPHS and HAVE_DOT tags are set to YES then doxygen +# will generate a graph for groups, showing the direct groups dependencies + +GROUP_GRAPHS = YES + +# If the UML_LOOK tag is set to YES doxygen will generate inheritance and +# collaboration diagrams in a style similar to the OMG's Unified Modeling +# Language. + +UML_LOOK = NO + +# If set to YES, the inheritance and collaboration graphs will show the +# relations between templates and their instances. + +TEMPLATE_RELATIONS = NO + +# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDE_GRAPH, and HAVE_DOT +# tags are set to YES then doxygen will generate a graph for each documented +# file showing the direct and indirect include dependencies of the file with +# other documented files. + +INCLUDE_GRAPH = YES + +# If the ENABLE_PREPROCESSING, SEARCH_INCLUDES, INCLUDED_BY_GRAPH, and +# HAVE_DOT tags are set to YES then doxygen will generate a graph for each +# documented header file showing the documented files that directly or +# indirectly include this file. + +INCLUDED_BY_GRAPH = YES + +# If the CALL_GRAPH and HAVE_DOT tags are set to YES then doxygen will +# generate a call dependency graph for every global function or class method. +# Note that enabling this option will significantly increase the time of a run. +# So in most cases it will be better to enable call graphs for selected +# functions only using the \callgraph command. + +CALL_GRAPH = NO + +# If the GRAPHICAL_HIERARCHY and HAVE_DOT tags are set to YES then doxygen +# will graphical hierarchy of all classes instead of a textual one. + +GRAPHICAL_HIERARCHY = YES + +# If the DIRECTORY_GRAPH, SHOW_DIRECTORIES and HAVE_DOT tags are set to YES +# then doxygen will show the dependencies a directory has on other directories +# in a graphical way. The dependency relations are determined by the #include +# relations between the files in the directories. + +DIRECTORY_GRAPH = YES + +# The DOT_IMAGE_FORMAT tag can be used to set the image format of the images +# generated by dot. Possible values are png, jpg, or gif +# If left blank png will be used. + +DOT_IMAGE_FORMAT = png + +# The tag DOT_PATH can be used to specify the path where the dot tool can be +# found. If left blank, it is assumed the dot tool can be found in the path. + +DOT_PATH = + +# The DOTFILE_DIRS tag can be used to specify one or more directories that +# contain dot files that are included in the documentation (see the +# \dotfile command). + +DOTFILE_DIRS = + +# The MAX_DOT_GRAPH_WIDTH tag can be used to set the maximum allowed width +# (in pixels) of the graphs generated by dot. If a graph becomes larger than +# this value, doxygen will try to truncate the graph, so that it fits within +# the specified constraint. Beware that most browsers cannot cope with very +# large images. + +MAX_DOT_GRAPH_WIDTH = 1024 + +# The MAX_DOT_GRAPH_HEIGHT tag can be used to set the maximum allows height +# (in pixels) of the graphs generated by dot. If a graph becomes larger than +# this value, doxygen will try to truncate the graph, so that it fits within +# the specified constraint. Beware that most browsers cannot cope with very +# large images. + +MAX_DOT_GRAPH_HEIGHT = 1024 + +# The MAX_DOT_GRAPH_DEPTH tag can be used to set the maximum depth of the +# graphs generated by dot. A depth value of 3 means that only nodes reachable +# from the root by following a path via at most 3 edges will be shown. Nodes +# that lay further from the root node will be omitted. Note that setting this +# option to 1 or 2 may greatly reduce the computation time needed for large +# code bases. Also note that a graph may be further truncated if the graph's +# image dimensions are not sufficient to fit the graph (see MAX_DOT_GRAPH_WIDTH +# and MAX_DOT_GRAPH_HEIGHT). If 0 is used for the depth value (the default), +# the graph is not depth-constrained. + +MAX_DOT_GRAPH_DEPTH = 0 + +# Set the DOT_TRANSPARENT tag to YES to generate images with a transparent +# background. This is disabled by default, which results in a white background. +# Warning: Depending on the platform used, enabling this option may lead to +# badly anti-aliased labels on the edges of a graph (i.e. they become hard to +# read). + +DOT_TRANSPARENT = NO + +# Set the DOT_MULTI_TARGETS tag to YES allow dot to generate multiple output +# files in one run (i.e. multiple -o and -T options on the command line). This +# makes dot run faster, but since only newer versions of dot (>1.8.10) +# support this, this feature is disabled by default. + +DOT_MULTI_TARGETS = NO + +# If the GENERATE_LEGEND tag is set to YES (the default) Doxygen will +# generate a legend page explaining the meaning of the various boxes and +# arrows in the dot generated graphs. + +GENERATE_LEGEND = YES + +# If the DOT_CLEANUP tag is set to YES (the default) Doxygen will +# remove the intermediate dot files that are used to generate +# the various graphs. + +DOT_CLEANUP = YES + +#--------------------------------------------------------------------------- +# Configuration::additions related to the search engine +#--------------------------------------------------------------------------- + +# The SEARCHENGINE tag specifies whether or not a search engine should be +# used. If set to NO the values of all tags below this one will be ignored. + +SEARCHENGINE = NO Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable.tt (revision 22030) @@ -0,0 +1,4 @@ +bool [% table.namespace %]DropTable(psDB *dbh) +{ + return psDBDropTable(dbh, [% table.namespace FILTER upper %]_TABLE_NAME); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable_at.tt (revision 22030) @@ -0,0 +1,9 @@ +AT_SETUP([[% table.namespace %]DropTable()]) +AT_KEYWORDS([[% table.namespace %]DropTable]) + +# make sure the table is not there. +AT_CHECK([dbsetup]) +AT_CHECK([droptable]) +AT_CHECK([dbcleanup]) + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable_c.tt (revision 22030) @@ -0,0 +1,25 @@ +#include +#include <[% pkg_name %].h> +#include + +int main () +{ +[% FOREACH table = tables -%] + { + psDB *dbh; + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + if (![% table.namespace %]DropTable(dbh)) { + exit(EXIT_FAILURE); + } + + psDBCleanup(dbh); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/droptable_h.tt (revision 22030) @@ -0,0 +1,8 @@ +/** Deletes a [% table.name %] table + * + * @return true on success + */ + +bool [% table.namespace %]DropTable( + psDB *dbh ///< Database handle +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/header.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/header.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/header.tt (revision 22030) @@ -0,0 +1,42 @@ +#ifndef [% pkg_name FILTER upper %]_H +#define [% pkg_name FILTER upper %]_H 1 + +#include + +#ifdef __cplusplus +extern "C" { +#endif + +/// @addtogroup [% pkg_name %] +/// @{ + +[% INCLUDE init_h.tt %] +[% INCLUDE cleanup_h.tt %] +[% INCLUDE printmetadatas_h.tt %] +[% FOREACH table = tables -%] +[% INCLUDE object_h.tt %] +[% INCLUDE alloc_h.tt %] +[% INCLUDE createtable_h.tt %] +[% INCLUDE droptable_h.tt %] +[% INCLUDE insert_h.tt %] +[% INCLUDE delete_h.tt %] +[% INCLUDE pop_h.tt %] +[% INCLUDE insertobject_h.tt %] +[% INCLUDE popobject_h.tt %] +[% INCLUDE insertfits_h.tt %] +[% INCLUDE popfits_h.tt %] +[% INCLUDE selectrowsfits_h.tt %] +[% INCLUDE metadatafromobject_h.tt %] +[% INCLUDE objectfrommetadata_h.tt -%] +[% INCLUDE selectrowobjects_h.tt -%] +[% INCLUDE deleterowobjects_h.tt -%] +[% INCLUDE printobjects_h.tt -%] +[% END -%] + +/// @} + +#ifdef __cplusplus +} +#endif + +#endif // [% table.namespace FILTER upper %]_DB_H Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init.tt (revision 22030) @@ -0,0 +1,4 @@ +psDB *[% pkg_namespace %]Init(const char *host, const char *user, const char *passwd, const char *dbname) +{ + return psDBInit(host, user, passwd, dbname); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init_at.tt (revision 22030) @@ -0,0 +1,6 @@ +AT_SETUP([[% table.namespace %]Init()]) +AT_KEYWORDS([[% table.namespace %]Init]) + +AT_CHECK([init]) + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init_c.tt (revision 22030) @@ -0,0 +1,17 @@ +#include +#include <[% pkg_name %].h> +#include + +int main () +{ + psDB *dbh; + + dbh = [% pkg_namespace %]Init("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + psDBCleanup(dbh); + + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/init_h.tt (revision 22030) @@ -0,0 +1,12 @@ +/** Opens a new database connection + * + * @return A new psDB object if the database connection is successful or NULL + * on failure. + */ + +psDB *[% pkg_namespace %]Init( + const char *host, ///< Database server hostname + const char *user, ///< Database username + const char *passwd, ///< Database password + const char *dbname ///< Database table.namespace +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert.tt (revision 22030) @@ -0,0 +1,35 @@ +bool [% table.namespace %]Insert(psDB * dbh, +[%- SET i = 0 -%] +[% FOREACH item = table.columns -%] +[% IF i == 0 %][% i = 1 %] [% ELSE %], [% END -%] +[% IF item.type == "STR" -%] +const char *[% item.name %] +[%- ELSE -%] +[% item.ctype %] [% item.name %] +[%- END -%] +[% END -%] +) +{ + psMetadata *md; + bool status; + + md = psMetadataAlloc(); +[% FOREACH item = table.columns -%] +[% IF item.type == "S32" or item.type == "F32" or item.type == "F64" -%] + if (!psMetadataAdd[% item.type %](md, PS_LIST_TAIL, "[% item.name %]", 0, NULL, [% item.name %])) { +[% ELSIF item.type == "STR" -%] + if (!psMetadataAddStr(md, PS_LIST_TAIL, "[% item.name %]", 0, NULL, [% item.name %])) { +[% ELSIF item.type == "BOOL" -%] + if (!psMetadataAdd(md, PS_LIST_TAIL, "[% item.name %]", PS_DATA_BOOL, NULL, [% item.name %])) { +[% END -%] + psError(PS_ERR_UNKNOWN, false, "failed to add item [% item.name %]"); + psFree(md); + return false; + } +[% END -%] + + status = psDBInsertOneRow(dbh, [% table.namespace FILTER upper %]_TABLE_NAME, md); + psFree(md); + + return status; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert_at.tt (revision 22030) @@ -0,0 +1,8 @@ +AT_SETUP([[% table.namespace %]Insert()]) +AT_KEYWORDS([[% table.namespace %]Insert]) + +AT_CHECK([dbsetup]) +AT_CHECK([insert]) +AT_CHECK([dbcleanup]) + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert_c.tt (revision 22030) @@ -0,0 +1,32 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +#include +#include <[% pkg_name %].h> +#include + +int main () +{ +[% FOREACH table = tables -%] + { + psDB *dbh; + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + if (![% table.namespace %]Insert(dbh, +[%- SET i = 0 -%] +[%- FOREACH item = table.columns -%] +[%- IF i == 0 -%][%- i = 1 -%][%- ELSE -%], [% END -%] [%- item.test -%] +[%- END -%] +)) { + exit(EXIT_FAILURE); + } + + psDBCleanup(dbh); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insert_h.tt (revision 22030) @@ -0,0 +1,21 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +/** Insert a single row into a table + * + * This function constructs and inserts a single row based on it's parameters. + * + * @return true on success + */ + +bool [% table.namespace %]Insert( + psDB *dbh, ///< Database handle +[%- SET i = 0 -%] +[% FOREACH item = table.columns -%] +[% IF i == 0 %][% i = 1 %][% ELSE %],[% END %] +[% IF item.type == "STR" -%] + [% indented("const char", "*$item.name") -%] +[% ELSE -%] + [% indented("$item.ctype", "$item.name") -%] +[% END -%] +[% END %] +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits.tt (revision 22030) @@ -0,0 +1,34 @@ +bool [% table.namespace %]InsertFits(psDB *dbh, const psFits *fits) +{ + psArray *rowSet; + + // move to (the first?) extension named [% table.namespace FILTER upper %]_TABLE_NAME + if (!psFitsMoveExtName(fits, [% table.namespace FILTER upper %]_TABLE_NAME)) { + psError(PS_ERR_UNKNOWN, true, "failed to find FITS extension %s", [% table.namespace FILTER upper %]_TABLE_NAME); + return false; + } + + // check HDU type + if (psFitsGetExtType(fits) != PS_FITS_TYPE_BINARY_TABLE) { + psError(PS_ERR_UNKNOWN, true, "FITS HDU type is not PS_FITS_TYPE_BINARY_TABLE"); + return false; + } + + // read fits table + rowSet = psFitsReadTable(fits); + if (!rowSet) { + psError(PS_ERR_UNKNOWN, true, "FITS read error or FITS table is empty"); + psFree(rowSet); + return false; + } + + if (!psDBInsertRows(dbh, [% table.namespace FILTER upper %]_TABLE_NAME, rowSet)) { + psError(PS_ERR_UNKNOWN, false, "databse insert failed"); + psFree(rowSet); + return false; + } + + psFree(rowSet); + + return true; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits_at.tt (revision 22030) @@ -0,0 +1,15 @@ +AT_SETUP([[% table.namespace %]InsertFits()]) +AT_KEYWORDS([[% table.namespace %]InsertFits]) + +AT_CHECK([dbsetup]) +# run insert so there is a row in the table +AT_CHECK([insert]) +# run popfis so there is afits file to read +AT_CHECK([popfits]) +AT_CHECK([insertfits]) +AT_CHECK([dbcleanup]) +if [ test -f "blargh" ] ; then + rm -f "blargh" +fi + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits_c.tt (revision 22030) @@ -0,0 +1,40 @@ +#include +#include <[% pkg_name %].h> +#include +#include +#include + +#define TMP_FILENAME "./blargh" + +int main () +{ +[% FOREACH table = tables -%] + { + psDB *dbh; + psFits *fits; + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + // open a temp + fits = psFitsOpen(TMP_FILENAME, "r"); + if (!fits) { + exit(EXIT_FAILURE); + } + + if (![% table.namespace %]InsertFits(dbh, fits)) { + exit(EXIT_FAILURE); + } + + if (!psFitsClose(fits)) { + exit(EXIT_FAILURE); + } + + psDBCleanup(dbh); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertfits_h.tt (revision 22030) @@ -0,0 +1,14 @@ +/** Insert data from a binary FITS table [% table.object_name %] into the database + * + * This function expects a psFits object with a FITS table as the first + * extension. The table must have at least one row of data in it, that is of + * the appropriate format (number of columns and their type). All other + * extensions are ignored. + * + * @return true on success + */ + +bool [% table.namespace %]InsertFits( + psDB *dbh, ///< Database handle + const psFits *fits ///< psFits object +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject.tt (revision 22030) @@ -0,0 +1,10 @@ +bool [% table.namespace %]InsertObject(psDB *dbh, [% table.object_name %] *object) +{ + return [% table.namespace %]Insert(dbh, +[%- SET i = 0 -%] +[%- FOREACH item = table.columns -%] +[%- IF i == 0 -%][%- i = 1 -%] [% ELSE %], [% END -%] +object->[% item.name -%] +[%- END -%] +); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject_at.tt (revision 22030) @@ -0,0 +1,8 @@ +AT_SETUP([[% table.namespace %]InsertObject()]) +AT_KEYWORDS([[% table.namespace %]InsertObject]) + +AT_CHECK([dbsetup]) +AT_CHECK([insertobject]) +AT_CHECK([dbcleanup]) + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject_c.tt (revision 22030) @@ -0,0 +1,39 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +#include +#include <[% pkg_name %].h> +#include + +int main () +{ +[% FOREACH table = tables -%] + { + psDB *dbh; + [% indented(table.object_name, "*object") %]; + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + object = [% table.object_name %]Alloc( +[%- SET i = 0 -%] +[%- FOREACH item = table.columns -%] + [%- IF i == 0 -%][%- i = 1 -%][%- ELSE -%], [% END -%] [%- item.test -%] +[%- END -%] +); + if (!object) { + exit(EXIT_FAILURE); + } + + if (![% table.namespace %]InsertObject(dbh, object)) { + exit(EXIT_FAILURE); + } + + psFree(object); + psDBCleanup(dbh); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/insertobject_h.tt (revision 22030) @@ -0,0 +1,13 @@ +[% USE format -%] +[% indented = format('%-15s %-20s') -%] +/** Insert a single [% table.object_name %] object into a table + * + * This function constructs and inserts a single row based on it's parameters. + * + * @return true on success + */ + +bool [% table.namespace %]InsertObject( + psDB *dbh, ///< Database handle + [% indented(table.object_name, "*object") %]///< [% table.object_name %] object +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/makefile.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/makefile.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/makefile.tt (revision 22030) @@ -0,0 +1,19 @@ +SHELL = /bin/sh +CFLAGS = -g -O0 -pipe -fpic -Wall -pedantic -std=c99 +LIBS = -lpslib +CFLAGS += `mysql_config --cflags` +LIBS += `mysql_config --libs` + + +objects=[% table.namespace %]db.o + +all: lib[% table.namespace %]db.so + +lib[% table.namespace %]db.so: $(objects) + $(CC) $(CFLAGS) -shared -o lib[% table.namespace %]db.so $(objects) $(LIBS) + +$(objects): %.o : %.c + $(CC) $(CFLAGS) -o $@ -c $< + +clean: + $(RM) *.so *.o core test Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject.tt (revision 22030) @@ -0,0 +1,21 @@ +psMetadata *[% table.namespace %]MetadataFromObject(const [% table.object_name %] *object) +{ + psMetadata *md; + + md = psMetadataAlloc(); +[% FOREACH item = table.columns -%] +[% IF item.type == "S32" or item.type == "F32" or item.type == "F64" -%] + if (!psMetadataAdd[% item.type %](md, PS_LIST_TAIL, "[% item.name %]", 0, NULL, object->[% item.name %])) { +[% ELSIF item.type == "STR" -%] + if (!psMetadataAddStr(md, PS_LIST_TAIL, "[% item.name %]", 0, NULL, object->[% item.name %])) { +[% ELSIF item.type == "BOOL" -%] + if (!psMetadataAdd(md, PS_LIST_TAIL, "[% item.name %]", PS_DATA_BOOL, NULL, object->[% item.name %])) { +[% END -%] + psError(PS_ERR_UNKNOWN, false, "failed to add item [% item.name %]"); + psFree(md); + return NULL; + } +[% END -%] + + return md; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject_at.tt (revision 22030) @@ -0,0 +1,6 @@ +AT_SETUP([[% table.namespace %]MetadataFromObject()]) +AT_KEYWORDS([[% table.namespace %]MetadataFromObject]) + +AT_CHECK([metadatafromobject]) + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject_c.tt (revision 22030) @@ -0,0 +1,53 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +#include +#include <[% pkg_name %].h> +#include +#include + +#define MAX_STRING_LENGTH 1024 + +int main () +{ +[% FOREACH table = tables -%] + { + psMetadata *md; + [% indented(table.object_name, "*object") %]; + bool status; + + object = [% table.object_name %]Alloc( +[%- SET i = 0 -%] +[%- FOREACH item = table.columns -%] + [%- IF i == 0 -%][%- i = 1 -%][%- ELSE -%], [% END -%] [%- item.test -%] +[%- END -%] +); + if (!object) { + exit(EXIT_FAILURE); + } + + md = [% table.namespace %]MetadataFromObject(object); + if (!md) { + exit(EXIT_FAILURE); + } + + psFree(object); + +[% FOREACH item = table.columns -%] +[% IF item.type == "S32" or item.type == "F32" or item.type == "F64" -%] + if (!psMetadataLookup[% item.type %](&status, md, "[% item.name %]") == [% item.test %]) { +[% ELSIF item.type == "STR" -%] + if (strncmp(psMetadataLookupPtr(&status, md, "[% item.name %]"), [% item.test %], MAX_STRING_LENGTH)) { +[% ELSIF item.type == "BOOL" -%] + if (!psMetadataLookupBool(&status, md, "[% item.name %]") == [% item.test %]) { +[% END -%] + psFree(md); + exit(EXIT_FAILURE); + } +[% END -%] + + psFree(md); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/metadatafromobject_h.tt (revision 22030) @@ -0,0 +1,10 @@ +[% USE format -%] +[% indented = format('%-15s %-20s') -%] +/** Convert a [% table.object_name %] into an equivalent psMetadata + * + * @return A psMetadata pointer or NULL on error + */ + +psMetadata *[% table.namespace %]MetadataFromObject( + [% indented("const $table.object_name", "*object") %]///< fooRow to convert into a psMetadata +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/object_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/object_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/object_h.tt (revision 22030) @@ -0,0 +1,17 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +/** [% table.object_name %] data structure + * + * Structure for representing a single row of [% table.name %] table data. + */ + +typedef struct { +[% SET i = 0 -%] +[% FOREACH item = table.columns -%] +[% IF item.type == "STR" -%] + [% indented("char", "*$item.name") %]; +[% ELSE -%] + [% indented("$item.ctype", "$item.name") %]; +[% END -%] +[% END -%] +} [% table.object_name %]; Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata.tt (revision 22030) @@ -0,0 +1,34 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +[% table.object_name %] *[% table.namespace %]ObjectFromMetadata(psMetadata *md) +{ + bool status; +[% FOREACH item = table.columns -%] +[% IF item.type == "STR" -%] + [% indented("char", "*$item.name") %]; +[% ELSE-%] + [% indented("$item.ctype", "$item.name") %]; +[% END -%] +[% END -%] + +[% FOREACH item = table.columns -%] +[% IF item.type == "S32" or item.type == "F32" or item.type == "F64" -%] + [% item.name %] = psMetadataLookup[% item.type %](&status, md, "[% item.name %]"); +[% ELSIF item.type == "STR" -%] + [% item.name %] = psMetadataLookupPtr(&status, md, "[% item.name %]"); +[% ELSIF item.type == "BOOL" -%] + [% item.name %] = psMetadataLookupBool(&status, md, "[% item.name %]"); +[% END -%] + if (!status) { + psError(PS_ERR_UNKNOWN, true, "failed to lookup value for item [% item.name %]"); + return false; + } +[% END -%] + + return [% table.object_name %]Alloc( +[%- SET i = 0 -%] +[% FOREACH item = table.columns -%] +[% IF i == 0 -%][%- i = 1 -%][% ELSE %], [% END -%] +[% item.name %] +[%- END -%]); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata_at.tt (revision 22030) @@ -0,0 +1,6 @@ +AT_SETUP([[% table.namespace %]ObjectFromMetadata()]) +AT_KEYWORDS([[% table.namespace %]ObjectFromMetadata]) + +AT_CHECK([objectfrommetadata]) + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata_c.tt (revision 22030) @@ -0,0 +1,55 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +#include +#include <[% pkg_name %].h> +#include +#include + +#define MAX_STRING_LENGTH 1024 + +int main () +{ +[% FOREACH table = tables -%] + { + psMetadata *md; + [% indented(table.object_name, "*object") %]; + + md = psMetadataAlloc(); +[% FOREACH item = table.columns -%] +[% IF item.type == "S32" or item.type == "F32" or item.type == "F64" -%] + if (!psMetadataAdd[% item.type %](md, PS_LIST_TAIL, "[% item.name %]", 0, NULL, [% item.test %])) { +[% ELSIF item.type == "STR" -%] + if (!psMetadataAddStr(md, PS_LIST_TAIL, "[% item.name %]", 0, NULL, [% item.test %])) { +[% ELSIF item.type == "BOOL" -%] + if (!psMetadataAdd(md, PS_LIST_TAIL, "[% item.name %]", PS_DATA_BOOL, NULL, [% item.test %])) { +[% END -%] + psFree(md); + exit(EXIT_FAILURE); + } +[% END -%] + + object = [% table.namespace %]ObjectFromMetadata(md); + if (!object) { + psFree(md); + exit(EXIT_FAILURE); + } + + psFree(md); + +[% FOREACH item = table.columns -%] +[% IF item.type == "S32" or item.type == "F32" or item.type == "F64" or item.type == "BOOL" -%] + if (!object->[% item.name %] == [% item.test %]) { +[% ELSIF item.type == "STR" -%] + if (strncmp(object->[% item.name %], [% item.test %], MAX_STRING_LENGTH)) { +[% END -%] + psFree(object); + exit(EXIT_FAILURE); + } +[% END -%] + + psFree(object); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/objectfrommetadata_h.tt (revision 22030) @@ -0,0 +1,8 @@ +/** Convert a psMetadata into an equivalent fooRow + * + * @return A [% table.object_name %] pointer or NULL on error + */ + +[% table.object_name %] *[% table.namespace %]ObjectFromMetadata( + psMetadata *md ///< psMetadata to convert into a fooRow +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pkgconfig_pc_in.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pkgconfig_pc_in.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pkgconfig_pc_in.tt (revision 22030) @@ -0,0 +1,11 @@ +prefix=@prefix@ +exec_prefix=@exec_prefix@ +libdir=@libdir@ +includedir=@includedir@ + +Name: @PACKAGE@ +Description: some library +Version: @VERSION@ +Requires: pslib +Libs: -L${libdir} -l@PACKAGE@ +Cflags: -I${includedir} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop.tt (revision 22030) @@ -0,0 +1,74 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +bool [% table.namespace %]Pop(psDB *dbh, +[%- SET i = 0 -%] +[% FOREACH item = table.columns -%] +[% IF i == 0 %][% i = 1 %][% ELSE %], [% END -%] +[% IF item.type == "STR" -%] +char **[% item.name -%] +[% ELSE -%] +[% item.ctype %] *[% item.name -%] +[% END -%] +[% END %]) +{ + psArray *rowSet; + psMetadata *row; + psMetadata *popped; + long deleted; + bool status; + int rowID; + + rowSet = psDBSelectRows(dbh, [% table.namespace FILTER upper %]_TABLE_NAME, NULL, 1); + if (!rowSet) { + psError(PS_ERR_UNKNOWN, true, "failed to lookup value for item %s", [% table.namespace FILTER upper %]_INDEX_NAME); + psFree(rowSet); + return NULL; + } + + row = psArrayGet(rowSet, 0); + psMemIncrRefCounter(row); + if (!row) { + psError(PS_ERR_UNKNOWN, true, "database error or table is empty"); + return NULL; + } + psFree(rowSet); + + rowID = psMetadataLookupS32(&status, row, [% table.namespace FILTER upper %]_INDEX_NAME); + if (!status) { + psError(PS_ERR_UNKNOWN, true, "failed to lookup value for item %s", [% table.namespace FILTER upper %]_INDEX_NAME); + psFree(row); + return NULL; + } + + popped = psMetadataAlloc(); + psMetadataAddS32(popped, PS_LIST_TAIL, [% table.namespace FILTER upper %]_INDEX_NAME, 0, NULL, rowID); + + deleted = psDBDeleteRows(dbh, [% table.namespace FILTER upper %]_TABLE_NAME, popped, 0); + if (deleted != 1) { + psError(PS_ERR_UNKNOWN, false, "database failed to delete row"); + psFree(popped); + psFree(row); + return NULL; + } + + psFree(popped); + +[% FOREACH item = table.columns -%] +[% IF item.type == "S32" or item.type == "F32" or item.type == "F64" -%] + *[% item.name %] = psMetadataLookup[% item.type %](&status, row, "[% item.name %]"); +[% ELSIF item.type == "STR" -%] + *[% item.name %] = psMetadataLookupPtr(&status, row, "[% item.name %]"); +[% ELSIF item.type == "BOOL" -%] + *[% item.name %] = psMetadataLookupBool(&status, row, "[% item.name %]"); +[% END -%] + if (!status) { + psError(PS_ERR_UNKNOWN, true, "failed to lookup value for item [% item.name %]"); + psFree(row); + return false; + } +[% END -%] + + psFree(row); + + return true; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop_at.tt (revision 22030) @@ -0,0 +1,10 @@ +AT_SETUP([[% table.namespace %]Pop()]) +AT_KEYWORDS([[% table.namespace %]Pop]) + +AT_CHECK([dbsetup]) +# run insert so there is a row in the table +AT_CHECK([insert]) +AT_CHECK([pop]) +AT_CHECK([dbcleanup]) + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop_c.tt (revision 22030) @@ -0,0 +1,43 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +#include +#include <[% pkg_name %].h> +#include + +int main () +{ +[% FOREACH table = tables -%] + { + psDB *dbh; +[% FOREACH item = table.columns -%] +[% IF item.type == "STR" -%] + [% indented("char", "$item.name[256]") %]; +[% ELSE-%] + [% indented("$item.ctype", "$item.name") %]; +[% END -%] +[% END -%] + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + if (![% table.namespace %]Pop(dbh, +[%- SET i = 0 -%] +[% FOREACH item = table.columns -%] +[% IF i == 0 %][% i = 1 %][% ELSE %], [% END -%] +[% IF item.type == "STR" -%] +(char **)&[% item.name -%] +[% ELSE-%] +&[% item.name -%] +[% END -%] +[% END %])) { + exit(EXIT_FAILURE); + } + + psDBCleanup(dbh); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/pop_h.tt (revision 22030) @@ -0,0 +1,19 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +/** Removes the last row from the database and returns it + * + * @return true on success + */ + +bool [% table.namespace %]Pop( + psDB *dbh, ///< Database handle +[%- SET i = 0 -%] +[% FOREACH item = table.columns -%] +[% IF i == 0 %][% i = 1 %][% ELSE %],[% END %] +[% IF item.type == "STR" -%] + [% indented("char", "**$item.name") -%] +[% ELSE -%] + [% indented("$item.ctype", "*$item.name") -%] +[% END -%] +[% END %] +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits.tt (revision 22030) @@ -0,0 +1,24 @@ +bool [% table.namespace %]PopFits(psDB *dbh, psFits *fits, unsigned long long limit) +{ + char query[MAX_STRING_LENGTH]; + + if (![% table.namespace %]SelectRowsFits(dbh, fits, NULL, limit)) { + psError(PS_ERR_UNKNOWN, true, "database error or table is empty"); + return false; + } + + // remove limit rows from the end of the database + if (snprintf(query, MAX_STRING_LENGTH, + "DELETE FROM %s ORDER BY %s DESC LIMIT %lld", + [% table.namespace FILTER upper %]_TABLE_NAME, [% table.namespace FILTER upper %]_INDEX_NAME, limit) < 0) { + psError(PS_ERR_UNKNOWN, true, "query value attempted to exceed %s bytes", MAX_STRING_LENGTH); + return false; + } + + if (!p_psDBRunQuery(dbh, query)) { + psError(PS_ERR_UNKNOWN, false, "database query failed"); + return false; + } + + return true; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits_at.tt (revision 22030) @@ -0,0 +1,13 @@ +AT_SETUP([[% table.namespace %]PopFits()]) +AT_KEYWORDS([[% table.namespace %]PopFits]) + +AT_CHECK([dbsetup]) +# run insert so there is a row in the table +AT_CHECK([insert]) +AT_CHECK([popfits]) +AT_CHECK([dbcleanup]) +if [ test -f "blargh" ] ; then + rm -f "blargh" +fi + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits_c.tt (revision 22030) @@ -0,0 +1,40 @@ +#include +#include <[% pkg_name %].h> +#include +#include +#include + +#define TMP_FILENAME "./blargh" + +int main () +{ +[% FOREACH table = tables -%] + { + psDB *dbh; + psFits *fits; + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + // allocate a temp + fits = psFitsOpen(TMP_FILENAME, "w"); + if (!fits) { + exit(EXIT_FAILURE); + } + + if (![% table.namespace %]PopFits(dbh, fits, 1)) { + exit(EXIT_FAILURE); + } + + if (!psFitsClose(fits)) { + exit(EXIT_FAILURE); + } + + psDBCleanup(dbh); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popfits_h.tt (revision 22030) @@ -0,0 +1,13 @@ +/** Removes the last limit row from the database and returns them in a binary FITS table. + * + * This function assumes an empty psFits object and will create a FITS table as + * the first extension. + * + * @return true on success + */ + +bool [% table.namespace %]PopFits( + psDB *dbh, ///< Database handle + psFits *fits, ///< psFits object + unsigned long long limit ///< Maximum number of elements to return +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject.tt (revision 22030) @@ -0,0 +1,33 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +[% table.object_name %] *[% table.namespace %]PopObject(psDB *dbh) +{ +[% FOREACH item = table.columns -%] +[% IF item.type == "STR" -%] + [% indented("char", "$item.name[256]") %]; +[% ELSE-%] + [% indented("$item.ctype", "$item.name") %]; +[% END -%] +[% END -%] + + if (![% table.namespace %]Pop(dbh, +[%- SET i = 0 -%] +[% FOREACH item = table.columns -%] +[% IF i == 0 %][% i = 1 %][% ELSE %], [% END -%] +[% IF item.type == "STR" -%] +(char **)&[% item.name -%] +[% ELSE-%] +&[% item.name -%] +[% END -%] +[% END %])) { + psError(PS_ERR_UNKNOWN, false, "failed to pop a database row"); + return NULL; + } + + return [% table.object_name %]Alloc( +[%- SET i = 0 -%] +[% FOREACH item = table.columns -%] +[% IF i == 0 -%][%- i = 1 -%][% ELSE %], [% END -%] +[% item.name %] +[%- END -%]); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject_at.tt (revision 22030) @@ -0,0 +1,10 @@ +AT_SETUP([[% table.namespace %]PopObject()]) +AT_KEYWORDS([[% table.namespace %]PopObject]) + +AT_CHECK([dbsetup]) +# run insert so there is a row in the table +AT_CHECK([insert]) +AT_CHECK([popobject]) +AT_CHECK([dbcleanup]) + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject_c.tt (revision 22030) @@ -0,0 +1,30 @@ +[% USE format -%] +[% indented = format('%-15s %s') -%] +#include +#include <[% pkg_name %].h> +#include + +int main () +{ +[% FOREACH table = tables -%] + { + psDB *dbh; + [% indented(table.object_name, "*object") %]; + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + object = [% table.namespace %]PopObject(dbh); + if (!object) { + exit(EXIT_FAILURE); + } + + psFree(object); + psDBCleanup(dbh); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/popobject_h.tt (revision 22030) @@ -0,0 +1,8 @@ +/** Removes the last row from the database and returns it + * + * @return A new [% table.object_name %] on success or NULL on failure. + */ + +[% table.object_name %] *[% table.namespace %]PopObject( + psDB *dbh ///< Database handle +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printmetadatas.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printmetadatas.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printmetadatas.tt (revision 22030) @@ -0,0 +1,33 @@ +bool [% pkg_namespace %]PrintMetadatas(FILE *stream, psArray *mds, const char *mdname, bool mdconfigformat) +{ + PS_ASSERT_PTR_NON_NULL(mds, false); + PS_ASSERT_PTR_NON_NULL(mdname, false); + + psMetadata *output = psMetadataAlloc(); + for (long i = 0; i < psArrayLength(mds); i++) { + psMetadata *md = mds->data[i]; + if (!psMetadataAddMetadata( + output, + PS_LIST_TAIL, + mdname, + PS_META_DUPLICATE_OK, + NULL, + md + )) { + psError(PS_ERR_UNKNOWN, false, "failed to add metadata"); + psFree(output); + return false; + } + } + + psString str = psMetadataConfigFormat(output); + if (!str) { + psError(PS_ERR_UNKNOWN, false, "failed to format data into a string"); + psFree(output); + } + psFree(output); + fprintf(stream, "%s\n", str); + psFree(str); + + return true; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printmetadatas_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printmetadatas_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printmetadatas_h.tt (revision 22030) @@ -0,0 +1,14 @@ +/** Formats and prints an array of metadata + * + * When mdconfigformat is set the formated output is in psMetadataConfig + * format, otherwise it is in a simple tabular format. + * + * @return true on success + */ + +bool [% pkg_namespace %]PrintMetadatas( + FILE *stream, ///< a stream + psArray *mds, ///< An array of metadata + const char *mdname, ///< name of the metadata(s) + bool mdconfigformat ///< format as mdconfig or simple +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printobjects.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printobjects.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printobjects.tt (revision 22030) @@ -0,0 +1,34 @@ +bool [% table.namespace %]PrintObjects(FILE *stream, psArray *objects, bool mdconfigformat) +{ + PS_ASSERT_PTR_NON_NULL(objects, false); + + psMetadata *output = psMetadataAlloc(); + for (long i = 0; i < psArrayLength(objects); i++) { + psMetadata *md = [% table.namespace %]MetadataFromObject(objects->data[i]); + if (!psMetadataAddMetadata( + output, + PS_LIST_TAIL, + [% table.namespace FILTER upper %]_TABLE_NAME, + PS_META_DUPLICATE_OK, + NULL, + md + )) { + psError(PS_ERR_UNKNOWN, false, "failed to add metadata"); + psFree(md); + psFree(output); + return false; + } + psFree(md); + } + + psString str = psMetadataConfigFormat(output); + if (!str) { + psError(PS_ERR_UNKNOWN, false, "failed to format data into a string"); + psFree(output); + } + psFree(output); + fprintf(stream, "%s\n", str); + psFree(str); + + return true; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printobjects_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printobjects_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/printobjects_h.tt (revision 22030) @@ -0,0 +1,13 @@ +/** Formats and prints an array of [% table.object_name %] objects + * + * When mdconfigformat is set the formated output is in psMetadataConfig + * format, otherwise it is in a simple tabular format. + * + * @return true on success + */ + +bool [% table.namespace %]PrintObjects( + FILE *stream, ///< a stream + psArray *objects, ///< An array of [% table.object_name %] objects + bool mdconfigformat ///< format as mdconfig or simple +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowobjects.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowobjects.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowobjects.tt (revision 22030) @@ -0,0 +1,35 @@ +psArray *[% table.namespace %]SelectRowObjects(psDB *dbh, const psMetadata *where, unsigned long long limit) +{ + psArray *rowSet; + psArray *returnSet; + psU64 i; + + rowSet = psDBSelectRows(dbh, [% table.namespace FILTER upper %]_TABLE_NAME, where, limit); + if (!rowSet) { + return NULL; + } + + // strip index column + for (i = 0; i < rowSet->n; i++) { + if (!psMetadataRemove((psMetadata *)(rowSet->data[i]), 0, [% table.namespace FILTER upper %]_INDEX_NAME)) { + psError(PS_ERR_UNKNOWN, true, "failed to remove item %s", [% table.namespace FILTER upper %]_INDEX_NAME); + psFree(rowSet); + return false; + } + } + + // convert psMetadata rows to row objects + + returnSet = psArrayAlloc(rowSet->n); + returnSet->n = 0; + + for (i = 0; i < rowSet->n; i++) { + [% table.object_name %] *object = [% table.namespace %]ObjectFromMetadata(rowSet->data[i]); + psArrayAdd(returnSet, 0, object); + psFree(object); + } + + psFree(rowSet); + + return returnSet; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowobjects_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowobjects_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowobjects_h.tt (revision 22030) @@ -0,0 +1,12 @@ +/** Selects up to limit rows from the database and returns as [% table.object_name %] objects in a psArray + * + * See psDBSelectRows() for documentation on the format of where. + * + * @return A psArray pointer or NULL on error + */ + +psArray *[% table.namespace %]SelectRowObjects( + psDB *dbh, ///< Database handle + const psMetadata *where, ///< Row match criteria + unsigned long long limit ///< Maximum number of elements to return +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits.tt (revision 22030) @@ -0,0 +1,30 @@ +bool [% table.namespace %]SelectRowsFits(psDB *dbh, psFits *fits, const psMetadata *where, unsigned long long limit) +{ + psArray *rowSet; + psU64 i; + + rowSet = psDBSelectRows(dbh, [% table.namespace FILTER upper %]_TABLE_NAME, where, limit); + if (!rowSet) { + return false; + } + + // strip index column + for (i = 0; i < rowSet->n; i++) { + if (!psMetadataRemove((psMetadata *)rowSet->data[i], 0, [% table.namespace FILTER upper %]_INDEX_NAME)) { + psError(PS_ERR_UNKNOWN, true, "failed to remove item %s", [% table.namespace FILTER upper %]_INDEX_NAME); + psFree(rowSet); + return false; + } + } + + // output to fits + if (!psFitsWriteTable(fits, NULL, rowSet, [% table.namespace FILTER upper %]_TABLE_NAME)) { + psError(PS_ERR_UNKNOWN, false, "FITS table write failed"); + psFree(rowSet); + return false; + } + + psFree(rowSet); + + return true; +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits_at.tt (revision 22030) @@ -0,0 +1,13 @@ +AT_SETUP([[% table.namespace %]SelectRowsFits()]) +AT_KEYWORDS([[% table.namespace %]SelectRowsFits]) + +AT_CHECK([dbsetup]) +# run insert so there is a row in the table +AT_CHECK([insert]) +AT_CHECK([selectrowsfits]) +AT_CHECK([dbcleanup]) +if [ test -f "blargh" ] ; then + rm -f "blargh" +fi + +AT_CLEANUP Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits_c.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits_c.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits_c.tt (revision 22030) @@ -0,0 +1,34 @@ +#include +#include <[% pkg_name %].h> +#include + +#define TMP_FILENAME "./blargh" + +int main () +{ +[% FOREACH table = tables -%] + { + psDB *dbh; + psFits *fits; + + dbh = psDBInit("localhost", "test", NULL, "test"); + if (!dbh) { + exit(EXIT_FAILURE); + } + + fits = psFitsOpen(TMP_FILENAME, "w"); + if (!fits) { + exit(EXIT_FAILURE); + } + + if (![% table.namespace %]SelectRowsFits(dbh, fits, NULL, 1)) { + exit(EXIT_FAILURE); + } + + psFree(fits); + psDBCleanup(dbh); + } + +[% END -%] + exit(EXIT_SUCCESS); +} Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits_h.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits_h.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/selectrowsfits_h.tt (revision 22030) @@ -0,0 +1,16 @@ +/** Selects up to limit from the database and returns them in a binary FITS table + * + * This function assumes an empty psFits object and will create a FITS table + * as the first extension. + * + * See psDBSelectRows() for documentation on the format of where. + * + * @return true on success + */ + +bool [% table.namespace %]SelectRowsFits( + psDB *dbh, ///< Database handle + psFits *fits, ///< psFits object + const psMetadata *where, ///< Row match criteria + unsigned long long limit ///< Maximum number of elements to return +); Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/src_makefile_am.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/src_makefile_am.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/src_makefile_am.tt (revision 22030) @@ -0,0 +1,10 @@ +AM_CFLAGS = @[% pkg_name %]_CFLAGS@ + +include_HEADERS = [% pkg_name %].h +lib_LTLIBRARIES = lib[% pkg_name %].la +lib[% pkg_name %]_la_CFLAGS = $(PSLIB_CFLAGS) $(AM_CFLAGS) +lib[% pkg_name %]_la_LIBS = $(PSLIB_LIBS) $(AM_LIBS) +lib[% pkg_name %]_la_LDFLAGS = -release $(PACKAGE_VERSION) +lib[% pkg_name %]_la_SOURCES = \ + [% pkg_name %].h \ + [% pkg_name %].c Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/tests_makefile_am.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/tests_makefile_am.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/tests_makefile_am.tt (revision 22030) @@ -0,0 +1,67 @@ +# copied from bison-1.875d + +EXTRA_DIST = $(TESTSUITE_AT) testsuite package.m4 + +DISTCLEANFILES = atconfig $(check_SCRIPTS) +MAINTAINERCLEANFILES = Makefile.in $(TESTSUITE) + +## ------------ ## +## package.m4. ## +## ------------ ## + +$(srcdir)/package.m4: $(top_srcdir)/configure.ac + { \ + echo '# Signature of the current package.'; \ + echo 'm4_define([AT_PACKAGE_NAME], [@PACKAGE_NAME@])'; \ + echo 'm4_define([AT_PACKAGE_TARNAME], [@PACKAGE_TARNAME@])'; \ + echo 'm4_define([AT_PACKAGE_VERSION], [@PACKAGE_VERSION@])'; \ + echo 'm4_define([AT_PACKAGE_STRING], [@PACKAGE_STRING@])'; \ + echo 'm4_define([AT_PACKAGE_BUGREPORT], [@PACKAGE_BUGREPORT@])'; \ + } >$(srcdir)/package.m4 + +## ------------ ## +## Test suite. ## +## ------------ ## + +TESTSUITE = $(srcdir)/testsuite + +AUTOTEST = $(AUTOM4TE) --language=autotest +$(TESTSUITE): package.m4 $(TESTSUITE_AT) + $(AUTOTEST) -I $(srcdir) testsuite.at -o $@.tmp + mv $@.tmp $@ + +atconfig: $(top_builddir)/config.status + cd $(top_builddir) && ./config.status tests/$@ + +clean-local: + test ! -f $(TESTSUITE) || $(SHELL) $(TESTSUITE) --clean + +check-local: atconfig $(TESTSUITE) + $(SHELL) $(TESTSUITE) + +# +# END BISON +# + +UNITS = \ + alloc \ + init \ + cleanup \ + createtable \ + droptable \ + insert \ + pop \ + insertobject \ + popobject \ + insertfits \ + popfits \ + selectrowsfits \ + metadatafromobject \ + objectfrommetadata + +AM_CPPFLAGS = -I$(top_srcdir)/src$ +AM_CFLAGS = @[% pkg_name %]_CFLAGS@ $(PSLIB_CFLAGS)$ +AM_LDFLAGS = $(PSLIB_LIBS)$ +LDADD = $(top_builddir)/src/lib[% pkg_name %].la$ + +check_PROGRAMS = dbsetup dbcleanup $(UNITS) Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/testsuite_at.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/testsuite_at.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/testsuite_at.tt (revision 22030) @@ -0,0 +1,33 @@ +m4_version_prereq([2.59]) + +AT_INIT + +### +[% INCLUDE alloc_at.tt %] +### +[% INCLUDE init_at.tt %] +### +[% INCLUDE cleanup_at.tt %] +### +[% INCLUDE createtable_at.tt %] +### +[% INCLUDE droptable_at.tt %] +### +[% INCLUDE insert_at.tt %] +### +[% INCLUDE pop_at.tt %] +### +[% INCLUDE insertobject_at.tt %] +### +[% INCLUDE popobject_at.tt %] +### +[% INCLUDE insertfits_at.tt %] +### +[% INCLUDE popfits_at.tt %] +### +[% INCLUDE selectrowsfits_at.tt %] +### +[% INCLUDE metadatafromobject_at.tt %] +### +[% INCLUDE objectfrommetadata_at.tt %] +### Index: /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/top_makefile_am.tt =================================================================== --- /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/top_makefile_am.tt (revision 22030) +++ /tags/ipp-1-X/rel-0_16/glueforge/templates/psdb/top_makefile_am.tt (revision 22030) @@ -0,0 +1,30 @@ +SUBDIRS = src tests + +pkgconfigdir = $(libdir)/pkgconfig +pkgconfig_DATA= [% pkg_name %].pc + +EXTRA_DIST = [% pkg_name %].pc.in Doxyfile.in + +if DOXYGEN + +man_MANS = \ + $(top_builddir)/docs/man/man3/[% pkg_name %].3 \ +[%- FOREACH table = tables %] +[% IF NOT loop.last -%] + $(top_builddir)/docs/man/man3/[% table.object_name %].3 \ +[%- ELSE -%] + $(top_builddir)/docs/man/man3/[% table.object_name %].3 +[% END -%] +[% END %] + +docs/man/man3/[% pkg_name %].3 +[%- FOREACH table = tables -%] + docs/man/man3/[% table.object_name %].3 +[%- IF loop.last %]:[% END -%] +[%- END %] + $(DOXYGEN) + +endif + +clean-local: + -rm -rf docs