|
Size: 3622
Comment:
|
Size: 4210
Comment:
|
| Deletions are marked like this. | Additions are marked like this. |
| Line 4: | Line 4: |
| Canonical. The project has been in development for more than a year for use in Canonical projects such as [https://launchpad.net Launchpad], and has recently been released as an open-source product. |
Canonical. The project was in development for more than a year for use in Canonical projects such as [[https://launchpad.net|Launchpad]] and [[http://www.canonical.com/projects/landscape|Landscape]] before being released as free software on July 9th, 2007. <<TableOfContents>> |
| Line 10: | Line 13: |
| * Storm works well with existing database schemas. | '''Design''' * Clean and lightweight API offers a short learning curve and long-term maintainability. * Storm is developed in a test-driven manner. An untested line of code is considered a bug. * Storm needs no special class constructors, nor imperative base classes. * Storm is well designed (different classes have very clear boundaries, with small and clean public APIs). * Designed from day one to work both with thin relational databases, such as SQLite, and big iron systems like PostgreSQL. * Storm is easy to debug, since its code is written with a KISS principle, and thus is easy to understand. |
| Line 14: | Line 29: |
| * Clean and lightweight API offers a short learning curve and long-term maintainability. * Designed from day one to work both with thin relational databases, such as SQLite, and big iron systems like PostgreSQL and MySQL. * Distributed database integrity using two-phase commit (if your Python driver and database backend support it). |
* It's very easy to write and support backends for Storm (current backends have around 100 lines of code). '''Features''' * Storm is fast. |
| Line 24: | Line 39: |
| * Storm is developed in a test-driven manner. An untested line of code is considered a bug. * It's very easy to write and support backends for Storm (current backends have around 100 lines of code). * Storm needs no special class constructors, nor imperative base classes. * Clean and lightweight API offers a short learning curve and long-term maintainability. * Storm is developed in a test-driven manner. An untested line of code is considered a bug. * It's very easy to write and support backends for Storm (current backends have around 100 lines of code). * Storm is well designed (different classes have very clear boundaries, with small and clean public APIs). * Storm is easy to debug, since its code is write with a KISS principle, and thus is easy to understand. |
* Storm handles composed primary keys with ease (no need for surrogate keys). |
| Line 40: | Line 41: |
| keep manage the schema as wanted. * As a result of the last point, creating classes in Storm is easier and cleaner than in other ORMs. |
manage the schema as wanted, and creating classes that work with Storm is clean and simple. |
| Line 44: | Line 44: |
| same Python types (or different ones) with any of them. | same Python types (or different ones) with all of them. |
| Line 48: | Line 48: |
| * Storm handles relationships between objects even before they were added to a database. * Storm works well with existing database schemas. * Storm will flush changes to the database automatically when needed, so that queries made affect recently modified objects. |
|
| Line 52: | Line 57: |
| There's a [:Tutorial: tutorial] available. More documentation will come in the near future. Questions are welcome in the mailing list. |
There's a [[https://storm-orm.readthedocs.io/en/latest/tutorial.html|tutorial]] available. We are always working on improving the documentation. Questions are welcome in the mailing list. |
| Line 56: | Line 59: |
| * [:Dependencies: Dependencies/Requirements] ## * [:Install] * [:Tutorial] * [:Manual] (soon!) |
* [[https://storm-orm.readthedocs.io/en/latest/tutorial.html|Tutorial]] (based on code in trunk) * [[Manual]] (under construction) * [[https://storm-orm.readthedocs.io/en/latest/api.html|API docs]] * [[https://storm-orm.readthedocs.io/en/latest/infoheritance.html|Infoheritance]] describes a common Storm design pattern |
| Line 61: | Line 64: |
| * [http://divmod.org/trac/wiki/DivmodNevow/Storm Nevow/Twisted] (forthcoming) | * [[https://storm-orm.readthedocs.io/en/latest/zope.html|Zope]] * [[http://divmod.org/trac/wiki/DivmodNevow/Storm|Nevow/Twisted]] (forthcoming) * [[PylonsRepoze.tm2]] |
| Line 65: | Line 70: |
| Storm is licensed under the [http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html LGPL 2.1]. | Storm is licensed under the [[http://www.gnu.org/licenses/old-licenses/lgpl-2.1.html|LGPL 2.1]]. Contributions must have [[http://www.canonical.com/contributors|copyright assigned to Canonical]]. |
| Line 73: | Line 78: |
| There is also a #storm IRC channel on irc.freenode.net; stop by and chat! | There is also a #storm IRC channel on irc.freenode.net; stop by and chat! We have a PublishBot up and running. |
| Line 81: | Line 87: |
| The source code may be obtained using [http://bazaar-vcs.org Bazaar]: | The source code may be obtained using [[http://bazaar-vcs.org|Bazaar]]: |
| Line 83: | Line 89: |
| {{{bzr branch http://bazaar.launchpad.net/~storm/storm/trunk}}} | {{{bzr branch lp:storm}}} |
| Line 87: | Line 93: |
| http://codebrowse.launchpad.net/~storm/storm/trunk/files | http://bazaar.launchpad.net/~storm/storm/trunk/files If you want to contribute, please see DevelopmentProcedure. |
| Line 94: | Line 103: |
Please follow the ReleaseProcedure when making a new release. <img src=x> |
What is Storm?
Storm is an object-relational mapper (ORM) for Python developed at Canonical. The project was in development for more than a year for use in Canonical projects such as Launchpad and Landscape before being released as free software on July 9th, 2007.
Highlights
Design
- Clean and lightweight API offers a short learning curve and long-term maintainability.
- Storm is developed in a test-driven manner. An untested line of code is considered a bug.
- Storm needs no special class constructors, nor imperative base classes.
- Storm is well designed (different classes have very clear boundaries, with small and clean public APIs).
- Designed from day one to work both with thin relational databases, such as SQLite, and big iron systems like PostgreSQL.
- Storm is easy to debug, since its code is written with a KISS principle, and thus is easy to understand.
- Designed from day one to work both at the low end, with trivial small databases, and the high end, with applications accessing billion row tables and committing to multiple database backends.
- It's very easy to write and support backends for Storm (current backends have around 100 lines of code).
Features
- Storm is fast.
- Storm lets you efficiently access and update large datasets by allowing you to formulate complex queries spanning multiple tables using Python.
- Storm allows you to fallback to SQL if needed (or if you just prefer), allowing you to mix "old school" code and ORM code
- Storm handles composed primary keys with ease (no need for surrogate keys).
- Storm doesn't do schema management, and as a result you're free to manage the schema as wanted, and creating classes that work with Storm is clean and simple.
- Storm works very well connecting to several databases and using the same Python types (or different ones) with all of them.
Storm can handle obj.attr = <A SQL expression> assignments, when that's really needed (the expression is executed at INSERT/UPDATE time).
- Storm handles relationships between objects even before they were added to a database.
- Storm works well with existing database schemas.
- Storm will flush changes to the database automatically when needed, so that queries made affect recently modified objects.
Documentation
There's a tutorial available. We are always working on improving the documentation. Questions are welcome in the mailing list.
Tutorial (based on code in trunk)
Manual (under construction)
Infoheritance describes a common Storm design pattern
- Web Framework Integration
Nevow/Twisted (forthcoming)
License
Storm is licensed under the LGPL 2.1. Contributions must have copyright assigned to Canonical.
Community
The Storm mailing list is publicly available at:
There is also a #storm IRC channel on irc.freenode.net; stop by and chat! We have a PublishBot up and running.
Development
Development of Storm may be tracked in Launchpad:
The source code may be obtained using Bazaar:
bzr branch lp:storm
Code may be browsed at:
If you want to contribute, please see DevelopmentProcedure.
Download
You can find released files at:
Please follow the ReleaseProcedure when making a new release.
<img src=x>