mysqlx-connector-python 8.4.0__tar.gz → 9.0.0__tar.gz

{mysqlx-connector-python-8.4.0 → mysqlx-connector-python-9.0.0}/CONTRIBUTING.rst

@@ -23,7 +23,7 @@ Contributing to this project is easy. You just need to follow these steps.
 
 - Make sure you have a user account at `bugs.mysql.com <https://bugs.mysql.com>`_. You will need to reference this user account when you submit your Oracle Contributor Agreement (a.k.a. OCA).
 - Sign the Oracle Contributor Agreement. You can find instructions for doing that at the `OCA Page <https://oca.opensource.oracle.com/>`_.
-- Develop your pull request. Make sure you are aware of the `requirements <https://dev.mysql.com/doc/dev/connector-python/8.0/requirements.html>`_ for the project.
+- Develop your pull request. Make sure you are aware of the `requirements <https://dev.mysql.com/doc/dev/connector-python/requirements.html>`_ for the project.
 - Validate your pull request by including tests that sufficiently cover the functionality you are adding.
 - Verify that the entire test suite passes with your code applied.
 - Submit your pull request. While you can submit the pull request via `GitHub <https://github.com/mysql/mysql-connector-python/pulls>`_, you can also submit it directly via `bugs.mysql.com <https://bugs.mysql.com>`_.
@@ -35,7 +35,7 @@ Setting Up a Development Environment
 
 The following tips provide all the technical directions you should follow when writing code and before actually submitting your contribution.
 
-1) Make sure you have the necessary `prerequisites <https://dev.mysql.com/doc/dev/connector-python/8.0/installation.html#prerequisites>`_ for building the project and `Pylint <https://www.pylint.org/>`_ for static code analysis
+1) Make sure you have the necessary `prerequisites <https://dev.mysql.com/doc/dev/connector-python/installation.html#prerequisites>`_ for building the project and `Pylint <https://www.pylint.org/>`_ for static code analysis
 
 2) Clone MySQL Connector/Python
 

mysqlx-connector-python-9.0.0/INFO_BIN

@@ -0,0 +1,2 @@
+build-date: 2024-06-16 09:03:52 
+os-info: Linux-5.4.17-2136.328.3.el7uek.x86_64-x86_64-with-glibc2.17

mysqlx-connector-python-9.0.0/INFO_SRC

@@ -0,0 +1,4 @@
+version: 9.0.0
+branch: release/9.0.0
+commit: 59817f3de42d98ac2875a14ea265d77bd0ac3805
+short: 59817f3

{mysqlx-connector-python-8.4.0 → mysqlx-connector-python-9.0.0}/LICENSE.txt

@@ -1,6 +1,6 @@
 Licensing Information User Manual
 
-MySQL Connector/Python 8.4.0 Community
+MySQL Connector/Python 9.0.0 Community
      __________________________________________________________________
 
 Introduction
@@ -8,18 +8,18 @@ Introduction
    This License Information User Manual contains Oracle's product license
    and other licensing information, including licensing information for
    third-party software which may be included in this distribution of
-   MySQL Connector/Python 8.4.0 Community.
+   MySQL Connector/Python 9.0.0 Community.
 
-   Last updated: March 2024
+   Last updated: May 2024
 
 Licensing Information
 
-   This release of MySQL Connector/Python 8.4.0 Community is brought to
+   This release of MySQL Connector/Python 9.0.0 Community is brought to
    you by the MySQL team at Oracle. This software is released under
    version 2 of the GNU General Public License (GPLv2), as set forth
    below, with the following additional permissions:
 
-   This distribution of MySQL Connector/Python 8.4.0 Community is designed
+   This distribution of MySQL Connector/Python 9.0.0 Community is designed
    to work with certain software (including but not limited to OpenSSL)
    that is licensed under separate terms, as designated in a particular
    file or component or in the license documentation. Without limiting

{mysqlx-connector-python-8.4.0 → mysqlx-connector-python-9.0.0}/README.rst

@@ -8,39 +8,86 @@ 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) <https://www.python.org/dev/peps/pep-0249/>`_. It also contains an implementation of the `X DevAPI <https://dev.mysql.com/doc/x-devapi-userguide/en>`_, an Application Programming Interface for working with the `MySQL Document Store <https://dev.mysql.com/doc/refman/8.0/en/document-store.html>`_.
+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) <https://www.python.org/dev/peps/pep-0249/>`_ - We refer to it as the
+`Classic API <https://dev.mysql.com/doc/connector-python/en/connector-python-reference.html>`_.
+
+It also contains an implementation of the `XDevAPI <https://dev.mysql.com/doc/x-devapi-userguide/en>`_
+- An Application Programming Interface for working with the `MySQL Document Store
+<https://dev.mysql.com/doc/refman/en/document-store.html>`_.
+
+Features
+--------
+
+* `Asynchronous Connectivity <https://dev.mysql.com/doc/connector-python/en/connector-python-asyncio.html>`_
+* `C-extension <https://dev.mysql.com/doc/connector-python/en/connector-python-cext.html>`_
+* `Telemetry <https://dev.mysql.com/doc/connector-python/en/connector-python-opentelemetry.html>`_
+* `XDevAPI <https://dev.mysql.com/doc/x-devapi-userguide/en>`_
+
 
 Installation
 ------------
+
 The recommended way to install Connector/Python is via `pip <https://pip.pypa.io/>`_.
 
-Make sure you have a recent `pip <https://pip.pypa.io/>`_ 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 <https://pip.pypa.io/en/latest/installing/#installing-with-get-pip-py>`_.
+Make sure you have a recent `pip <https://pip.pypa.io/>`_ 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 <https://pip.pypa.io/en/latest/installation/>`_.
 
-+++++++
-Classic
-+++++++
+The *classic API* can be installed via pip as follows:
 
 .. code-block:: bash
 
-    shell> pip install mysql-connector-python
+    $ pip install mysql-connector-python
 
+, similarly, the *XDevAPI* can be installed with:
 
-+++++++
-XDevAPI
-+++++++
+.. code-block:: bash
+
+    $ pip install mysqlx-connector-python
+
+Please refer to the `installation tutorial <https://dev.mysql.com/doc/dev/connector-python/installation.html>`_
+for installation alternatives of the XDevAPI.
+
+++++++++++++++++++++
+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]
+
+similarly, for the XDevAPI:
 
 .. code-block:: bash
 
-    shell> pip install mysqlx-connector-python
+    # 3rd party packages to unleash the compression functionality are installed
+    $ pip install mysqlx-connector-python[compression]
+
+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.
 
+Options for the Classic connector:
 
-Please refer to the `installation tutorial <https://dev.mysql.com/doc/dev/connector-python/8.0/installation.html>`_ for installation alternatives of the X DevAPI.
+* dns-srv
+* gssapi
+* fido2
+* telemetry
 
+Options for the XDevAPI connector:
 
-Getting Started
----------------
+* dns-srv
+* compression
 
-Using the MySQL classic protocol:
+
+Classic
+-------
 
 .. code:: python
 
@@ -66,7 +113,9 @@ Using the MySQL classic protocol:
     # Close connection
     cnx.close()
 
-Using the MySQL X DevAPI:
+
+XDevAPI
+-------
 
 .. code:: python
 
@@ -97,8 +146,6 @@ Using the MySQL X DevAPI:
     session.close()
 
 
-Please refer to the `MySQL Connector/Python Developer Guide <https://dev.mysql.com/doc/connector-python/en/>`_ and the `MySQL Connector/Python X DevAPI Reference <https://dev.mysql.com/doc/dev/connector-python/>`_ for a complete usage guide.
-
 Additional Resources
 --------------------
 
@@ -108,14 +155,18 @@ Additional Resources
 - `MySQL Public Bug Tracker <https://bugs.mysql.com>`_
 - `Slack <https://mysqlcommunity.slack.com>`_ (`Sign-up <https://lefred.be/mysql-community-on-slack/>`_ required if you do not have an Oracle account)
 - `Stack Overflow <https://stackoverflow.com/questions/tagged/mysql-connector-python>`_
-- `InsideMySQL.com Connectors Blog <https://insidemysql.com/category/mysql-development/connectors/>`_
+- `Oracle Blogs <https://blogs.oracle.com/search.html?q=connector-python>`_
+
 
 Contributing
 ------------
 
-There are a few ways to contribute to the Connector/Python code. Please refer to the `contributing guidelines <CONTRIBUTING.rst>`_ for additional information.
+There are a few ways to contribute to the Connector/Python code. Please refer
+to the `contributing guidelines <CONTRIBUTING.rst>`_ for additional information.
+
 
 License
 -------
 
-Please refer to the `README.txt <README.txt>`_ and `LICENSE.txt <LICENSE.txt>`_ files, available in this repository, for further details.
+Please refer to the `README.txt <README.txt>`_ and `LICENSE.txt <LICENSE.txt>`_
+files, available in this repository, for further details.

{mysqlx-connector-python-8.4.0 → mysqlx-connector-python-9.0.0}/mysqlx/version.py

@@ -32,7 +32,7 @@ The file version.py gets installed and is available after installation
 as mysqlx.version.
 """
 
-VERSION = (8, 4, 0, "", 1)
+VERSION = (9, 0, 0, "", 1)
 
 # pylint: disable=consider-using-f-string
 if VERSION[3] and VERSION[4]:

{mysqlx-connector-python-8.4.0/mysqlx_connector_python-8.4.0-py3.8.egg-info → mysqlx-connector-python-9.0.0/mysqlx_connector_python-9.0.0-py3.8.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: mysqlx-connector-python
-Version: 8.4.0
+Version: 9.0.0
 Summary: XDevAPI MySQL driver written in Python
 Home-page: http://dev.mysql.com/doc/connector-python/en/index.html
 Author: Oracle and/or its affiliates

{mysqlx-connector-python-8.4.0/mysqlx_connector_python-8.4.0-py3.8.egg-info → mysqlx-connector-python-9.0.0/mysqlx_connector_python-9.0.0-py3.8.egg-info}/requires.txt

@@ -1,8 +1,8 @@
-protobuf<=4.21.12,>=4.21.1
+protobuf==4.25.3
 
 [compression]
 lz4<=4.3.2,>=2.1.6
 zstandard<=0.19.0,>=0.12.0
 
 [dns-srv]
-dnspython<=2.3.0,>=1.16.0
+dnspython==2.6.1

mysqlx-connector-python-8.4.0/INFO_BIN

@@ -1,2 +0,0 @@
-build-date: 2024-03-15 06:21:01 
-os-info: Linux-5.15.0-1052-oracle-x86_64-with-glibc2.35

mysqlx-connector-python-8.4.0/INFO_SRC

@@ -1,4 +0,0 @@
-version: 8.4.0
-branch: release/8.4.0
-commit: dc71cebe53615110ff00dbb8b629f5457ece1ddb
-short: dc71ceb