Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

improved documentation

  • Loading branch information...
commit 13c5e78c0f1746cc0f6dd92e19e8b0e1a0847125 1 parent 7d3da4a
@ceelian authored
View
5 THANKS
@@ -1,2 +1,5 @@
-Thanks to Ask Solem <askh@opera.com> for the carrot library
+Thanks to the python-couchdb team for writing a python couchdb driver and
+inspired the development of Flatty with their couchdb mapper which has a
+different approach (http://code.google.com/p/couchdb-python/)
+
Thanks to Wingware <http://wingware.com> for supportung us with their IDE
View
6 doc/source/couchdb.rst
@@ -1,6 +1,6 @@
-=====================================
-flatty.couch
-=====================================
+**********************************
+flatty.couch - the couchdb adapter
+**********************************
This module helps you to build schemas for couchdb (it uses the couchdb-python
module for storing the flattened dicts as couchdb documents)
View
15 doc/source/develop.rst
@@ -29,11 +29,24 @@ Commit and Tag
in the shell::
+ #clean stuff
cd doc
make clean
python setup.py clean
+ # tag, commit and push to github
git commit -a
+ git push
git tag -a vX.X.X
- git push --tags
+ git push --tags
+
+ # upload to pypi
+ python setup.py sdist upload
+
+ # make doc and upload
+ cd doc
+ make html
+
+ python setup.py upload_sphinx
+
View
6 doc/source/flatty.rst
@@ -1,6 +1,6 @@
-======
-flatty
-======
+=================
+flatty - the core
+=================
View
32 doc/source/introduction.rst
@@ -14,11 +14,39 @@ the data (no meta-data is stored).
**Key Features:**
- easy to use
+ - couchdb adapter to use flatty schemas with couchdb
- only plain data is marshaled, no class meta-data
- extensible, add custom converters for your own needs and types
- can be easily extended to support unique features of a marshal framework
- light-weight (flatty has currently less than 200 lines of code)
- OpenSource BSD-licensed
+
+
+**Full documentation can be found on** `PyPi Flatty Documentation`_
+
+.. _`PyPi Flatty Documentation`: http://packages.python.org/flatty/index.html
+
+
+Idea behind Flatty
+------------------
+
+The goal of Flatty is to provide a class-to-dict marshaller which stays in the
+background on top of other low-level marshallers. They might only support python
+dicts and some base types.
+
+With Flatty you can build a complete class schema and
+marshall/unmarshall (flatten/unflatten) high-level class objects to the low-level
+marshaller which provides the persistence layer.
+A good example where Flatty already provides an
+adapter is couchdb. We tried to keep the schema definition as much as possible
+"standard python" and gather the needed information through inspection to keep
+things easy.
+
+Flatty reduces everything to a simple dict, without storing metainformation in
+the marshalled data. The marshalling process Flatty uses is simple:
+It treats classes as dicts and their attributes as key-value pairs in the dict.
+Lists are stored as lists. That's it.
+
Getting started with Flatty
@@ -104,8 +132,8 @@ Getting started with Flatty
The restored_obj is a new object filled with the data of flatted
-Bug Tracker:
-------------
+Bug Tracker
+-----------
If you find any issues please report them on https://github.com/ceelian/Flatty/issues
Please sign in to comment.
Something went wrong with that request. Please try again.