Differences between revisions 1 and 2
Revision 1 as of 2007-07-11 05:22:28
Size: 521
Editor: niemeyer
Comment:
Revision 2 as of 2007-07-11 08:12:31
Size: 1476
Editor: niemeyer
Comment:
Deletions are marked like this. Additions are marked like this.
Line 8: Line 8:
== Supported databases == == Databases ==

=== The create_database() function ===

The `create_database()` function has the following prototype:

{{{
database = create_database(uri)
}}}

The `uri` parameter may be either a URI string or a URI object.
The following URIs are examples of acceptable syntax:

  {{{backend:database_name}}}
  {{{backend://hostname/database_name}}}
  {{{backend://hostname:port/database_name}}}
  {{{backend://username:password@hostname/database_name}}}
  {{{backend://hostname/database_name?option=value}}}
  {{{backend://username@/database_name}}}
Line 37: Line 55:

=== Testing ===

It's easy to test that Storm features are working with new backends.
There are base test classes in `tests/store/database.py` and
`tests/store/base.py` which may be inherited by database-specific test
cases. Look at other backends to get a feeling of how it works.

If these tests pass with a new backend, you may be pretty sure that
Storm is working fine with the created backend.

Storm Manual

This is the detailed documentation for Storm. For a more hands-on approach, check out the [:Tutorial: Tutorial].

Databases

The create_database() function

The create_database() function has the following prototype:

database = create_database(uri)

The uri parameter may be either a URI string or a URI object. The following URIs are examples of acceptable syntax:

  • backend:database_name backend://hostname/database_name backend://hostname:port/database_name backend://username:password@hostname/database_name backend://hostname/database_name?option=value backend://username@/database_name

MySQL

PostgreSQL

SQLite

The Store interface

The ResultSet interface

Properties

References

One-to-one

Many-to-one

Many-to-many

The Reference interface

The ReferenceSet interface

Expressions

Creating a backend

Testing

It's easy to test that Storm features are working with new backends. There are base test classes in tests/store/database.py and tests/store/base.py which may be inherited by database-specific test cases. Look at other backends to get a feeling of how it works.

If these tests pass with a new backend, you may be pretty sure that Storm is working fine with the created backend.

colin's_manual_edit (last edited 2008-12-22 11:27:49 by theboff)