Deployment documentation enhancements.

master
baztian 2011-01-27 15:47:46 +01:00
parent 1197f43558
commit 3f30de60de
4 changed files with 67 additions and 31 deletions

View File

@ -150,7 +150,7 @@ distribution for details.
Changelog
=========
- trunk
- 0.1.3
- Fixed DB-API_ violation: Use ``curs.execute('foo ?', (bar, baz))``
instead of ``curs.execute('foo ?', bar, baz)``.

View File

@ -22,13 +22,21 @@ Build a new release
$ nosetests
3. Add a changelog entry to ``README.rst``.
4. Add a changelog entry to ``README.rst``.
4. Increase version in ``setup.py``.
5. Increase version in ``setup.py``.
5. Run setuptools to ensure everything is working as expected. ::
6. Run setuptools to ensure everything is working as expected. ::
$ python setup.py sdist
$ python setup.py sdist --formats=gztar
7. Check the file createt by sdist for unwanted or missing files.
8. Install the sdist in a fresh virtualenv. ::
$ virtualenv tmp
$ . tmp/bin/activate
$ easy_install path_to_build_folder/jaydebeapi-0.x.tar.gz
6. Commit your changes. ::

View File

@ -24,7 +24,7 @@ print find_packages('src')
setup(
#basic package data
name = 'JayDeBeApi',
version = '0.1.2',
version = '0.1.3',
author = 'Bastian Bowe',
author_email = 'bastian.bowe@gmail.com',
license = 'GNU LGPL',

View File

@ -1,14 +1,14 @@
Metadata-Version: 1.0
Name: JayDeBeApi
Version: 0.1.2
Version: 0.1.3
Summary: A bridge from JDBC database drivers to Python DB-API.
Home-page: https://launchpad.net/jaydebeapi
Author: Bastian Bowe
Author-email: bastian.bowe@gmail.com
License: GNU LGPL
Description: =====================================================================
Description: =================================================================
JayDeBeApi - bridge from JDBC database drivers to Python DB-API
=====================================================================
=================================================================
The JayDeBeApi module allows you to connect from Python code to
databases using Java `JDBC
@ -93,8 +93,9 @@ Description: ===================================================================
Now I have to configure JPype
>>> import jpype
>>> jar = '/path/to/my/driver/hsqldb.jar'
>>> jar = r'/path/to/my/driver/hsqldb.jar'
>>> args='-Djava.class.path=%s' % jar
>>> jvm_path = jpype.getDefaultJVMPath()
>>> jpype.startJVM(jvm_path, args)
or in Jython I have to
@ -109,12 +110,35 @@ Description: ===================================================================
In theory every database with a suitable JDBC driver should work. It
is known to work with the following databases:
* `SQLite 3 <http://www.sqlite.org/>`_ using `SqliteJDBC
<http://www.zentus.com/sqlitejdbc/>`_ v056
* `Hypersonic SQL (HSQLDB) <http://hsqldb.org/>`_ 1.8.1.3
* `IBM DB2 <http://www.ibm.com/software/data/db2/>`_ for z/OS using
JDBC type 4 drivers.
+-----------------------------------------+------------------------------------------------+---------------+----------------------+
|Database |JDBC driver |Supported |Remarks |
+=========================================+================================================+===============+======================+
|`SQLite |`SqliteJDBC |Good |Can't interpret |
|<http://www.sqlite.org/>`_ |<http://www.zentus.com/sqlitejdbc/>`_ v056 | |selected BLOBs |
|3 | | |correctly. |
+-----------------------------------------+------------------------------------------------+---------------+----------------------+
| |`Sqlite Java Wrapper |Medium |Weird type handling. |
| |<http://www.ch-werner.de/javasqlite/>`_ | | |
| |javasqlite-20110106-win32 | | |
+-----------------------------------------+------------------------------------------------+---------------+----------------------+
|`Hypersonic SQL (HSQLDB) |Builtin |Very Good |No BLOB support |
|<http://hsqldb.org/>`_ 1.8.1.3 | | |by database. |
| | | | |
+-----------------------------------------+------------------------------------------------+---------------+----------------------+
|`Hypersonic SQL (HSQLDB) |Builtin |Medium |Weird decimal |
|<http://hsqldb.org/>`_ 2 | | |type |
| | | |conversions. No |
| | | |BLOB support. |
+-----------------------------------------+------------------------------------------------+---------------+----------------------+
|`IBM DB2 |JDBC type 4 drivers from IBM (``db2jcc.jar``) |Medium. |Not thoroughly tested |
|<http://www.ibm.com/software/data/db2/>`_| | |but seems to work |
|for z/OS | | |without problems. |
+-----------------------------------------+------------------------------------------------+---------------+----------------------+
|Oracle 11g |Oracle Thin Driver |Medium |Not thooughly |
| | | |testst. No support for|
| | | |rading of timestamps |
| | | |yet. |
+-----------------------------------------+------------------------------------------------+---------------+----------------------+
Contributing
============
@ -134,23 +158,27 @@ Description: ===================================================================
Changelog
=========
- trunk
- 0.1.3
- Fixed DB-API_ violation: Use ``curs.execute('foo ?', (bar, baz))``
instead of ``curs.execute('foo ?', bar, baz)``.
- Free resources after ``executemany`` call.
- Improved type handling. Initial support for BLOB columns.
- 0.1.2
- ``easy_install JayDeBeApi`` should really work
- ``easy_install JayDeBeApi`` should really work.
- 0.1.1
- Fixed bug #688290 "NULL values with converters error on fetch."
- Fixed bug #684909 "Selecting ROWIDs errors out on fetch."
- Fixed bug #688290 "NULL values with converters error on fetch".
- Fixed bug #684909 "Selecting ROWIDs errors out on fetch".
- 0.1
- Initial release
- Initial release.
To do
=====