Metadata-Version: 2.1
Name: mysqlx-connector-python
Version: 9.1.0
Summary: A Python driver which implements the X DevAPI, an Application Programming Interface for working with the MySQL Document Store.
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/
Description: 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 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>`_.
        
        
        
        
        
        
        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/installation/>`_.
        
        
        
        
        
        
        .. 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 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.
        
        
        
        
        Available options:
        
        * dns-srv
        * compression
        
        
        
        
        
        
        Sample Code
        -----------
        
        .. code:: python
        
            import mysqlx
        
            # Connect to server
            session = mysqlx.get_session(
               host="127.0.0.1",
               port=33060,
               user="mike",
               password="s3cr3t!")
            schema = session.get_schema("test")
        
            # Use the collection "my_collection"
            collection = schema.get_collection("my_collection")
        
            # Specify which document to find with Collection.find()
            result = collection.find("name like :param") \
                               .bind("param", "S%") \
                               .limit(1) \
                               .execute()
        
            # Print document
            docs = result.fetch_all()
            print(r"Name: {0}".format(docs[0]["name"]))
        
            # Close session
            session.close()
        
        
        
        
        Additional Resources
        --------------------
        
        
        - `MySQL Connector/Python X DevAPI Reference <https://dev.mysql.com/doc/dev/connector-python/>`_
        - `MySQL Connector/Python Forum <http://forums.mysql.com/list.php?50>`_
        - `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>`_
        - `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.md>`_ 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.
        
Keywords: mysql,database,db,connector,driver,xdevapi,nosql,docstore
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
Provides-Extra: compression
Provides-Extra: dns-srv
