|
From: Oleg B. <no...@so...> - 2016-06-30 15:57:51
|
This is an automated email from the git hooks/post-receive script. It was
generated because a ref change was pushed to the repository containing
the project "SQLObject development repository".
The branch, master has been updated
via 2686101c67dc05258a9aa3855367ebdad28ebee1 (commit)
via 6d18c706d6e33c50f91b0f04c9ab0654bb16c160 (commit)
via 9330aef08568f8030798dcb58df99ae2f263cad4 (commit)
via 49e3c5a467631e5c0edd916a3f4530ae6509509c (commit)
via fb6b017b2f8360284287c95ad44d720b49ca8023 (commit)
via 9c92444dc04567dad5c7b3135cd95c3ded274987 (commit)
from 27ff3d8110f76cc8b9e4565b3dda5cd767f417ec (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
- Log -----------------------------------------------------------------
http://sourceforge.net/p/sqlobject/sqlobject/ci/2686101c67dc05258a9aa3855367ebdad28ebee1
commit 2686101c67dc05258a9aa3855367ebdad28ebee1
Author: Oleg Broytman <ph...@ph...>
Date: Thu Jun 30 18:38:00 2016 +0300
Use https for pypi.python.org
[skip ci]
diff --git a/docs/DeveloperGuide.txt b/docs/DeveloperGuide.txt
index bb43c06..3a04b21 100644
--- a/docs/DeveloperGuide.txt
+++ b/docs/DeveloperGuide.txt
@@ -179,7 +179,7 @@ Tests are important. Tests keep everything from falling apart. All
new additions should have tests.
Testing uses py.test, an alternative to ``unittest``. It is available at
-http://pytest.org/ and http://pypi.python.org/pypi/pytest. Read its `getting
+http://pytest.org/ and https://pypi.python.org/pypi/pytest. Read its `getting
started`_ document for more.
.. _getting started: http://pytest.org/latest/getting-started.html
@@ -226,7 +226,7 @@ Documentation
Please write documentation. Documentation should live in the docs/
directory. Pudge converts documentation from Restructured Text to
HTML. It presently requires kid 0.9.6, which must be obtained
-separately (for instance, from http://pypi.python.org/pypi/kid/0.9.6).
+separately (for instance, from https://pypi.python.org/pypi/kid/0.9.6).
.. image:: https://sourceforge.net/sflogo.php?group_id=74338&type=10
:target: https://sourceforge.net/projects/sqlobject
diff --git a/docs/download.txt b/docs/download.txt
index e556283..407330e 100644
--- a/docs/download.txt
+++ b/docs/download.txt
@@ -2,7 +2,7 @@ Download SQLObject
++++++++++++++++++
The latest releases are always available on the `Python Package Index
-<http://pypi.python.org/pypi/SQLObject>`_, and is installable
+<https://pypi.python.org/pypi/SQLObject>`_, and is installable
with `easy_install
<http://pythonhosted.org/setuptools/easy_install.html>`_.
diff --git a/sqlobject/compat.py b/sqlobject/compat.py
index 6b7d71b..7e8d0e1 100644
--- a/sqlobject/compat.py
+++ b/sqlobject/compat.py
@@ -1,7 +1,7 @@
import sys
import types
-# Credit to six authors: http://pypi.python.org/pypi/six
+# Credit to six authors: https://pypi.python.org/pypi/six
# License: MIT
http://sourceforge.net/p/sqlobject/sqlobject/ci/6d18c706d6e33c50f91b0f04c9ab0654bb16c160
commit 6d18c706d6e33c50f91b0f04c9ab0654bb16c160
Author: Oleg Broytman <ph...@ph...>
Date: Thu Jun 30 18:37:35 2016 +0300
Use the latest kid (0.9.6)
[skip ci]
diff --git a/docs/DeveloperGuide.txt b/docs/DeveloperGuide.txt
index 8d6aaa0..bb43c06 100644
--- a/docs/DeveloperGuide.txt
+++ b/docs/DeveloperGuide.txt
@@ -225,8 +225,8 @@ Documentation
Please write documentation. Documentation should live in the docs/
directory. Pudge converts documentation from Restructured Text to
-HTML. It presently requires kid 0.9.3, which must be obtained
-separately (for instance, from http://pypi.python.org/pypi/kid/0.9.3)
+HTML. It presently requires kid 0.9.6, which must be obtained
+separately (for instance, from http://pypi.python.org/pypi/kid/0.9.6).
.. image:: https://sourceforge.net/sflogo.php?group_id=74338&type=10
:target: https://sourceforge.net/projects/sqlobject
http://sourceforge.net/p/sqlobject/sqlobject/ci/9330aef08568f8030798dcb58df99ae2f263cad4
commit 9330aef08568f8030798dcb58df99ae2f263cad4
Author: Oleg Broytman <ph...@ph...>
Date: Thu Jun 30 17:50:37 2016 +0300
SQLObject architecture from the developer's point of view
[skip ci]
diff --git a/docs/DeveloperGuide.txt b/docs/DeveloperGuide.txt
index 283f004..8d6aaa0 100644
--- a/docs/DeveloperGuide.txt
+++ b/docs/DeveloperGuide.txt
@@ -32,6 +32,36 @@ Voila! The packages are globally installed, but the files from the
checkout were not copied into ``site-packages``. See `setuptools
<http://pythonhosted.org/setuptools/>`_ for more.
+Architecture
+============
+
+There are four main kinds of objects in SQLObject: tables, columns,
+connections and converters.
+
+Tables-related objects are in sqlobject/main.py module. There are two
+main classes: SQLObject and sqlmeta; the latter is not a metaclass but a
+parent class for sqlmeta attribute in every class - the authors tried to
+move there all attributes and methods not directly related to columns to
+avoid cluttering table namespace.
+
+Columns are instances of classes from sqlobject/col.py. There are two
+classes for every column: one is for user to include into an instance of
+SQLObject, an instance of the other is automatically created by
+SQLObject metaclass. The two classes are names SOCol and Col; for
+example, SOBoolCol and BoolCol.
+
+Connections are instances of DBConnection class (from
+sqlobject/dbconnection.py ) and its concrete descendants. DBConnection
+contains generic code for generating SQL, working with transactions and
+so on. Concrete connection classes (like PostgresConnection and
+SQLiteConnection) provides backend-specific functionality.
+
+Converters from sqlobject/converters.py aren't visible to the user. They
+are used behind the scene to convert object to SQL strings. The most
+elaborated converter there is StringConverters. Yes, it converts strings
+to strings. It converts python strings to SQL strings using
+backend-specific quoting rules.
+
Style Guide
===========
http://sourceforge.net/p/sqlobject/sqlobject/ci/49e3c5a467631e5c0edd916a3f4530ae6509509c
commit 49e3c5a467631e5c0edd916a3f4530ae6509509c
Author: Oleg Broytman <ph...@ph...>
Date: Thu Jun 30 17:49:54 2016 +0300
Explain why a dev should fork and clone
[skip ci]
diff --git a/docs/DeveloperGuide.txt b/docs/DeveloperGuide.txt
index 1eb8529..283f004 100644
--- a/docs/DeveloperGuide.txt
+++ b/docs/DeveloperGuide.txt
@@ -24,6 +24,10 @@ Then do the same for SQLObject::
$ cd sqlobject
$ sudo python setup.py develop
+Or rather fork it and clone your fork. To develop a feature or a bugfix
+create a separate branch, push it to your fork and create a pull request
+to the original repo. That way CI will be triggered to test your code.
+
Voila! The packages are globally installed, but the files from the
checkout were not copied into ``site-packages``. See `setuptools
<http://pythonhosted.org/setuptools/>`_ for more.
http://sourceforge.net/p/sqlobject/sqlobject/ci/fb6b017b2f8360284287c95ad44d720b49ca8023
commit fb6b017b2f8360284287c95ad44d720b49ca8023
Author: Oleg Broytman <ph...@ph...>
Date: Thu Jun 30 17:48:51 2016 +0300
Change clone URL from SF to github
[skip ci]
diff --git a/docs/DeveloperGuide.txt b/docs/DeveloperGuide.txt
index d339cd4..1eb8529 100644
--- a/docs/DeveloperGuide.txt
+++ b/docs/DeveloperGuide.txt
@@ -20,7 +20,7 @@ First install `FormEncode <http://www.formencode.org/en/latest/download.html>`_:
Then do the same for SQLObject::
- $ git clone git clone git://git.code.sf.net/p/sqlobject/sqlobject
+ $ git clone git clone git://github.com/sqlobject/sqlobject
$ cd sqlobject
$ sudo python setup.py develop
http://sourceforge.net/p/sqlobject/sqlobject/ci/9c92444dc04567dad5c7b3135cd95c3ded274987
commit 9c92444dc04567dad5c7b3135cd95c3ded274987
Author: Oleg Broytman <ph...@ph...>
Date: Thu Jun 30 17:47:51 2016 +0300
Gonna extend the dev guide
[skip ci]
diff --git a/docs/DeveloperGuide.txt b/docs/DeveloperGuide.txt
index 4453733..d339cd4 100644
--- a/docs/DeveloperGuide.txt
+++ b/docs/DeveloperGuide.txt
@@ -7,10 +7,7 @@ SQLObject Developer Guide
.. _start:
-These are some notes on developing SQLObject. I'll try to expand them
-as things come up.
-
- -- Ian Bicking
+These are some notes on developing SQLObject.
Development Installation
========================
-----------------------------------------------------------------------
Summary of changes:
docs/DeveloperGuide.txt | 47 +++++++++++++++++++++++++++++++++++++++--------
docs/download.txt | 2 +-
sqlobject/compat.py | 2 +-
3 files changed, 41 insertions(+), 10 deletions(-)
hooks/post-receive
--
SQLObject development repository
|
