namespace ezFunctions.php file global functions, update database files and tests

- this is a breaking change requiring major version change

Author: TheTechsTech

README.md

@@ -2,14 +2,29 @@
 
 [![Windows](https://github.com/ezSQL/ezsql/workflows/Windows/badge.svg?branch=v5)](https://github.com/ezSQL/ezsql/actions?query=workflow%3AWindows)
 [![Linux](https://github.com/ezSQL/ezsql/workflows/Linux/badge.svg?branch=v5)](https://github.com/ezSQL/ezsql/actions?query=workflow%3ALinux)
-[![codecov](https://codecov.io/gh/ezSQL/ezSQL/branch/master/graph/badge.svg)](https://codecov.io/gh/ezSQL/ezSQL)
+[![macOS](https://github.com/ezSQL/ezsql/workflows/macOS/badge.svg?branch=v5)](https://github.com/ezSQL/ezsql/actions?query=workflow%3AmacOS)
+[![codecov](https://codecov.io/gh/ezSQL/ezSQL/branch/v5/graph/badge.svg)](https://codecov.io/gh/ezSQL/ezSQL)
 [![Codacy Badge](https://api.codacy.com/project/badge/Grade/aad1f6aaaaa14f60933e75615da900b8)](https://www.codacy.com/app/techno-express/ezsql?utm_source=github.com&utm_medium=referral&utm_content=ezSQL/ezsql&utm_campaign=Badge_Grade)
 [![Maintainability](https://api.codeclimate.com/v1/badges/6f6107f25e9de7bf4272/maintainability)](https://codeclimate.com/github/ezSQL/ezsql/maintainability)
-[![Total Downloads](https://poser.pugx.org/jv2222/ezsql/downloads)](https://packagist.org/packages/jv2222/ezsql)
+[![Total Downloads](https://poser.pugx.org/ezsql/ezsql/downloads)](https://packagist.org/packages/ezsql/ezsql)
 
 ***A class to make it very easy to deal with database connections.***
 
-This is [__version 4__](https://github.com/ezSQL/ezsql/tree/v4) that has many modern programming practices in which will break users of version 3.
+This is a [WIP] of [__version 5__](https://github.com/ezSQL/ezsql/tree/v5) which will break users of **version 4**, mainly by the use of `namespace` in the `global` functions **ezFunctions.php** file.
+
+Usage of the **global** functions will require the user to begin a `.php` file something like:
+
+```php
+use function ezsql\functions\where;
+// Or
+use function ezsql\functions\{
+    getInstance,
+    select,
+    insert,
+};
+```
+
+[__version 4__](https://github.com/ezSQL/ezsql/tree/v4) has many modern programming practices in which will break users of version 3.
 
 [__Version 3__](https://github.com/ezSQL/ezsql/tree/v3) broke version 2.1.7 in one major way, it required *PHP 5.6*. Which drop mysql extension support, other than that, nothing as far using the library was changed, only additional features.
 

lib/ConfigAbstract.php

@@ -25,6 +25,34 @@
 
 /**
  * @method set/get{property} - a property that needs to be accessed
+ *
+ * @method void setDriver($args);
+ * @method void setDsn($args);
+ * @method void setUser($args);
+ * @method void setPassword($args);
+ * @method void setName($args);
+ * @method void setHost($args);
+ * @method void setPort($args);
+ * @method void setCharset($args);
+ * @method void setOptions($args);
+ * @method void setIsFile($args);
+ * @method void setToMssql($args);
+ * @method void setToMysql($args);
+ * @method void setPath($args);
+ *
+ * @method string getDriver();
+ * @method string getDsn();
+ * @method string getUser();
+ * @method string getPassword()
+ * @method string getName();
+ * @method string getHost();
+ * @method string getPort();
+ * @method string getCharset();
+ * @method string getOptions();
+ * @method string getToMysql();
+ * @method bool getIsFile();
+ * @method bool getToMssql();getToMssql
+ * @method string getPath();
  */
 abstract class ConfigAbstract
 {

lib/ConfigInterface.php

@@ -13,6 +13,7 @@
  * @method void setCharset($args);
  * @method void setOptions($args);
  * @method void setIsFile($args);
+ * @method void setToMssql($args);
  * @method void setToMysql($args);
  * @method void setPath($args);
  *
@@ -27,6 +28,7 @@
  * @method string getOptions();
  * @method bool getIsFile();
  * @method bool getToMysql();
+ * @method bool getToMssql();
  * @method string getPath();
  */
 interface ConfigInterface

lib/Constants.php

@@ -5,7 +5,7 @@
     /**
      * ezsqlModel Constants
      */
-    \defined('EZSQL_VERSION') or \define('EZSQL_VERSION', '4.0.12');
+    \defined('EZSQL_VERSION') or \define('EZSQL_VERSION', '5.0.0');
     \defined('OBJECT') or \define('OBJECT', 'OBJECT');
     \defined('ARRAY_A') or \define('ARRAY_A', 'ARRAY_A');
     \defined('ARRAY_N') or \define('ARRAY_N', 'ARRAY_N');

lib/Database.php

@@ -5,6 +5,7 @@
 namespace ezsql;
 
 use ezsql\DInjector;
+use function ezsql\functions\setInstance;
 
 class Database
 {
@@ -38,7 +39,7 @@ public function __wakeup()
     public static function initialize(?string $vendor = null, ?array $setting = null, ?string $tag = null)
     {
         if (isset(self::$instances[$vendor]) && empty($setting) && empty($tag))
-            return \setInstance(self::$instances[$vendor]) ? self::$instances[$vendor] : false;
+            return setInstance(self::$instances[$vendor]) ? self::$instances[$vendor] : false;
 
         if (empty($vendor) || empty($setting)) {
             throw new \Exception(\MISSING_CONFIGURATION);
@@ -58,7 +59,7 @@ public static function initialize(?string $vendor = null, ?array $setting = null
                 }
             }
 
-            \setInstance($GLOBALS['ez' . $key]);
+            setInstance($GLOBALS['ez' . $key]);
             return $GLOBALS['ez' . $key];
         }
     }

lib/Database/ez_mysqli.php

@@ -8,6 +8,7 @@
 use ezsql\ezsqlModel;
 use ezsql\ConfigInterface;
 use ezsql\DatabaseInterface;
+use function ezsql\functions\setInstance;
 
 class ez_mysqli extends ezsqlModel implements DatabaseInterface
 {
@@ -45,7 +46,7 @@ public function __construct(ConfigInterface $settings = null)
 
         if (empty($GLOBALS['ez' . \MYSQLI]))
             $GLOBALS['ez' . \MYSQLI] = $this;
-        \setInstance($this);
+        setInstance($this);
     } // __construct
 
     public function settings()

lib/Database/ez_pdo.php

@@ -9,6 +9,7 @@
 use ezsql\ezsqlModel;
 use ezsql\ConfigInterface;
 use ezsql\DatabaseInterface;
+use function ezsql\functions\setInstance;
 
 class ez_pdo extends ezsqlModel implements DatabaseInterface
 {
@@ -49,7 +50,7 @@ public function __construct(ConfigInterface $settings = null)
 
         if (empty($GLOBALS['ez' . \Pdo]))
             $GLOBALS['ez' . \Pdo] = $this;
-        \setInstance($this);
+        setInstance($this);
     } // __construct
 
     public function settings()

lib/Database/ez_pgsql.php

@@ -8,6 +8,7 @@
 use ezsql\ezsqlModel;
 use ezsql\ConfigInterface;
 use ezsql\DatabaseInterface;
+use function ezsql\functions\setInstance;
 
 class ez_pgsql extends ezsqlModel implements DatabaseInterface
 {
@@ -45,7 +46,7 @@ public function __construct(ConfigInterface $settings = null)
 
         if (empty($GLOBALS['ez' . \PGSQL]))
             $GLOBALS['ez' . \PGSQL] = $this;
-        \setInstance($this);
+        setInstance($this);
     } // __construct
 
     public function settings()

lib/Database/ez_sqlite3.php

@@ -8,6 +8,7 @@
 use ezsql\ezsqlModel;
 use ezsql\ConfigInterface;
 use ezsql\DatabaseInterface;
+use function ezsql\functions\setInstance;
 
 class ez_sqlite3 extends ezsqlModel implements DatabaseInterface
 {
@@ -52,7 +53,7 @@ public function __construct(ConfigInterface $settings = null)
 
         if (!isset($GLOBALS['ez' . \SQLITE3]))
             $GLOBALS['ez' . \SQLITE3] = $this;
-        \setInstance($this);
+        setInstance($this);
     }
 
     public function settings()

lib/Database/ez_sqlsrv.php

@@ -8,6 +8,7 @@
 use ezsql\ezsqlModel;
 use ezsql\ConfigInterface;
 use ezsql\DatabaseInterface;
+use function ezsql\functions\setInstance;
 
 class ez_sqlsrv extends ezsqlModel implements DatabaseInterface
 {
@@ -54,7 +55,7 @@ public function __construct(ConfigInterface $settings = null)
 
         if (empty($GLOBALS['ez' . \SQLSRV]))
             $GLOBALS['ez' . \SQLSRV] = $this;
-        \setInstance($this);
+        setInstance($this);
     }
 
     public function settings()