Skip to content
GitLab
Explore
Sign in
Register
Primary navigation
Search or go to…
Project
S
submarine.common-lisp.dev
Manage
Activity
Members
Labels
Plan
Issues
Issue boards
Milestones
Wiki
Code
Merge requests
Repository
Branches
Commits
Tags
Repository graph
Compare revisions
Snippets
Build
Pipelines
Jobs
Pipeline schedules
Artifacts
Deploy
Releases
Container Registry
Model registry
Operate
Environments
Monitor
Incidents
Service Desk
Analyze
Value stream analytics
Contributor analytics
CI/CD analytics
Repository analytics
Model experiments
Help
Help
Support
GitLab documentation
Compare GitLab plans
Community forum
Contribute to GitLab
Provide feedback
Terms and privacy
Keyboard shortcuts
?
Snippets
Groups
Projects
Show more breadcrumbs
submarine
submarine.common-lisp.dev
Commits
c8c77b90
Commit
c8c77b90
authored
17 years ago
by
Ryszard Szopa
Browse files
Options
Downloads
Patches
Plain Diff
downloading and spellchecking
darcs-hash:d6ffc263bdf7bf6e2c45ac2e1fa45e4860053abe
parent
bb415a59
No related branches found
No related tags found
No related merge requests found
Changes
1
Hide whitespace changes
Inline
Side-by-side
Showing
1 changed file
index.html
+31
-10
31 additions, 10 deletions
index.html
with
31 additions
and
10 deletions
index.html
+
31
−
10
View file @
c8c77b90
...
...
@@ -16,28 +16,36 @@
<p>
Submarine is a Common Lisp library that's somewhere between a
PostgreSQL library an an object persistency system. It uses
Postmodern to communicate with the database. The basic idea is that
you create your classes in the metaclass DB-CLASS and submarine cares
about creating SQL tables or, if the tables already exist, checking if
they conform to the provided specification. Moreover, Submarine
supports an intuitive way of expressing both one-to-many and
many-to-many relations.
</p>
<a
href=
"http://common-lisp.net/project/postmodern"
>
Postmodern
</a>
to
communicate with the database. The basic idea is that you create your
classes in the metaclass DB-CLASS and submarine cares about creating
SQL tables or, if the tables already exist, checking if they conform
to the provided specification. Moreover, Submarine supports an
intuitive way of expressing both one-to-many and many-to-many
relations.
</p>
<h1>
Table of contents
</h1>
<ol>
<li><a
href=
"#getting_submarine"
>
Getting Submarine
</a></li>
<li><a
href=
"#dependencies"
>
Dependencies
</a></li>
<li><a
href=
"#support_and_mailing_lists"
>
Support and mailing lists
</a></li>
<li><a
href=
"#license"
>
License
</a></li>
<li><a
href=
"#introduction_for_postmodern_users"
>
Introduction for
Postmodern users
</a></li>
<li><a
href=
"#api_reference"
>
API reference
</a></li>
<li><a
href=
"#quick_start"
>
Quick start
</a></li>
</ol>
<a
name=
"getting_submarine"
><h1>
Getting submarine
</h1></a>
<p>
At the moment there's only a darcs repository available:
</p>
<p>
You can download both
<a
href=
"submarine.tar.gz"
>
Submarine
</a>
,
and
<a
href=
"mop-utils.tar.gz"
>
MOP-utils
</a>
(a small library of MOP
related utilities on which Submarine depends). However, submarine
isn't very stable at the moment, so I strongly advise you to get the
newest version through darcs.
</p>
<code>
darcs get http://szopa.tasak.gda.pl/repos/submarine/
</code>
...
...
@@ -48,6 +56,11 @@ submarine in the close future:
<code>
darcs get http://szopa.tasak.gda.pl/repos/mop-utils/
</code>
<p>
In both cases (downloading the archive or getting it through darcs)
you will need to link the
<code>
.asd
</code>
files to some place
visible by
<code>
ASDF
</code>
.
</p>
<p>
I will make Submarine ASDF-installable soon.
</p>
<a
name=
"dependencies"
><h1>
Dependencies
</h1></a>
...
...
@@ -55,7 +68,15 @@ submarine in the close future:
library of MOP utilities, MOP-UTILS, which may become a separate
library in the future. On platforms other than SBCL, mop-utils needs
Closer-mop.
</p>
<a
name=
"support_and_mailing_lists"
>
<h1>
Support and mailing lists
</h1></a>
<p>
The
<a
href=
"http://common-lisp.net/mailman/listinfo/submarine-devel"
>
submarine-devel
</a>
mailing list can be used for questions, discussion, bug-reports,
patches, or anything else relating to this library. Or mail the
author/maintainer
directly:
<a
href=
"mailto:ryszard.szopa@gmail.com"
>
Ryszard
Szopa
</a>
.
</p>
<a
name=
"license"
><h1>
License
</h1></a>
<p>
Submarine is released under a BSD-like license. Which approximately
...
...
@@ -168,7 +189,7 @@ makes it easier to maintain and to extend.</li>
(:connection-spec "submarine-test" "richard" "dupa" "localhost"))
</pre>
</code>
<p>
The aguments in the :connection-spec are the following: name of the
<p>
The a
r
guments in the :connection-spec are the following: name of the
database, name of the user, password, host. The user should be able
to create tables in the given database.
</p>
<p>
Let's macroexpand last form:
</p>
...
...
This diff is collapsed.
Click to expand it.
Preview
0%
Loading
Try again
or
attach a new file
.
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Save comment
Cancel
Please
register
or
sign in
to comment