New create_db method, drop method fixes

Author: 1TGDev

LICENSE

@@ -1,7 +1,4 @@
-MIT License
-
-Additional Functionality
- - Copyright (c) 2022 <[email protected]> (itariq.dev) TARIQ
+Copyright (c) 2023 <[email protected]> TARIQ (itariq.dev)
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
@@ -10,13 +7,13 @@ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 copies of the Software, and to permit persons to whom the Software is
 furnished to do so, subject to the following conditions:
 
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
 
 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -36,7 +36,7 @@
 ## Installation
 
 ``
-npm i mysql-database
+npm i mysql-database@latest
 ``
 
 ## Documentation
@@ -223,11 +223,36 @@ await db.ping();
 await db.process();
 // -> returns the processes/connections list
 ```
+- create_db (database_name)
+```js
+await db.create_db("second_db");
+// -> creates a separate database on the server
+
+// -> you need to create a new connection manually after creating a new database
+const secondDB = new MySQL();
+let newDb = await secondDB.connect({
+	host: 'localhost',
+	port: '3306',
+	user: 'root',
+	password: '',
+	database: 'second_db',
+	charset: 'utf8mb4',
+});
+// note: if you had an old events, you need to re-register the events since this is a new class created
+newDb.on('connected', async connection => {
+	console.log('New Database Connected');
+});
+
+// now you can manage your "newDb" connection
+await newDb.set("second_db_table", "key", "value");
+await newDb.drop("second_db_table");
+await newDb.end();
+```
 - end ()
 ```js
 await db.end();
 // -> closes the connection
 ```
 
 #### Contributing
-© mysql-database, 2021 - 2022 | <a href="https://itariq.dev" target="_blank">TARIQ</a> <a href="mailto:[email protected]">([email protected])</a>
+© mysql-database, 2021 - 2023 | <a href="https://itariq.dev" target="_blank">TARIQ</a> <a href="mailto:[email protected]">([email protected])</a>

examples/example.js

@@ -1,9 +1,9 @@
-const MySQL = require('../index.js');
-const database = new MySQL();
+const MySQL = require('../index.js'); // importing the package
 
 run();
 async function run(){
-	let db = await database.connect({ // creates a database connection
+	const database = new MySQL(); // creates a database class
+	let db = await database.connect({ // creates a connection for the database
 		host: 'localhost',
 		port: '3306', // the default port is 3306
 		user: 'root',
@@ -186,8 +186,7 @@ async function run(){
 	let ping = await db.ping(); // gets database ping (in ms)
 	console.log(ping); // 27
 
-	// clear all table data
-	await db.clear("new_table");
+	await db.clear("new_table"); // clear all table data
 
 	// lastly delete the table
 	await db.drop("new_table"); // drops/deletes the table
@@ -272,5 +271,31 @@ async function run(){
 	]
 	*/
 
+	await db.create_db("second_db"); // creates a separate database on the server
+	
+	// you need to create a new connection manually after creating a new database
+	const secondDB = new MySQL();
+	let newDb = await secondDB.connect({
+		host: 'localhost',
+		port: '3306',
+		user: 'root',
+		password: '',
+		database: 'second_db',
+		charset: 'utf8mb4',
+	});
+	// note: if you had an old events, you need to re-register the events since this is a new class created
+	newDb.on('connected', async connection => { // database connected event
+		console.log('New Database Connected');
+	});
+	
+	// now you can manage your "newDb" connection
+	await newDb.set("second_db_table", "key", "value");
+	await newDb.drop("second_db_table");
+	
+	// you can still manage your old "db" connection as well
+	await db.set("old_db_table", "key", "value");
+	await db.drop("old_db_table");
+	
 	await db.end(); // closes the connection
+	await newDb.end();
 }

package.json

@@ -1,6 +1,6 @@
 {
   "name": "mysql-database",
-  "version": "1.3.1",
+  "version": "1.3.2",
   "description": "Easily modify your MySQL database data with easy functions",
   "main": "index.js",
   "scripts": {

structures/classes/MySQL.js

@@ -33,4 +33,5 @@ module.exports = class MySQL extends EventEmitter{
 	base_get = require('../methods/base_get');
 	end = require('../methods/end');
 	exists = require('../methods/exists');
+	create_db = require('../methods/create_db');
 }

structures/errors/strings.js

@@ -5,6 +5,7 @@ module.exports = {
 	"number": "Number was not specified in function arguments or not number, received {received}",
 	"numberType": "Number argument must be an positive integer, received {received}",
 	"query": "SQL Query was not specified in function arguments or not string, received {received}",
+	"databaseName": "Database name was not specified in function arguments or not string, received {received}",
 
 	"array": "{key} key's value is not an array",
 	"notNumber": "{key} key's value is not a number",

structures/methods/create_db.js

@@ -0,0 +1,10 @@
+"use strict";
+
+const errors = require('../errors/strings.js');
+
+module.exports = async function(dbName){
+	if(!dbName || typeof dbName !== "string") throw new TypeError(errors.databaseName.replace("{received}", typeof table));
+	
+	await this.db.query(`CREATE DATABASE IF NOT EXISTS \`${dbName}\``);
+	return true;
+}

structures/methods/drop.js

@@ -7,7 +7,7 @@ module.exports = async function(table, isClear){
 
 	let tables = await this.tables();
 	if(!tables.includes(table)) return false;
-	this.db.query(`DROP TABLE \`${table}\``);
+	await this.db.query(`DROP TABLE \`${table}\``);
 	if(tables.includes(table) && !isClear) this.emit("tableDelete", table);
 	return true;
 }