Metadata-Version: 2.1 Name: mysql-connector-python Version: 9.1.0 Summary: A self-contained Python driver for communicating with MySQL servers, using an API that is compliant with the Python Database API Specification v2.0 (PEP 249). Home-page: UNKNOWN Author: Oracle and/or its affiliates Author-email: License: GNU GPLv2 (with FOSS License Exception) Project-URL: Homepage, https://dev.mysql.com/doc/connector-python/en/ Project-URL: Documentation, https://dev.mysql.com/doc/connector-python/en/ Project-URL: Downloads, https://dev.mysql.com/downloads/connector/python/ Project-URL: Release Notes, https://dev.mysql.com/doc/relnotes/connector-python/en/ Project-URL: Source Code, https://github.com/mysql/mysql-connector-python Project-URL: Bug System, https://bugs.mysql.com/ Project-URL: Slack, https://mysqlcommunity.slack.com/messages/connectors Project-URL: Forums, https://forums.mysql.com/list.php?50 Project-URL: Blog, https://blogs.oracle.com/mysql/ Keywords: mysql,database,db,connector,driver Platform: UNKNOWN Classifier: Development Status :: 5 - Production/Stable Classifier: Intended Audience :: Developers Classifier: Intended Audience :: Education Classifier: License :: OSI Approved :: GNU General Public License (GPL) Classifier: Operating System :: MacOS :: MacOS X Classifier: Operating System :: Microsoft :: Windows Classifier: Operating System :: POSIX :: Linux Classifier: Operating System :: Unix Classifier: Programming Language :: Python :: 3 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: Topic :: Database Classifier: Topic :: Software Development Classifier: Topic :: Software Development :: Libraries :: Python Modules Classifier: Typing :: Typed Requires-Python: >=3.9 Description-Content-Type: text/x-rst License-File: LICENSE.txt Provides-Extra: dns-srv Requires-Dist: dnspython==2.6.1; extra == "dns-srv" Provides-Extra: fido2 Requires-Dist: fido2==1.1.2; extra == "fido2" Provides-Extra: gssapi Requires-Dist: gssapi==1.8.3; extra == "gssapi" Provides-Extra: telemetry Requires-Dist: opentelemetry-api==1.18.0; extra == "telemetry" Requires-Dist: opentelemetry-sdk==1.18.0; extra == "telemetry" Requires-Dist: opentelemetry-exporter-otlp-proto-http==1.18.0; extra == "telemetry" MySQL Connector/Python ====================== .. image:: https://img.shields.io/pypi/v/mysql-connector-python.svg :target: https://pypi.org/project/mysql-connector-python/ .. image:: https://img.shields.io/pypi/pyversions/mysql-connector-python.svg :target: https://pypi.org/project/mysql-connector-python/ .. image:: https://img.shields.io/pypi/l/mysql-connector-python.svg :target: https://pypi.org/project/mysql-connector-python/ MySQL Connector/Python enables Python programs to access MySQL databases, using an API that is compliant with the `Python Database API Specification v2.0 (PEP 249) `_ - We refer to it as the `Classic API `_. Features -------- * `Asynchronous Connectivity `_ * `C-extension `_ * `Telemetry `_ Installation ------------ The recommended way to install Connector/Python is via `pip `_. Make sure you have a recent `pip `_ version installed on your system. If your system already has ``pip`` installed, you might need to update it. Or you can use the `standalone pip installer `_. .. code-block:: bash $ pip install mysql-connector-python ++++++++++++++++++++ Installation Options ++++++++++++++++++++ Connector packages included in MySQL Connector/Python allow you to install optional dependencies to unleash certain functionalities. .. code-block:: bash # 3rd party packages to unleash the telemetry functionality are installed $ pip install mysql-connector-python[telemetry] This installation option can be seen as a shortcut to install all the dependencies needed by a particular feature. Mind that this is optional and you are free to install the required dependencies by yourself. Available options: * dns-srv * gssapi * fido2 * telemetry Sample Code ----------- .. code:: python import mysql.connector # Connect to server cnx = mysql.connector.connect( host="127.0.0.1", port=3306, user="mike", password="s3cre3t!") # Get a cursor cur = cnx.cursor() # Execute a query cur.execute("SELECT CURDATE()") # Fetch one result row = cur.fetchone() print("Current date is: {0}".format(row[0])) # Close connection cnx.close() Additional Resources -------------------- - `MySQL Connector/Python Developer Guide `_ - `MySQL Connector/Python Forum `_ - `MySQL Public Bug Tracker `_ - `Slack `_ (`Sign-up `_ required if you do not have an Oracle account) - `Stack Overflow `_ - `Oracle Blogs `_ Contributing ------------ There are a few ways to contribute to the Connector/Python code. Please refer to the `contributing guidelines `_ for additional information. License ------- Please refer to the `README.txt `_ and `LICENSE.txt `_ files, available in this repository, for further details.