adodbapi


Nameadodbapi JSON
Version 2.6.2.0 PyPI version JSON
download
home_pagehttp://sourceforge.net/projects/adodbapi
SummaryA pure Python package implementing PEP 249 DB-API using Microsoft ADO.
upload_time2019-11-26 02:24:50
maintainerVernon Cole
docs_urlNone
authorHenrik Ekelund, Vernon Cole, et.al.
requires_python
licenseLGPL
keywords database ado odbc dbapi db-api microsoft sql
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            Project
-------
adodbapi

A Python DB-API 2.0 (PEP-249) module that makes it easy to use Microsoft ADO 
for connecting with databases and other data sources
using either CPython or IronPython.

Home page: <http://sourceforge.net/projects/adodbapi>

Features:
* 100% DB-API 2.0 (PEP-249) compliant (including most extensions and recommendations).
* Includes pyunit testcases that describe how to use the module.  
* Fully implemented in Python. -- runs in Python 2.5+ Python 3.0+ and IronPython 2.6+
* Licensed under the LGPL license, which means that it can be used freely even in commercial programs subject to certain restrictions. 
* The user can choose between paramstyles: 'qmark' 'named' 'format' 'pyformat' 'dynamic'
* Supports data retrieval by column name e.g.:
  for row in myCurser.execute("select name,age from students"):
     print("Student", row.name, "is", row.age, "years old.")
* Supports user-definable system-to-Python data conversion functions (selected by ADO data type, or by column)

Prerequisites:
* C Python 2.7 or 3.5 or higher
 and pywin32 (Mark Hammond's python for windows extensions.)
or
 Iron Python 2.7 or higher.  (works in IPy2.0 for all data types except BUFFER)

Installation:
* (C-Python on Windows): Install pywin32 ("pip install pywin32") which includes adodbapi.
* (IronPython on Windows): Download adodbapi from http://sf.net/projects/adodbapi.  Unpack the zip.
     Open a command window as an administrator. CD to the folder containing the unzipped files.
     Run "setup.py install" using the IronPython of your choice.

NOTE: ...........
If you do not like the new default operation of returning Numeric columns as decimal.Decimal,
you can select other options by the user defined conversion feature. 
Try:
        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = adodbapi.apibase.cvtString
or:
        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = adodbapi.apibase.cvtFloat
or:
        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = write_your_own_convertion_function
		............
notes for 2.6.2:
    The definitive source has been moved to https://github.com/mhammond/pywin32/tree/master/adodbapi.
    Remote has proven too hard to configure and test with Pyro4. I am moving it to unsupported status
    until I can change to a different connection method.
whats new in version 2.6
   A cursor.prepare() method and support for prepared SQL statements.
   Lots of refactoring, especially of the Remote and Server modules (still to be treated as Beta code).
   The quick start document 'quick_reference.odt' will export as a nice-looking pdf.
   Added paramstyles 'pyformat' and 'dynamic'. If your 'paramstyle' is 'named' you _must_ pass a dictionary of
      parameters to your .execute() method. If your 'paramstyle' is 'format' 'pyformat' or 'dynamic', you _may_
      pass a dictionary of parameters -- provided your SQL operation string is formatted correctly.

whats new in version 2.5
   Remote module: (works on Linux!) allows a Windows computer to serve ADO databases via PyRO
   Server module: PyRO server for ADO.  Run using a command like= C:>python -m adodbapi.server
   (server has simple connection string macros: is64bit, getuser, sql_provider, auto_security)
   Brief documentation included.  See adodbapi/examples folder adodbapi.rtf
   New connection method conn.get_table_names() --> list of names of tables in database

   Vastly refactored. Data conversion things have been moved to the new adodbapi.apibase module.
   Many former module-level attributes are now class attributes. (Should be more thread-safe)
   Connection objects are now context managers for transactions and will commit or rollback.
   Cursor objects are context managers and will automatically close themselves.
   Autocommit can be switched on and off.
   Keyword and positional arguments on the connect() method work as documented in PEP 249.
   Keyword arguments from the connect call can be formatted into the connection string.
   New keyword arguments defined, such as: autocommit, paramstyle, remote_proxy, remote_port.
  *** Breaking change: variantConversion lookups are simplified: the following will raise KeyError:
         oldconverter=adodbapi.variantConversions[adodbapi.adoStringTypes]
      Refactor as: oldconverter=adodbapi.variantConversions[adodbapi.adoStringTypes[0]]

License
-------
LGPL, see http://www.opensource.org/licenses/lgpl-license.php

Documentation
-------------

Look at adodbapi/quick_reference.md
http://www.python.org/topics/database/DatabaseAPI-2.0.html
read the examples in adodbapi/examples
and look at the test cases in adodbapi/test directory.

Mailing lists
-------------
The adodbapi mailing lists have been deactivated. Submit comments to the 
pywin32 or IronPython mailing lists.
  -- the bug tracker on sourceforge.net/projects/adodbapi may be checked, (infrequently).
  -- please use: https://github.com/mhammond/pywin32/issues
            

Raw data

            {
    "_id": null,
    "home_page": "http://sourceforge.net/projects/adodbapi",
    "name": "adodbapi",
    "maintainer": "Vernon Cole",
    "docs_url": null,
    "requires_python": "",
    "maintainer_email": "vernondcole@gmail.com",
    "keywords": "database ado odbc dbapi db-api Microsoft SQL",
    "author": "Henrik Ekelund, Vernon Cole, et.al.",
    "author_email": "vernondcole@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/40/fc/914289fdaf33352ab3412fc1fdc96c4c902715601bc603859bc533b51f5c/adodbapi-2.6.2.0.zip",
    "platform": "Windows",
    "description": "Project\n-------\nadodbapi\n\nA Python DB-API 2.0 (PEP-249) module that makes it easy to use Microsoft ADO \nfor connecting with databases and other data sources\nusing either CPython or IronPython.\n\nHome page: <http://sourceforge.net/projects/adodbapi>\n\nFeatures:\n* 100% DB-API 2.0 (PEP-249) compliant (including most extensions and recommendations).\n* Includes pyunit testcases that describe how to use the module.  \n* Fully implemented in Python. -- runs in Python 2.5+ Python 3.0+ and IronPython 2.6+\n* Licensed under the LGPL license, which means that it can be used freely even in commercial programs subject to certain restrictions. \n* The user can choose between paramstyles: 'qmark' 'named' 'format' 'pyformat' 'dynamic'\n* Supports data retrieval by column name e.g.:\n  for row in myCurser.execute(\"select name,age from students\"):\n     print(\"Student\", row.name, \"is\", row.age, \"years old.\")\n* Supports user-definable system-to-Python data conversion functions (selected by ADO data type, or by column)\n\nPrerequisites:\n* C Python 2.7 or 3.5 or higher\n and pywin32 (Mark Hammond's python for windows extensions.)\nor\n Iron Python 2.7 or higher.  (works in IPy2.0 for all data types except BUFFER)\n\nInstallation:\n* (C-Python on Windows): Install pywin32 (\"pip install pywin32\") which includes adodbapi.\n* (IronPython on Windows): Download adodbapi from http://sf.net/projects/adodbapi.  Unpack the zip.\n     Open a command window as an administrator. CD to the folder containing the unzipped files.\n     Run \"setup.py install\" using the IronPython of your choice.\n\nNOTE: ...........\nIf you do not like the new default operation of returning Numeric columns as decimal.Decimal,\nyou can select other options by the user defined conversion feature. \nTry:\n        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = adodbapi.apibase.cvtString\nor:\n        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = adodbapi.apibase.cvtFloat\nor:\n        adodbapi.apibase.variantConversions[adodbapi.ado_consts.adNumeric] = write_your_own_convertion_function\n\t\t............\nnotes for 2.6.2:\n    The definitive source has been moved to https://github.com/mhammond/pywin32/tree/master/adodbapi.\n    Remote has proven too hard to configure and test with Pyro4. I am moving it to unsupported status\n    until I can change to a different connection method.\nwhats new in version 2.6\n   A cursor.prepare() method and support for prepared SQL statements.\n   Lots of refactoring, especially of the Remote and Server modules (still to be treated as Beta code).\n   The quick start document 'quick_reference.odt' will export as a nice-looking pdf.\n   Added paramstyles 'pyformat' and 'dynamic'. If your 'paramstyle' is 'named' you _must_ pass a dictionary of\n      parameters to your .execute() method. If your 'paramstyle' is 'format' 'pyformat' or 'dynamic', you _may_\n      pass a dictionary of parameters -- provided your SQL operation string is formatted correctly.\n\nwhats new in version 2.5\n   Remote module: (works on Linux!) allows a Windows computer to serve ADO databases via PyRO\n   Server module: PyRO server for ADO.  Run using a command like= C:>python -m adodbapi.server\n   (server has simple connection string macros: is64bit, getuser, sql_provider, auto_security)\n   Brief documentation included.  See adodbapi/examples folder adodbapi.rtf\n   New connection method conn.get_table_names() --> list of names of tables in database\n\n   Vastly refactored. Data conversion things have been moved to the new adodbapi.apibase module.\n   Many former module-level attributes are now class attributes. (Should be more thread-safe)\n   Connection objects are now context managers for transactions and will commit or rollback.\n   Cursor objects are context managers and will automatically close themselves.\n   Autocommit can be switched on and off.\n   Keyword and positional arguments on the connect() method work as documented in PEP 249.\n   Keyword arguments from the connect call can be formatted into the connection string.\n   New keyword arguments defined, such as: autocommit, paramstyle, remote_proxy, remote_port.\n  *** Breaking change: variantConversion lookups are simplified: the following will raise KeyError:\n         oldconverter=adodbapi.variantConversions[adodbapi.adoStringTypes]\n      Refactor as: oldconverter=adodbapi.variantConversions[adodbapi.adoStringTypes[0]]\n\nLicense\n-------\nLGPL, see http://www.opensource.org/licenses/lgpl-license.php\n\nDocumentation\n-------------\n\nLook at adodbapi/quick_reference.md\nhttp://www.python.org/topics/database/DatabaseAPI-2.0.html\nread the examples in adodbapi/examples\nand look at the test cases in adodbapi/test directory.\n\nMailing lists\n-------------\nThe adodbapi mailing lists have been deactivated. Submit comments to the \npywin32 or IronPython mailing lists.\n  -- the bug tracker on sourceforge.net/projects/adodbapi may be checked, (infrequently).\n  -- please use: https://github.com/mhammond/pywin32/issues",
    "bugtrack_url": null,
    "license": "LGPL",
    "summary": "A pure Python package implementing PEP 249 DB-API using Microsoft ADO.",
    "version": "2.6.2.0",
    "project_urls": {
        "Homepage": "http://sourceforge.net/projects/adodbapi"
    },
    "split_keywords": [
        "database",
        "ado",
        "odbc",
        "dbapi",
        "db-api",
        "microsoft",
        "sql"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "40fc914289fdaf33352ab3412fc1fdc96c4c902715601bc603859bc533b51f5c",
                "md5": "48b15ec689304edc253ef660e4a37298",
                "sha256": "4bbfce499849937c3b09d3a7be8e61a9a07c1e161390419fbfe78a0eef7b4148"
            },
            "downloads": -1,
            "filename": "adodbapi-2.6.2.0.zip",
            "has_sig": false,
            "md5_digest": "48b15ec689304edc253ef660e4a37298",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": null,
            "size": 297082,
            "upload_time": "2019-11-26T02:24:50",
            "upload_time_iso_8601": "2019-11-26T02:24:50.753725Z",
            "url": "https://files.pythonhosted.org/packages/40/fc/914289fdaf33352ab3412fc1fdc96c4c902715601bc603859bc533b51f5c/adodbapi-2.6.2.0.zip",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2019-11-26 02:24:50",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "adodbapi"
}
        
Elapsed time: 0.14206s