Metadata-Version: 1.2
Name: sqlalchemy-access
Version: 1.0.4
Summary: MS Access for SQLAlchemy
Home-page: https://github.com/sqlalchemy/sqlalchemy-access
Author: Gord Thompson
Author-email: gord@gordthompson.com
License: MIT
Project-URL: Documentation, https://github.com/sqlalchemy/sqlalchemy-access/wiki
Project-URL: Source, https://github.com/sqlalchemy/sqlalchemy-access
Project-URL: Tracker, https://github.com/sqlalchemy/sqlalchemy-access/issues
Description: sqlalchemy-access
        =================
        
        .. image:: https://img.shields.io/pypi/dm/sqlalchemy-access.svg
                :target: https://pypi.org/project/sqlalchemy-access/
        
        A Microsoft Access dialect for SQLAlchemy.
        
        Objectives
        ----------
        
        This dialect is mainly intended to offer
        pandas users an easy way to save a DataFrame into an
        Access database via ``to_sql``.
        
        Pre-requisites
        --------------
        
        - If you already have Microsoft Office (or standalone Microsoft Access) installed then install a version
          of Python with the same "bitness". For example, if you have 32-bit Office then you should install
          32-bit Python.
        
        - If you do not already have Microsoft Office (or standalone Microsoft Access) installed then install
          the version of the Microsoft Access Database Engine Redistributable with the same "bitness" as the
          version of Python you will be using. For example, if you will be running 64-bit Python then you
          should install the 64-bit version of the Access Database Engine.
        
        Special case: If you will be running 32-bit Python and you will **only** be working with .mdb files
        then you can use the older 32-bit ``Microsoft Access Driver (*.mdb)`` that ships with Windows.
        
        Co-requisites
        -------------
        
        This dialect requires SQLAlchemy and pyodbc. They are both specified as requirements so ``pip`` will install
        them if they are not already in place. To install, just::
        
            pip install sqlalchemy-access
        
        Getting Started
        ---------------
        
        Create an `ODBC DSN (Data Source Name)`_ that points to your Access database.
        (Tip: For best results, enable `ExtendedAnsiSQL`_.)
        Then, in your Python app, you can connect to the database via::
        
            from sqlalchemy import create_engine
            engine = create_engine("access+pyodbc://@your_dsn")
        
        For other ways of connecting see the `Getting Connected`_ page in the Wiki.
        
        .. _ODBC DSN (Data Source Name): https://support.microsoft.com/en-ca/help/966849/what-is-a-dsn-data-source-name
        .. _ExtendedAnsiSQL: https://github.com/sqlalchemy/sqlalchemy-access/wiki/%5Btip%5D-use-ExtendedAnsiSQL
        .. _Getting Connected: https://github.com/sqlalchemy/sqlalchemy-access/wiki/Getting-Connected
        
        The SQLAlchemy Project
        ======================
        
        SQLAlchemy-access is part of the `SQLAlchemy Project <https://www.sqlalchemy.org>`_ and
        adheres to the same standards and conventions as the core project.
        
        Development / Bug reporting / Pull requests
        -------------------------------------------
        
        Please refer to the
        `SQLAlchemy Community Guide <https://www.sqlalchemy.org/develop.html>`_ for
        guidelines on coding and participating in this project.
        
        Code of Conduct
        _______________
        
        Above all, SQLAlchemy places great emphasis on polite, thoughtful, and
        constructive communication between users and developers.
        Please see our current Code of Conduct at
        `Code of Conduct <https://www.sqlalchemy.org/codeofconduct.html>`_.
        
        License
        =======
        
        SQLAlchemy-access is distributed under the `MIT license
        <https://opensource.org/licenses/MIT>`_.
        
Keywords: SQLAlchemy Microsoft Access
Platform: UNKNOWN
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Database :: Front-Ends
Classifier: Operating System :: OS Independent
