sqlobject 3.13.1b1__tar.gz → 3.14.0__tar.gz

sqlobject-3.14.0/ANNOUNCE.rst

@@ -0,0 +1,120 @@
+Hello!
+
+I'm pleased to announce version 3.13.2a0, the 2nd bugfix of the
+branch 3.13 of SQLObject.
+
+
+What's new in SQLObject
+=======================
+
+The contributor for this release is Neil Muller.
+Many thanks for the pull requests!
+
+Minor features
+--------------
+
+* Tweak ``load_module_from_file`` to work on Python 3.15.
+
+Build
+-----
+
+* Fix ``egg-info`` name in ``.gitignore``: it's now completely lowercase.
+
+* Tested with Python 3.15. Not all drivers work but most are ok.
+
+Drivers
+-------
+
+* Add ``pymysql`` to the list requiring encoding before submission,
+  to work around the changes in ``pymysql`` 1.2.1.
+
+
+For a more complete list, please see the news:
+http://sqlobject.org/News.html
+
+
+What is SQLObject
+=================
+
+SQLObject is a free and open-source (LGPL) Python object-relational
+mapper.  Your database tables are described as classes, and rows are
+instances of those classes.  SQLObject is meant to be easy to use and
+quick to get started with.
+
+SQLObject supports a number of backends: MySQL/MariaDB (with a number of
+DB API drivers: ``MySQLdb``, ``mysqlclient``, ``mysql-connector``,
+``PyMySQL``, ``mariadb``), PostgreSQL (``psycopg``, ``psycopg2``, ``PyGreSQL``,
+partially ``pg8000``), SQLite (builtin ``sqlite3``);
+connections to other backends - Firebird, Sybase, MSSQL and MaxDB (also
+known as SAPDB) - are less debugged).
+
+Python 2.7 or 3.4+ is required.
+
+
+Where is SQLObject
+==================
+
+Site:
+http://sqlobject.org
+
+Download:
+https://pypi.org/project/SQLObject/3.13.2a0.dev20251208/
+
+News and changes:
+http://sqlobject.org/News.html
+
+StackOverflow:
+https://stackoverflow.com/questions/tagged/sqlobject
+
+Mailing lists:
+https://sourceforge.net/p/sqlobject/mailman/
+
+Development:
+http://sqlobject.org/devel/
+
+Developer Guide:
+http://sqlobject.org/DeveloperGuide.html
+
+
+Example
+=======
+
+Install::
+
+  $ pip install sqlobject
+
+Create a simple class that wraps a table::
+
+  >>> from sqlobject import *
+  >>>
+  >>> sqlhub.processConnection = connectionForURI('sqlite:/:memory:')
+  >>>
+  >>> class Person(SQLObject):
+  ...     fname = StringCol()
+  ...     mi = StringCol(length=1, default=None)
+  ...     lname = StringCol()
+  ...
+  >>> Person.createTable()
+
+Use the object::
+
+  >>> p = Person(fname="John", lname="Doe")
+  >>> p
+  <Person 1 fname='John' mi=None lname='Doe'>
+  >>> p.fname
+  'John'
+  >>> p.mi = 'Q'
+  >>> p2 = Person.get(1)
+  >>> p2
+  <Person 1 fname='John' mi='Q' lname='Doe'>
+  >>> p is p2
+  True
+
+Queries::
+
+  >>> p3 = Person.selectBy(lname="Doe")[0]
+  >>> p3
+  <Person 1 fname='John' mi='Q' lname='Doe'>
+  >>> pc = Person.select(Person.q.lname=="Doe").count()
+  >>> pc
+  1

sqlobject-3.14.0/PKG-INFO

@@ -0,0 +1,89 @@
+Metadata-Version: 2.1
+Name: sqlobject
+Version: 3.14.0
+Summary: Object-Relational Manager, aka database wrapper
+Home-page: http://sqlobject.org/
+Author: Ian Bicking
+Author-email: ianb@colorstudy.com
+Maintainer: Oleg Broytman
+Maintainer-email: phd@phdru.name
+License: LGPL
+Download-URL: https://pypi.org/project/sqlobject/3.14.0/
+Project-URL: Issue tracker, https://github.com/sqlobject/sqlobject/issues
+Project-URL: Wikipedia, https://en.wikipedia.org/wiki/SQLObject
+Project-URL: Development docs, http://sqlobject.org/devel/
+Project-URL: Download, https://pypi.org/project/sqlobject/3.14.0/
+Project-URL: Github repo, https://github.com/sqlobject
+Project-URL: SourceForge project, https://sourceforge.net/projects/sqlobject/
+Project-URL: Homepage, http://sqlobject.org/
+Project-URL: Twitter, https://twitter.com/SQLObject
+Description: SQLObject is a popular *Object Relational Manager* for providing an
+        object interface to your database, with tables as classes, rows as
+        instances, and columns as attributes.
+        
+        SQLObject includes a Python-object-based query language that makes SQL
+        more abstract, and provides substantial database independence for
+        applications.
+        
+        Supports MySQL, PostgreSQL, SQLite, Firebird, Sybase, MSSQL and MaxDB (SAPDB).
+        Python 2.7 or 3.4+ is required.
+        
+        For development see the projects at
+        `SourceForge <https://sourceforge.net/projects/sqlobject/>`_
+        and `GitHub <https://github.com/sqlobject>`_.
+        
+        .. image:: https://github.com/sqlobject/sqlobject/actions/workflows/run-tests.yaml/badge.svg?branch=github-actions
+           :target: https://github.com/sqlobject/sqlobject/actions/workflows/run-tests.yaml
+        
+Keywords: sql,orm,object-relational mapper
+Platform: Any
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: GNU Library or Lesser General Public License (LGPL)
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 2
+Classifier: Programming Language :: Python :: 2.7
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.4
+Classifier: Programming Language :: Python :: 3.5
+Classifier: Programming Language :: Python :: 3.6
+Classifier: Programming Language :: Python :: 3.7
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Topic :: Database
+Classifier: Topic :: Database :: Front-Ends
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires: FormEncode
+Requires: PyDispatcher
+Requires-Python: >=2.7, !=3.0.*, !=3.1.*, !=3.2.*, !=3.3.*
+Description-Content-Type: text/x-rst
+Provides-Extra: mysql
+Provides-Extra: odbc
+Provides-Extra: kinterbasdb
+Provides-Extra: psycopg
+Provides-Extra: postgres
+Provides-Extra: psycopg2-binary
+Provides-Extra: pymysql
+Provides-Extra: sapdb
+Provides-Extra: adodbapi
+Provides-Extra: zope-dt
+Provides-Extra: pypyodbc
+Provides-Extra: mysql-connector-python
+Provides-Extra: pg8000
+Provides-Extra: sybase
+Provides-Extra: pymssql
+Provides-Extra: mariadb
+Provides-Extra: pygresql
+Provides-Extra: firebirdsql
+Provides-Extra: psycopg-c
+Provides-Extra: fdb
+Provides-Extra: postgresql
+Provides-Extra: psycopg2
+Provides-Extra: mysql-connector
+Provides-Extra: pyodbc

sqlobject-3.14.0/README.rst

@@ -0,0 +1,85 @@
+SQLObject 3.14.0
+================
+
+SQLObject is a free and open-source (LGPL) Python object-relational
+mapper.  Your database tables are described as classes, and rows are
+instances of those classes.  SQLObject is meant to be easy to use and
+quick to get started with.
+
+SQLObject supports a number of backends: MySQL/MariaDB (with a number of
+DB API drivers: ``MySQLdb``, ``mysqlclient``, ``mysql-connector``,
+``PyMySQL``, ``mariadb``), PostgreSQL (``psycopg``, ``psycopg2``, ``PyGreSQL``,
+partially ``pg8000``), SQLite (builtin ``sqlite3``);
+connections to other backends - Firebird, Sybase, MSSQL and MaxDB (also
+known as SAPDB) - are less debugged).
+
+Python 2.7 or 3.4+ is required.
+
+
+Where is SQLObject
+==================
+
+Site:
+http://sqlobject.org
+
+Download:
+https://pypi.org/project/SQLObject/
+
+News and changes:
+http://sqlobject.org/News.html
+
+StackOverflow:
+https://stackoverflow.com/questions/tagged/sqlobject
+
+Mailing lists:
+https://sourceforge.net/p/sqlobject/mailman/
+
+Development:
+http://sqlobject.org/devel/
+
+Developer Guide:
+http://sqlobject.org/DeveloperGuide.html
+
+
+Example
+=======
+
+Install::
+
+  $ pip install sqlobject
+
+Create a simple class that wraps a table::
+
+  >>> from sqlobject import *
+  >>>
+  >>> sqlhub.processConnection = connectionForURI('sqlite:/:memory:')
+  >>>
+  >>> class Person(SQLObject):
+  ...     fname = StringCol()
+  ...     mi = StringCol(length=1, default=None)
+  ...     lname = StringCol()
+  ...
+  >>> Person.createTable()
+
+Use the object::
+
+  >>> p = Person(fname="John", lname="Doe")
+  >>> p
+  <Person 1 fname='John' mi=None lname='Doe'>
+  >>> p.fname
+  'John'
+  >>> p.mi = 'Q'
+  >>> p2 = Person.get(1)
+  >>> p2
+  <Person 1 fname='John' mi='Q' lname='Doe'>
+  >>> p is p2
+  True
+
+Queries::
+
+  >>> p3 = Person.selectBy(lname="Doe")[0]
+  >>> p3
+  <Person 1 fname='John' mi='Q' lname='Doe'>
+  >>> pc = Person.select(Person.q.lname=="Doe").count()
+  >>> pc
+  1

sqlobject-3.14.0/docs/News.rst

@@ -0,0 +1,325 @@
+++++
+News
+++++
+
+.. contents:: Contents:
+   :backlinks: none
+
+SQLObject development (master)
+==============================
+
+SQLObject 3.14.0
+================
+
+Released 2026 Oct 16.
+
+Minor features
+--------------
+
+* Tweak ``load_module_from_file`` to work on Python 3.15.
+
+Build
+-----
+
+* Fix ``egg-info`` name in ``.gitignore``: it's now completely lowercase.
+
+* Tested with Python 3.15. Not all drivers work but most are ok.
+
+Drivers
+-------
+
+* Add ``pymysql`` to the list requiring encoding before submission,
+  to work around the changes in ``pymysql`` 1.2.1.
+
+SQLObject 3.13.1
+================
+
+Released 2025 Dec 08.
+
+Bug fixes
+---------
+
+* ``UuidValidator.from_python()`` now accepts strings as a valid input.
+  This fixes #199.
+
+* Fixed #197: a bug in ``dbconnection.ConnectionURIOpener.registerConnection``
+  triggered by non-empty instance's ``name``. The bug was inserted in 2004 so
+  it seems nobody ever used named instances. Fixed anyway.
+
+* Fixed #195: Minor ``NameError`` in ``pgconnection.py``
+  when using ``psycopg`` version 1 with a non-default port.
+
+Tests
+-----
+
+* Tested with Python 3.14.
+
+* Run tests with source-only (non-binary) ``psycopg`` and ``psycopg2``.
+
+SQLObject 3.13.0
+================
+
+Released 2025 Mar 07.
+
+Drivers
+-------
+
+* Extended default list of MySQL drivers to ``mysqldb``, ``mysqlclient``,
+  ``mysql-connector``, ``mysql-connector-python``, ``pymysql``.
+
+* Extended default list of PostgreSQL drivers to ``psycopg``, ``psycopg2``,
+  ``pygresql``, ``pg8000``.
+
+* Fixed outstanding problems with ``psycopg``. It's now the first class driver.
+
+* Fixed all problems with ``pg8000``. It's now the first class driver.
+
+* Dropped support for ``CyMySQL``;
+  its author refused to fix unicode-related problems.
+
+* Dropped support for ``py-postgresql``; it's completely broken
+  with debianized ``Postgres`` and the authors reject fixes.
+
+Tests
+-----
+
+* Added tests for ``mysqldb`` (aka ``mysql-python``)
+  and ``mysqlclient`` on w32.
+
+* Improved tests of ``mysql-connector`` and ``mysql-connector-python``.
+
+CI
+--
+
+* Tests(GHActions): Fixed old bugs in the workflow on w32.
+
+* Run tests with ``psycopg[c]``.
+
+SQLObject 3.12.0.post2
+======================
+
+Released 2025 Feb 01.
+
+Installation/dependencies
+-------------------------
+
+* Use ``FormEncode`` 2.1.1 for Python 3.13.
+
+SQLObject 3.12.0
+================
+
+Released 2024 Dec 20.
+
+Drivers
+-------
+
+* Add support for CyMySQL; there're some problems with unicode yet.
+
+* Separate ``psycopg`` and ``psycopg2``;
+  ``psycopg`` is actually ``psycopg3`` now; not all tests pass.
+
+* Minor fix in getting error code from PyGreSQL.
+
+* Dropped ``oursql``. It wasn't updated in years.
+
+* Dropped ``PySQLite2``. Only builtin ``sqlite3`` is supported.
+
+Tests
+-----
+
+* Run tests with Python 3.13.
+
+* Run tests with ``psycopg-c``; not all tests pass.
+
+* Fix ``test_exceptions.py`` under MariaDB, PostgreSQL and SQLite.
+
+* ``py-postgres``: Set ``sslmode`` to ``allow``;
+  upstream changed default to ``prefer``.
+
+CI
+--
+
+* Run tests with ``PyGreSQL`` on w32, do not ignore errors.
+
+* Skip tests with ``pg8000`` on w32.
+
+* GHActions: Switch to ``setup-miniconda``.
+
+* GHActions: Python 3.13.
+
+SQLObject 3.11.0
+================
+
+Released 2023 Nov 11.
+
+Features
+--------
+
+* Continue working on ``SQLRelatedJoin`` aliasing introduced in 3.10.2.
+  When a table joins with itself calling
+  ``relJoinCol.filter(thisClass.q.column)`` raises ``ValueError``
+  hinting that an alias is required for filtering.
+
+* Test that ``idType`` is either ``int`` or ``str``.
+
+* Added ``sqlmeta.idSize``. This sets the size of integer column ``id``
+  for MySQL and PostgreSQL. Allowed values are ``'TINY'``, ``'SMALL'``,
+  ``'MEDIUM'``, ``'BIG'``, ``None``; default is ``None``. For Postgres
+  mapped to ``smallserial``/``serial``/``bigserial``. For other backends
+  it's currently ignored. Feature request by Meet Gujrathi at
+  https://stackoverflow.com/q/77360075/7976758
+
+SQLObject 3.10.3
+================
+
+Released 2023 Oct 25.
+
+Bug fixes
+---------
+
+* Relaxed aliasing in ``SQLRelatedJoin`` introduced in 3.10.2 - aliasing
+  is required only when the table joins with itself. When there're two
+  tables to join aliasing prevents filtering -- wrong SQL is generated
+  in ``relJoinCol.filter(thisClass.q.column)``.
+
+Drivers
+-------
+
+* Fix(SQLiteConnection): Release connections from threads that are
+  no longer active. This fixes memory leak in multithreaded programs
+  in Windows.
+
+  ``SQLite`` requires different connections per thread so
+  ``SQLiteConnection`` creates and stores a connection per thread.
+  When a thread finishes its connections should be closed.
+  But if a program doesn't cooperate and doesn't close connections at
+  the end of a thread SQLObject leaks memory as connection objects are
+  stuck in ``SQLiteConnection``. On Linux the leak is negligible as
+  Linux reuses thread IDs so new connections replace old ones and old
+  connections are garbage collected. But Windows doesn't reuse thread
+  IDs so old connections pile and never released. To fix the problem
+  ``SQLiteConnection`` now enumerates threads and releases connections
+  from non-existing threads.
+
+* Dropped ``supersqlite``. It seems abandoned.
+  The last version 0.0.78 was released in 2018.
+
+Tests
+-----
+
+* Run tests with Python 3.12.
+
+CI
+--
+
+* GHActions: Ensure ``pip`` only if needed
+
+  This is to work around a problem in conda with Python 3.7 -
+  it brings in wrong version of ``setuptools`` incompatible with Python 3.7.
+
+SQLObject 3.10.2
+================
+
+Released 2023 Aug 09.
+
+Minor features
+--------------
+
+* Class ``Alias`` grows a method ``.select()`` to match ``SQLObject.select()``.
+
+Bug fixes
+---------
+
+* Fixed a bug in ``SQLRelatedJoin`` in the case where the table joins with
+  itself; in the resulting SQL two instances of the table must use different
+  aliases.
+
+CI
+--
+
+* Install all Python and PyPy versions from ``conda-forge``.
+
+SQLObject 3.10.1
+================
+
+Released 2022 Dec 22.
+
+Minor features
+--------------
+
+* Use ``module_loader.exec_module(module_loader.create_module())``
+  instead of ``module_loader.load_module()`` when available.
+
+Drivers
+-------
+
+* Added ``mysql-connector-python``.
+
+Tests
+-----
+
+* Run tests with Python 3.11.
+
+CI
+--
+
+* Ubuntu >= 22 and ``setup-python`` dropped Pythons < 3.7.
+  Use ``conda`` via ``s-weigand/setup-conda`` instead of ``setup-python``
+  to install older Pythons on Linux.
+
+SQLObject 3.10.0
+================
+
+Released 2022 Sep 20.
+
+Features
+--------
+
+* Allow connections in ``ConnectionHub`` to be strings.
+  This allows to open a new connection in every thread.
+
+* Add compatibility with ``Pendulum``.
+
+Tests
+-----
+
+* Run tests with Python 3.10.
+
+CI
+--
+
+* GitHub Actions.
+
+* Stop testing at Travis CI.
+
+* Stop testing at AppVeyor.
+
+Documentation
+-------------
+
+* DevGuide: source code must be pure ASCII.
+
+* DevGuide: ``reStructuredText`` format for docstrings is recommended.
+
+* DevGuide: de-facto good commit message format is required:
+  subject/body/trailers.
+
+* DevGuide: ``conventional commit`` format for commit message subject lines
+  is recommended.
+
+* DevGuide: ``Markdown`` format for commit message bodies is recommended.
+
+* DevGuide: commit messages must be pure ASCII.
+
+
+`Older news`__
+
+.. __: News6.html
+
+.. image:: https://sourceforge.net/sflogo.php?group_id=74338&type=10
+   :target: https://sourceforge.net/projects/sqlobject
+   :class: noborder
+   :align: center
+   :height: 15
+   :width: 80
+   :alt: Get SQLObject at SourceForge.net. Fast, secure and Free Open Source software downloads