Metadata-Version: 2.4
Name: psycopg-yugabytedb-binary
Version: 3.3.4.1
Summary: YugabyteDB smart-driver — C optimisation distribution (fork of psycopg-c)
Author-email: Daniele Varrazzo <daniele.varrazzo@gmail.com>, Yugabyte <support@yugabyte.com>
License-Expression: LGPL-3.0-only
Project-URL: Homepage, https://www.yugabyte.com/
Project-URL: Documentation, https://docs.yugabyte.com/preview/drivers-orms/python/
Project-URL: Upstream psycopg, https://psycopg.org/
Project-URL: Code, https://github.com/yugabyte/psycopg
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Programming Language :: Cython
Classifier: Programming Language :: Python :: 3 :: Only
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 :: Implementation :: CPython
Classifier: Topic :: Database
Classifier: Topic :: Database :: Front-Ends
Classifier: Topic :: Software Development
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/x-rst
License-File: LICENSE.txt
Dynamic: license-file

psycopg-yugabytedb: YugabyteDB smart-driver — binary package
============================================================

This distribution package is an optional component of
`psycopg-yugabytedb`__: it contains the C-accelerated
``psycopg_binary`` package, pre-compiled with a bundled ``libpq`` so
no build tools or PostgreSQL client library are required on the target
machine.

.. __: https://pypi.org/project/psycopg-yugabytedb/

You shouldn't install this package directly. Use instead ::

    pip install "psycopg-yugabytedb[binary]"

which pulls in a binary matching the pure-Python ``psycopg-yugabytedb``
version installed. Installing this package requires pip >= 20.3.

Wheels are published for the following platforms:

* macOS 11+ on Apple Silicon (arm64)
* Linux x86_64 (manylinux_2_17 / manylinux2014)
* CPython 3.10, 3.11, 3.12, 3.13, 3.14

For other platforms fall back to installing ``psycopg-yugabytedb`` and
letting it compile against the system ``libpq`` (requires
``libpq-dev`` / ``libpq-devel`` and a C toolchain).

About the fork
--------------

``psycopg-yugabytedb`` is a fork of `psycopg 3`__ that adds
cluster-aware and topology-aware connection load balancing for
`YugabyteDB`__. Application code doesn't change — the import name
stays ``psycopg``; adding ``load_balance_hosts=true`` to the conninfo
string opts into the smart-driver behaviour.

The C extension in this binary distribution is unmodified from
upstream; only the packaging metadata and bundled dependencies change.

.. __: https://pypi.org/project/psycopg/
.. __: https://www.yugabyte.com/

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

* Fork readme and usage examples:
  https://github.com/yugabyte/psycopg#readme
* Upstream psycopg documentation (API reference):
  https://www.psycopg.org/psycopg3/docs/


Copyright (C) 2020 The Psycopg Team
Copyright (C) 2026 Yugabyte
