Metadata-Version: 2.1
Name: pymssql-utils
Version: 0.0.1
Summary: A lightweight module that wraps and extends the PyMSSQL library.
Home-page: https://github.com/invokermain/pymssql-utils
Author: Tim OSullivan
Author-email: timothyj725@googlemail.com
License: MIT
Description: # pymssql-utils
        A lightweight module that wraps and extends the [pymssql](https://github.com/pymssql/pymssql) library.
        
        The aim of this module is to make it easier to use _pymssql_ by:
         * Reducing the amount of boilerplate code needed.
         * Returning a helpful `DatabaseResult` class for each execution.
         * Being fully type hinted.  
         * Parsing various SQL Types to native Python types that Python misses.
         * Making it easier to serialise your data.
         * Providing various utility functions for building dynamic SQL queries or logging query output.
         * Fixing various edge case bugs that arise when using _pymssql_.
        
        The trade-off with "baking in" various patterns (primarily opening a new connection on every execution)
        is that this module is opinionated as to what best practice is,
        and might not be suitable for all use cases. If this module doesn't make your life easier
        please raise critiques or suggestions via Github.
        
        This module was created naturally over the course of a few years of using _pymssql_ in various projects.
        
        ## Installation
        
        This module can be installed via pip: `pip install pymssql-utils`.
        This module requires Python >= 3.6
        
        ## Quick Start  (TODO)
        
        Running a simple query:
        
        ```
        import os
        
        import pymssqlutils as sql
        
        os.environ["DB_NAME"] = "MASTER"
        ```
        ## Notes
        
        ### Why pymssql when and Microsoft officially recommends pyodbc?
        
        Simply, ODBC drivers add an extra layer between Python and SQL Server
        which introduce a whole host of obscure issues that I believe outway the current benefits of pyodbc.
        These drivers are badly supported on linux distributions, and if you develop in containers often I believe
        using pymssql will work out of the box across many more distributions seamlessly.
Platform: UNKNOWN
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
