MySQL Forums
Forum List  »  Stored Procedures

Re: Stored procedures utility library
Posted by: Giuseppe Maxia
Date: November 21, 2005 05:13AM

Beat,
thanks for your thoughts.

Beat Vontobel wrote:
[SNIP]
>
> * We should have some style guide on how to write
> routines for the library: indentation, use of
> upper/lower case, use of routine header
> (DETERMINISTIC, NO SQL...), use of COMMENT in

One thing that I notice when I test routines made by others is that sometimes they don't load cleanly in my server, because I always use a binarylog. This means that a policy on submission is mandatory. When the routine has neither a 'deterministic' or a 'reads sql data' clause, then the use of the global variable log_bin_trust_routine_creators could be the only way of installing the routine.

> header (so we have a consistent way to describe
> our routines - this would give us sort of an
> online help for all of the library for free)
> * What format should we use for documentation?

We can borrow from other languages. Personally, I am used to write documentation in Perl POD, which
can produce HTML, RTF, text, and Latex very easily.
I'll think of something, but I believe POD is a good candidate because Perl is on almost every Unix server and it can be easily installed in Windows systems.

> Should we use a Wiki?
> * I thought about SourceForge myself - but is this
> the right place? When a lot of people start to
> contribute - how do we organize the routines? We
> don't want to have them in big files, as most of
> the people probably just look for one specific
> routine to solve a problem. So a database driven
> application to organize our routines would be
> something nice...

Routines should be grouped in small groups, to make them easy to install. When routines have dependencies, though,
we need to cerate some checking mechanism.
Putting routines in a database means that we need to implement a recursive check to let the user know which other routines need to be installed for the wanted one to work properly.

> (But we'd probably have to develop it ourselves. I don't know if there exists
> something we could readily use for that.)
>
> I think such a thing could grow very dynamically
> as soon as it's started - so we should make these
> points clear before it's almost too late to
> reorganize things due to the possible success...

:-)

Minimum requirements for admissions, out of the top of my head:
- they compile correctly in a safe box;
- their name does not confict with anything already existing;
- their use is fairly documented according to a template I have yet to figure out;
- they have a test unit;

> ;-)
>
> Regards,
> Beat

ciao
Giuseppe

Options: ReplyQuote


Subject
Views
Written By
Posted
5793
November 21, 2005 03:41AM
2723
November 21, 2005 04:39AM
Re: Stored procedures utility library
2466
November 21, 2005 05:13AM
2618
November 21, 2005 08:00AM
2775
November 21, 2005 06:53AM
2691
November 21, 2005 08:06AM
2490
November 21, 2005 08:32AM
7853
November 23, 2005 11:24AM
2609
December 03, 2005 08:37AM
2487
November 28, 2005 02:26AM
2578
November 29, 2005 04:28AM


Sorry, you can't reply to this topic. It has been closed.

Content reproduced on this site is the property of the respective copyright holders. It is not reviewed in advance by Oracle and does not necessarily represent the opinion of Oracle or any other party.