dnrops
/
python-oracledb
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
442 Commits 9 Branches 16 Tags 4.8 MiB
Python 59.7%
Cython 38.4%
PLSQL 1.8%
Go to file
Anthony Tuininga 9645d4f9b3 Fix regression when using a connection type when creating a pool. 2023-12-19 14:54:57 -07:00
.github Address PR #145 and some additional line wrapping. 2023-02-14 10:48:53 -07:00
doc Preparing to release version 2.0.0. 2023-12-19 11:57:21 -07:00
samples Samples and documentation improvements. 2023-12-19 11:56:04 -07:00
src/oracledb Fix regression when using a connection type when creating a pool. 2023-12-19 14:54:57 -07:00
tests Fix regression when using a connection type when creating a pool. 2023-12-19 14:54:57 -07:00
utils Fix regression when using a connection type when creating a pool. 2023-12-19 14:54:57 -07:00
.gitignore Samples and documentation improvements. 2023-12-19 11:56:04 -07:00
.gitmodules Initial commit. 2022-05-20 16:08:18 -06:00
.pre-commit-config.yaml Black is now used to format Python code and ruff to lint Python code. 2023-10-10 14:19:11 -06:00
.readthedocs.yaml Attempt to make ReadTheDocs happy (2). 2022-05-25 10:35:05 -06:00
CONTRIBUTING.md Address PR #145 and some additional line wrapping. 2023-02-14 10:48:53 -07:00
LICENSE.txt Bump copyright. 2023-03-31 10:25:34 -06:00
MANIFEST.in Initial commit. 2022-05-20 16:08:18 -06:00
NOTICE.txt Preparing to release version 2.0.0. 2023-12-19 11:57:21 -07:00
README.md Samples and documentation improvements. 2023-12-19 11:56:04 -07:00
README.txt Black is now used to format Python code and ruff to lint Python code. 2023-10-10 14:19:11 -06:00
SECURITY.md Fix link and format (PR #219). 2023-09-04 20:51:02 -06:00
THIRD_PARTY_LICENSES.txt Black is now used to format Python code and ruff to lint Python code. 2023-10-10 14:19:11 -06:00
pyproject.toml Black is now used to format Python code and ruff to lint Python code. 2023-10-10 14:19:11 -06:00
setup.cfg Dropped support for Python 3.6 and added support for Python 3.12. 2023-09-21 17:37:02 -06:00
setup.py Black is now used to format Python code and ruff to lint Python code. 2023-10-10 14:19:11 -06:00
tox.ini Dropped support for Python 3.6 and added support for Python 3.12. 2023-09-21 17:37:02 -06:00

README.md

python-oracledb

python-oracledb is a Python programming language extension module allowing Python programs to connect to Oracle Database. It is the renamed, new major release of the popular cx_Oracle driver.

The module conforms to the Python Database API 2.0 specification with a considerable number of additions and a couple of minor exclusions, see the feature list.

Synchronous and concurrent coding styles are supported.

Installation

Run python -m pip install oracledb

See python-oracledb Installation.

Dependencies and Interoperability

  • Python versions 3.7 through 3.12.

    Prebuilt packages are available for these Python versions on Windows, on macOS and on Linux.

    Source code is also available.

  • Oracle Client libraries are optional.

    Thin mode: By default python-oracledb runs in a 'Thin' mode which connects directly to Oracle Database.

    Thick mode: Some advanced Oracle Database functionality is currently only available when optional Oracle Client libraries are loaded by python-oracledb. Libraries are available in the free Oracle Instant Client packages. Python-oracledb can use Oracle Client libraries 11.2 through 21c.

  • Oracle Database

    Thin mode: Oracle Database 12.1 (or later) is required.

    Thick mode: Oracle Database 11.2 (or later) is required, depending on the Oracle Client library version. Oracle Database's standard client-server version interoperability allows connection to both older and newer databases. For example when python-oracledb uses Oracle Client 19c libraries, then it can connect to Oracle Database 11.2 or later.

Documentation

See the python-oracledb Documentation and Release Notes.

Samples

Examples can be found in the /samples directory and the Python and Oracle Database Tutorial.

Help

Questions can be asked in Github Discussions.

Problem reports can be raised in GitHub Issues.

Tests

See /tests

Contributing

This project welcomes contributions from the community. Before submitting a pull request, please review our contribution guide.

Security

Please consult the security guide for our responsible security vulnerability disclosure process.

License

See LICENSE, THIRD_PARTY_LICENSES, and NOTICE.