PyAwaish 1.0__tar.gz

pyawaish-1.0/CHANGELOG.txt

@@ -0,0 +1,15 @@
+CHANGELOG
+=========
+
+Version 1.0 (2025-01-27)
+---------------------------
+
+- Initial release of PyAwaish.
+- Added dynamic MySQL configuration through a web interface.
+- Implemented template rendering for `config_mysql.html` and `home.html`.
+- Developed `/execute_query` endpoint for executing MySQL queries.
+- Supported CRUD operations: insert, delete, update, fetch_data.
+- Enabled secure database connection using environment variables.
+- Provided RESTFul API design for interaction with MySQL.
+- Fixed the code markdown in readme.rst file
+- Added warning messages

pyawaish-1.0/LICENSE.txt

@@ -0,0 +1,6 @@
+Copyright 2025 Abu Awaish
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights 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.
+

pyawaish-1.0/MANIFEST.in

@@ -0,0 +1,22 @@
+# Include important project metadata and configuration files
+include README.rst
+include LICENSE.txt       # Explicitly mention the extension
+include setup.py
+include pyproject.toml
+include requirements.txt
+include CHANGELOG.txt
+
+# Include all files in the templates directory (and subdirectories)
+recursive-include PyAwaish/templates *
+
+# Include all Python source files in the package
+recursive-include PyAwaish *.py
+
+# Exclude compiled Python files and cache directories
+global-exclude *.pyc
+global-exclude __pycache__/
+
+# Exclude log and temporary files
+global-exclude *.log
+global-exclude *.tmp
+global-exclude .idea/

pyawaish-1.0/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.2
+Name: PyAwaish
+Version: 1.0
+Summary: A Python package for building dynamic MySQL-powered web applications with template support
+Home-page: https://github.com/abuawaish/Crud_app
+Author: Abu Awaish
+Author-email: abuawaish7@gmail.com
+License: MIT
+Keywords: web application flask mysql dynamic templates
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+Requires-Dist: Flask
+Requires-Dist: Flask-MySQLdb
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+PyAwaish
+===========
+
+**PyAwaish** is a Flask-based Python framework that simplifies the development of MySQL-powered web applications. It provides a streamlined interface for connecting to a MySQL database, rendering templates, and executing queries dynamically via RESTful APIs.
+
+Features
+--------
+- **Dynamic MySQL Configuration**: Configure MySQL database settings at runtime via a web interface.
+- **Template Rendering**: Built-in support for rendering templates stored in the `templates` folder.
+- **Query Execution API**: Execute MySQL queries dynamically through POST requests.
+- **CRUD Operations**: Perform create, read, update, and delete operations programmatically.
+- **RESTful Design**: Leverage Flask to expose endpoints for database interactions.
+- **Environment Configuration**: Load sensitive credentials securely using environment variables.
+
+Badges
+------
+
+.. image:: https://badge.fury.io/py/PyAwaish.svg
+    :target: https://pypi.org/project/PyAwaish/
+
+.. image:: https://img.shields.io/badge/License-MIT-yellow.svg
+    :target: https://opensource.org/licenses/MIT
+
+
+Endpoints
+---------
+1. **`/`**: Displays the MySQL configuration page.
+2. **`/home`**: Displays the home page.
+3. **`/config_mysql`**: Accepts a POST request to configure MySQL connection details dynamically.
+4. **`/execute_query`**: Accepts a POST request to execute MySQL queries or perform operations (e.g., insert, delete, update).
+
+Installation
+------------
+1. Clone the repository:
+
+   .. code-block:: bash
+
+       git clone https://github.com/abuawaish/CRUD_App.git
+       cd CRUD_App
+
+2. Install the required dependencies:
+
+   .. code-block:: bash
+
+       pip install -r requirements.txt
+
+3. Install the package:
+
+   .. code-block:: bash
+
+       pip install PyAwaish
+
+4. Set environment variables for database configuration:
+
+   .. code-block:: bash
+
+       export MYSQL_HOST=localhost
+       export MYSQL_USER=root
+       export MYSQL_PASSWORD=your password
+       export MYSQL_DB=mydatabase
+       export SECRET_KEY=your_secret_key
+
+
+Usage
+-----
+
+**Running the Application**
+
+To start the MysqlWebApp server, instantiate the `MysqlApplication` class and call its `execute` method. For example:
+
+.. code-block:: python
+
+    from PyAwaish.MysqlApplication import MysqlApplication
+
+    if __name__ == "__main__":
+        app = MysqlApplication()
+        app.execute()
+
+**This will:**
+
+- Start a Flask server on `http://0.0.0.0:5001`.
+- Serve endpoints for configuring and interacting with the MySQL database.
+
+
+**Configuring MySQL**
+
+1. Navigate to the root endpoint (`http://localhost:5001/`) to access the configuration page.
+2. Enter the database details (host, username, password, database name) and click "Save".
+3. Upon successful configuration, you will be redirected to the home page.
+
+**Executing Queries**
+
+Use the `/execute_query` endpoint to run SQL queries or perform operations. Example request:
+
+- **POST Request Example**:
+
+  .. code-block:: json
+
+      {
+          "operation": "insert",
+          "table_name": "users",
+          "columns": "name, email",
+          "values": "'John Doe', 'john@example.com'"
+      }
+
+- **Supported Operations**:
+  - `insert`: Insert data into a table.
+  - `delete`: Delete data from a table with a condition.
+  - `update`: Update data in a table with a condition.
+  - `fetch_data`: Fetch all data from a table.
+  - `show_tables`: List all tables in the database.
+
+Dependencies
+------------
+The application requires the following dependencies (listed in `requirements.txt`):
+
+- Flask: Web framework.
+- Flask-MySQLdb: MySQL connector for Flask.
+
+To install them, run:
+
+.. code-block:: bash
+
+    pip install -r requirements.txt
+
+Environment Variables
+---------------------
+- **MYSQL_HOST**: MySQL server hostname (default: `localhost`).
+- **MYSQL_USER**: MySQL username (default: `root`).
+- **MYSQL_PASSWORD**: MySQL password.
+- **MYSQL_DB**: Default MySQL database name.
+- **SECRET_KEY**: Flask secret key for session security.
+
+Changelog
+---------
+Refer to `CHANGELOG.txt` for the complete version history of the project.
+
+License
+-------
+This project is licensed under the MIT License. See `LICENSE.txt` for full details.
+
+Contact
+-------
+For questions or feedback, contact:
+
+- Email: abuawaish7@gmail.com
+- GitHub: https://github.com/abuawaish/CRUD_App
+
+
+CHANGELOG
+=========
+
+Version 1.0 (2025-01-27)
+---------------------------
+
+- Initial release of PyAwaish.
+- Added dynamic MySQL configuration through a web interface.
+- Implemented template rendering for `config_mysql.html` and `home.html`.
+- Developed `/execute_query` endpoint for executing MySQL queries.
+- Supported CRUD operations: insert, delete, update, fetch_data.
+- Enabled secure database connection using environment variables.
+- Provided RESTFul API design for interaction with MySQL.
+- Fixed the code markdown in readme.rst file
+- Added warning messages

pyawaish-1.0/PyAwaish/MysqlApplication.py

@@ -0,0 +1,164 @@
+import os
+from flask import Flask, render_template, request, redirect, url_for, flash, jsonify
+from flask_mysqldb import MySQL
+
+
+class MysqlApplication:
+    def __init__(self):
+        # Initialize Flask app
+        self.__app = Flask(__name__, template_folder=os.path.join(os.path.dirname(__file__), "templates"))
+        self.__database_name = ""
+
+        # Securely load database configuration
+        self.__app.config['MYSQL_HOST'] = os.getenv('MYSQL_HOST', 'localhost')
+        self.__app.config['MYSQL_USER'] = os.getenv('MYSQL_USER', 'root')
+        self.__app.config['MYSQL_PASSWORD'] = os.getenv('MYSQL_PASSWORD', '')
+        self.__app.config['MYSQL_DB'] = os.getenv('MYSQL_DB', '')
+        self.__app.secret_key = os.getenv('SECRET_KEY', 'your_secret_key_here')
+        if not os.getenv('SECRET_KEY'):
+            print("Warning: Please ensure that you are using a local machine before running the application!")
+            print("Warning: Please ensure that MySQL is installed on your local system before running the application!")
+            print("Warning: Using a hardcoded secret key. Set SECRET_KEY as an environment variable for production!")
+
+        # Initialize MySQL
+        self.__mysql = MySQL(self.__app)
+
+        # Define routes
+        self.__add_config_routes()
+        self.__add_home_routes()
+        self.__add_config_mysql()
+        self.__add_execute_query()
+
+    def __add_config_routes(self):
+        @self.__app.route('/')
+        def config_mysql_page():
+            return render_template('config_mysql.html')
+
+    def __add_home_routes(self):
+        @self.__app.route('/home')
+        def home():
+            return render_template('home.html')
+
+    def __add_config_mysql(self):
+        @self.__app.route('/config_mysql', methods=['POST'])
+        def config_mysql():
+            host = request.form['host']
+            username = request.form['username']
+            password = request.form['password']
+            database = request.form['database']
+
+            # Update app configuration dynamically
+            self.__app.config['MYSQL_HOST'] = host
+            self.__app.config['MYSQL_USER'] = username
+            self.__app.config['MYSQL_PASSWORD'] = password
+            self.__app.config['MYSQL_DB'] = database
+            self.__database_name = database
+
+            try:
+                # Test the connection
+                cursor = self.__mysql.connection.cursor()
+                cursor.execute('SELECT 1')
+                cursor.close()
+                flash('Connection established successfully!', 'success')
+                return redirect(url_for('home'))
+            except Exception as e:
+                flash(f'Error connecting to MySQL: {e}', 'danger')
+                return redirect(url_for('config_mysql_page'))
+
+    def __add_execute_query(self):
+        @self.__app.route('/execute_query', methods=['POST'])
+        def execute_query():
+            try:
+                data = request.get_json()
+                operation = data.get('operation')
+                query = data.get('query')
+                result = {}
+
+                cursor = self.__mysql.connection.cursor()
+
+                if query:
+                    query_type = query.strip().split(' ', 1)[0].lower()
+
+                    if query_type in ['select', 'show', 'call']:
+                        cursor.execute(query)
+                        rows = cursor.fetchall()
+                        column_names = [desc[0] for desc in cursor.description or []]
+                        result["data"] = {f"row_{index + 1}": dict(zip(column_names, row)) for index, row in enumerate(rows)}
+
+                    elif query_type == 'use':
+                        try:
+                            cursor.execute(query)
+                            db_to_use = query.strip().split(" ")[1].removesuffix(';')
+                            if db_to_use == self.__database_name:
+                                result["message"] = "You are already using this database."
+                            else:
+                                result["message"] = "Cannot switch databases dynamically. Please reconfigure."
+                        except Exception as e:
+                            return jsonify({'error': f'{e}'})
+                    else:
+                        cursor.execute(query)
+                        self.__mysql.connection.commit()
+                        result["message"] = f"{query_type.capitalize()} query executed successfully."
+
+                elif operation:
+                    if operation == "insert":
+                        table_name = data.get('table_name')
+                        columns = data.get('columns')
+                        values = data.get('values')
+                        if not table_name or not columns or not values:
+                            return jsonify({"error": "Table name, columns, and values are required for insert"}), 400
+                        query = f"INSERT INTO {table_name} ({columns}) VALUES ({values})"
+                        cursor.execute(query)
+                        self.__mysql.connection.commit()
+                        result["message"] = f"Data inserted successfully into table '{table_name}'"
+
+                    elif operation == "delete":
+                        table_name = data.get('table_name')
+                        condition = data.get('condition')
+                        if not table_name or not condition:
+                            return jsonify({"error": "Table name and condition are required for delete"}), 400
+                        query = f"DELETE FROM {table_name} WHERE {condition}"
+                        cursor.execute(query)
+                        self.__mysql.connection.commit()
+                        result["message"] = f"Data deleted successfully from table '{table_name}'"
+
+                    elif operation == "update":
+                        table_name = data.get('table_name')
+                        field = data.get('field')
+                        condition = data.get('condition')
+                        if not table_name or not field or not condition:
+                            return jsonify({"error": "Table name, field, and condition are required for update"}), 400
+                        query = f"UPDATE {table_name} SET {field} WHERE {condition}"
+                        cursor.execute(query)
+                        self.__mysql.connection.commit()
+                        result["message"] = f"Data updated successfully in table '{table_name}'"
+
+                    elif operation == "fetch_data":
+                        table_name = data.get('table_name')
+                        if not table_name:
+                            return jsonify({"error": "Table name is required for fetch"}), 400
+                        query = f'SELECT * FROM {table_name}'
+                        cursor.execute(query)
+                        rows = cursor.fetchall()
+                        column_names = [desc[0] for desc in cursor.description or []]
+                        result["data"] = {f"row_{index + 1}": dict(zip(column_names, row)) for index, row in enumerate(rows)}
+
+                    elif operation == "show_tables":
+                        cursor.execute("SHOW TABLES;")
+                        tables = cursor.fetchall()
+                        result["tables"] = {f"table_{index + 1}": table[0] for index, table in enumerate(tables)}
+                    else:
+                        return jsonify({"error": "Invalid operation"}), 400
+
+                else:
+                    return jsonify({"error": "Invalid request"}), 400
+
+                cursor.close()
+
+                return jsonify(result)
+
+            except Exception as e:
+                return jsonify({'error': str(e)}), 500
+
+    def execute(self):
+        self.__app.run(debug=True, port=5001, host="0.0.0.0")

pyawaish-1.0/PyAwaish/__init__.py

@@ -0,0 +1,2 @@
+from .MysqlApplication import MysqlApplication
+__all__ = ["MysqlApplication"]

pyawaish-1.0/PyAwaish/templates/config_mysql.html

@@ -0,0 +1,68 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>MySQL Configuration</title>
+    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
+</head>
+<body>
+    <div class="container mt-5">
+        <div class="card shadow-lg rounded">
+            <div class="card-header text-center">
+                <h2>MySQL Configuration</h2>
+            </div>
+            <div class="card-body">
+                <form action="/config_mysql" method="POST">
+                    <div class="mb-3">
+                        <label for="host" class="form-label">Host Name</label>
+                        <input type="text" class="form-control" id="host" name="host" placeholder="Enter Host Name" required>
+                    </div>
+                    <div class="mb-3">
+                        <label for="username" class="form-label">User Name</label>
+                        <input type="text" class="form-control" id="username" name="username" placeholder="Enter User Name" required>
+                    </div>
+                    <div class="mb-3 position-relative">
+                        <label for="password" class="form-label">Password</label>
+                        <div class="input-group">
+                            <input type="password" class="form-control" id="password" name="password" placeholder="Enter Password">
+                            <button type="button" class="btn btn-outline-secondary" id="togglePassword">
+                                <i class="bi bi-eye" id="eyeIcon"></i>
+                            </button>
+                        </div>
+                    </div>
+                    <div class="mb-3">
+                        <label for="database" class="form-label">Database Name</label>
+                        <input type="text" class="form-control" id="database" name="database" placeholder="Enter Database Name" required>
+                    </div>
+                    <button type="submit" class="btn btn-primary">Configure</button>
+                </form>
+                {% with messages = get_flashed_messages() %}
+                {% if messages %}
+                <div class="alert alert-info mt-3" role="alert">
+                    {{ messages[0] }}
+                </div>
+                {% endif %}
+                {% endwith %}
+            </div>
+        </div>
+    </div>
+    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
+    <script>
+        const togglePassword = document.querySelector('#togglePassword');
+        const passwordField = document.querySelector('#password');
+        const eyeIcon = document.querySelector('#eyeIcon');
+
+        togglePassword.addEventListener('click', () => {
+            // Toggle the type attribute
+            const type = passwordField.getAttribute('type') === 'password' ? 'text' : 'password';
+            passwordField.setAttribute('type', type);
+
+            // Toggle the eye icon class
+            eyeIcon.classList.toggle('bi-eye');
+            eyeIcon.classList.toggle('bi-eye-slash');
+        });
+    </script>
+    <link href="https://cdnjs.cloudflare.com/ajax/libs/bootstrap-icons/1.10.5/font/bootstrap-icons.min.css" rel="stylesheet">
+</body>
+</html>

pyawaish-1.0/PyAwaish/templates/home.html

@@ -0,0 +1,298 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>CRUD Operations</title>
+    <style>
+        body {
+            font-family: 'Segoe UI', Tahoma, Geneva, Verdana, sans-serif;
+            margin: 0;
+            padding: 0;
+            background-color: #f3f4f6;
+            color: #333;
+        }
+
+        header {
+            background-color: #4CAF50;
+            color: white;
+            padding: 20px;
+            text-align: center;
+            font-size: 1.5em;
+        }
+
+        main {
+            max-width: 800px;
+            margin: 20px auto;
+            background: white;
+            padding: 20px;
+            border-radius: 10px;
+            box-shadow: 0 4px 8px rgba(0, 0, 0, 0.1);
+        }
+
+        h1 {
+            text-align: center;
+            color: #333;
+        }
+
+        form {
+            display: flex;
+            flex-direction: column;
+        }
+
+        label {
+            margin: 10px 0 5px;
+            font-weight: bold;
+        }
+
+        input, select, textarea, button {
+            width: 100%;
+            padding: 10px;
+            margin-bottom: 15px;
+            border: 1px solid #ccc;
+            border-radius: 5px;
+            font-size: 1em;
+        }
+
+        input:focus, select:focus, textarea:focus, button:focus {
+            outline: none;
+            border-color: #4CAF50;
+            box-shadow: 0 0 5px rgba(76, 175, 80, 0.5);
+        }
+
+        button {
+            background-color: #4CAF50;
+            color: white;
+            border: none;
+            cursor: pointer;
+            font-size: 1em;
+            font-weight: bold;
+            transition: background-color 0.3s ease;
+        }
+
+        button:hover {
+            background-color: #45a049;
+        }
+
+        .hidden {
+            display: none;
+        }
+
+        .response-container {
+            background-color: #f9f9f9;
+            border: 1px solid #ddd;
+            padding: 20px;
+            border-radius: 5px;
+            margin-top: 20px;
+            max-height: 300px;
+            overflow-y: auto;
+            font-family: monospace;
+            white-space: pre-wrap;
+            word-wrap: break-word;
+        }
+
+        .form-section {
+            margin: 20px 0;
+            padding: 20px;
+            border: 1px solid #ddd;
+            border-radius: 5px;
+            background: #f9f9f9;
+        }
+
+        footer {
+            text-align: center;
+            margin-top: 40px;
+            padding: 20px;
+            background: #4CAF50;
+            color: white;
+            font-size: 0.9em;
+        }
+
+        footer a {
+            color: #ffeb3b;
+            text-decoration: none;
+        }
+
+        footer a:hover {
+            text-decoration: underline;
+        }
+    </style>
+</head>
+<body>
+    <header>
+        CRUD Operations Interface
+    </header>
+
+    <main>
+        <h1>Manage Your Data</h1>
+
+        <form id="crudForm">
+            <div class="form-section">
+                <label for="operationType">Select Operation:</label>
+                <select id="operationType">
+                    <option value="">-- Select --</option>
+                    <option value="fetch_data">Fetch</option>
+                    <option value="insert">Insert</option>
+                    <option value="delete">Delete</option>
+                    <option value="update">Update</option>
+                    <option value="show_tables">Show Tables</option>
+                    <option value="custom_query">Custom Query</option>
+                </select>
+            </div>
+
+            <!-- Fetch Data Section -->
+            <div id="fetchSection" class="form-section hidden">
+                <label for="fetchTable">Table Name:</label>
+                <input type="text" id="fetchTable" placeholder="Enter table name">
+            </div>
+
+            <!-- Insert Section -->
+            <div id="insertSection" class="form-section hidden">
+                <label for="insertTable">Table Name:</label>
+                <input type="text" id="insertTable" placeholder="Enter table name">
+
+                <label for="insertColumns">Columns:</label>
+                <input type="text" id="insertColumns" placeholder="e.g., id, name, email">
+
+                <label for="insertValues">Values:</label>
+                <input type="text" id="insertValues" placeholder="e.g., 1, 'John Doe', 'john@example.com'">
+            </div>
+
+            <!-- Delete Section -->
+            <div id="deleteSection" class="form-section hidden">
+                <label for="deleteTable">Table Name:</label>
+                <input type="text" id="deleteTable" placeholder="Enter table name">
+
+                <label for="deleteCondition">Condition:</label>
+                <input type="text" id="deleteCondition" placeholder="e.g., id=1">
+            </div>
+
+            <!-- Update Section -->
+            <div id="updateSection" class="form-section hidden">
+                <label for="updateTable">Table Name:</label>
+                <input type="text" id="updateTable" placeholder="Enter table name">
+
+                <label for="updateField">Field to Update:</label>
+                <input type="text" id="updateField" placeholder="e.g., name='New Name'">
+
+                <label for="updateCondition">Condition:</label>
+                <input type="text" id="updateCondition" placeholder="e.g., id=1">
+            </div>
+
+            <!-- Show Tables Section -->
+            <div id="showTablesSection" class="form-section hidden">
+                <p>No additional input required. Click "Execute" to show tables.</p>
+            </div>
+
+            <!-- Custom Query Section -->
+            <div id="customQuerySection" class="form-section hidden">
+                <label for="customQuery">SQL Query:</label>
+                <textarea id="customQuery" rows="5" placeholder="Enter your custom SQL query here..."></textarea>
+            </div>
+
+            <button type="submit">Execute</button>
+        </form>
+
+        <div id="responseContainer" class="response-container hidden"></div>
+    </main>
+
+    <footer>
+        &copy; 2025 CRUD Operations. Designed by abuawaish️. To visit my GitHub account <a href="https://github.com/abuawaish">Click here</a>
+    </footer>
+
+    <script>
+        const operationType = document.getElementById("operationType");
+        const form = document.getElementById("crudForm");
+        const responseContainer = document.getElementById("responseContainer");
+
+        const sections = {
+            fetch_data: document.getElementById("fetchSection"),
+            insert: document.getElementById("insertSection"),
+            delete: document.getElementById("deleteSection"),
+            update: document.getElementById("updateSection"),
+            show_tables: document.getElementById("showTablesSection"),
+            custom_query: document.getElementById("customQuerySection"),
+        };
+
+        operationType.addEventListener("change", () => {
+            Object.values(sections).forEach(section => section.classList.add("hidden"));
+            if (operationType.value && sections[operationType.value]) {
+                sections[operationType.value].classList.remove("hidden");
+            }
+        });
+
+        form.addEventListener("submit", async (event) => {
+            event.preventDefault();
+            const operation = operationType.value;
+
+            let payload = {};
+            if (operation === "fetch_data") {
+                const tableName = document.getElementById("fetchTable").value.trim();
+
+                if (!tableName) {
+                    alert("Table name is required for fetching data.");
+                    return;
+                }
+
+                payload = { operation, table_name: tableName };
+            } else if (operation === "insert") {
+                const tableName = document.getElementById("insertTable").value.trim();
+                const columns = document.getElementById("insertColumns").value.trim();
+                const values = document.getElementById("insertValues").value.trim();
+
+                if (!tableName || !columns || !values) {
+                    alert("All fields are required for insert.");
+                    return;
+                }
+
+                payload = { operation, table_name: tableName, columns, values };
+            } else if (operation === "delete") {
+                const tableName = document.getElementById("deleteTable").value.trim();
+                const condition = document.getElementById("deleteCondition").value.trim();
+
+                if (!tableName || !condition) {
+                    alert("Table name and condition are required for delete.");
+                    return;
+                }
+
+                payload = { operation, table_name: tableName, condition };
+            } else if (operation === "update") {
+                const tableName = document.getElementById("updateTable").value.trim();
+                const field = document.getElementById("updateField").value.trim();
+                const condition = document.getElementById("updateCondition").value.trim();
+
+                if (!tableName || !field || !condition) {
+                    alert("All fields are required for update.");
+                    return;
+                }
+
+                payload = { operation, table_name: tableName, field, condition };
+            } else if (operation === "show_tables") {
+                payload = { operation };
+            } else if (operation === "custom_query") {
+                const query = document.getElementById("customQuery").value.trim();
+                if (!query) {
+                    alert("Custom query is required.");
+                    return;
+                }
+                payload = { query };
+            }
+
+            try {
+                const response = await fetch('/execute_query', {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify(payload),
+                });
+
+                const result = await response.json();
+                responseContainer.textContent = JSON.stringify(result, null, 2);
+                responseContainer.classList.remove("hidden");
+            } catch (error) {
+                responseContainer.textContent = `Error: ${error.message}`;
+                responseContainer.classList.remove("hidden");
+            }
+        });
+    </script>
+</body>
+</html>

pyawaish-1.0/PyAwaish.egg-info/PKG-INFO

@@ -0,0 +1,193 @@
+Metadata-Version: 2.2
+Name: PyAwaish
+Version: 1.0
+Summary: A Python package for building dynamic MySQL-powered web applications with template support
+Home-page: https://github.com/abuawaish/Crud_app
+Author: Abu Awaish
+Author-email: abuawaish7@gmail.com
+License: MIT
+Keywords: web application flask mysql dynamic templates
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.6
+Description-Content-Type: text/x-rst
+License-File: LICENSE.txt
+Requires-Dist: Flask
+Requires-Dist: Flask-MySQLdb
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+PyAwaish
+===========
+
+**PyAwaish** is a Flask-based Python framework that simplifies the development of MySQL-powered web applications. It provides a streamlined interface for connecting to a MySQL database, rendering templates, and executing queries dynamically via RESTful APIs.
+
+Features
+--------
+- **Dynamic MySQL Configuration**: Configure MySQL database settings at runtime via a web interface.
+- **Template Rendering**: Built-in support for rendering templates stored in the `templates` folder.
+- **Query Execution API**: Execute MySQL queries dynamically through POST requests.
+- **CRUD Operations**: Perform create, read, update, and delete operations programmatically.
+- **RESTful Design**: Leverage Flask to expose endpoints for database interactions.
+- **Environment Configuration**: Load sensitive credentials securely using environment variables.
+
+Badges
+------
+
+.. image:: https://badge.fury.io/py/PyAwaish.svg
+    :target: https://pypi.org/project/PyAwaish/
+
+.. image:: https://img.shields.io/badge/License-MIT-yellow.svg
+    :target: https://opensource.org/licenses/MIT
+
+
+Endpoints
+---------
+1. **`/`**: Displays the MySQL configuration page.
+2. **`/home`**: Displays the home page.
+3. **`/config_mysql`**: Accepts a POST request to configure MySQL connection details dynamically.
+4. **`/execute_query`**: Accepts a POST request to execute MySQL queries or perform operations (e.g., insert, delete, update).
+
+Installation
+------------
+1. Clone the repository:
+
+   .. code-block:: bash
+
+       git clone https://github.com/abuawaish/CRUD_App.git
+       cd CRUD_App
+
+2. Install the required dependencies:
+
+   .. code-block:: bash
+
+       pip install -r requirements.txt
+
+3. Install the package:
+
+   .. code-block:: bash
+
+       pip install PyAwaish
+
+4. Set environment variables for database configuration:
+
+   .. code-block:: bash
+
+       export MYSQL_HOST=localhost
+       export MYSQL_USER=root
+       export MYSQL_PASSWORD=your password
+       export MYSQL_DB=mydatabase
+       export SECRET_KEY=your_secret_key
+
+
+Usage
+-----
+
+**Running the Application**
+
+To start the MysqlWebApp server, instantiate the `MysqlApplication` class and call its `execute` method. For example:
+
+.. code-block:: python
+
+    from PyAwaish.MysqlApplication import MysqlApplication
+
+    if __name__ == "__main__":
+        app = MysqlApplication()
+        app.execute()
+
+**This will:**
+
+- Start a Flask server on `http://0.0.0.0:5001`.
+- Serve endpoints for configuring and interacting with the MySQL database.
+
+
+**Configuring MySQL**
+
+1. Navigate to the root endpoint (`http://localhost:5001/`) to access the configuration page.
+2. Enter the database details (host, username, password, database name) and click "Save".
+3. Upon successful configuration, you will be redirected to the home page.
+
+**Executing Queries**
+
+Use the `/execute_query` endpoint to run SQL queries or perform operations. Example request:
+
+- **POST Request Example**:
+
+  .. code-block:: json
+
+      {
+          "operation": "insert",
+          "table_name": "users",
+          "columns": "name, email",
+          "values": "'John Doe', 'john@example.com'"
+      }
+
+- **Supported Operations**:
+  - `insert`: Insert data into a table.
+  - `delete`: Delete data from a table with a condition.
+  - `update`: Update data in a table with a condition.
+  - `fetch_data`: Fetch all data from a table.
+  - `show_tables`: List all tables in the database.
+
+Dependencies
+------------
+The application requires the following dependencies (listed in `requirements.txt`):
+
+- Flask: Web framework.
+- Flask-MySQLdb: MySQL connector for Flask.
+
+To install them, run:
+
+.. code-block:: bash
+
+    pip install -r requirements.txt
+
+Environment Variables
+---------------------
+- **MYSQL_HOST**: MySQL server hostname (default: `localhost`).
+- **MYSQL_USER**: MySQL username (default: `root`).
+- **MYSQL_PASSWORD**: MySQL password.
+- **MYSQL_DB**: Default MySQL database name.
+- **SECRET_KEY**: Flask secret key for session security.
+
+Changelog
+---------
+Refer to `CHANGELOG.txt` for the complete version history of the project.
+
+License
+-------
+This project is licensed under the MIT License. See `LICENSE.txt` for full details.
+
+Contact
+-------
+For questions or feedback, contact:
+
+- Email: abuawaish7@gmail.com
+- GitHub: https://github.com/abuawaish/CRUD_App
+
+
+CHANGELOG
+=========
+
+Version 1.0 (2025-01-27)
+---------------------------
+
+- Initial release of PyAwaish.
+- Added dynamic MySQL configuration through a web interface.
+- Implemented template rendering for `config_mysql.html` and `home.html`.
+- Developed `/execute_query` endpoint for executing MySQL queries.
+- Supported CRUD operations: insert, delete, update, fetch_data.
+- Enabled secure database connection using environment variables.
+- Provided RESTFul API design for interaction with MySQL.
+- Fixed the code markdown in readme.rst file
+- Added warning messages

pyawaish-1.0/PyAwaish.egg-info/SOURCES.txt

@@ -0,0 +1,16 @@
+CHANGELOG.txt
+LICENSE.txt
+MANIFEST.in
+README.rst
+pyproject.toml
+requirements.txt
+setup.py
+PyAwaish/MysqlApplication.py
+PyAwaish/__init__.py
+PyAwaish.egg-info/PKG-INFO
+PyAwaish.egg-info/SOURCES.txt
+PyAwaish.egg-info/dependency_links.txt
+PyAwaish.egg-info/requires.txt
+PyAwaish.egg-info/top_level.txt
+PyAwaish/templates/config_mysql.html
+PyAwaish/templates/home.html

pyawaish-1.0/PyAwaish.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyawaish-1.0/PyAwaish.egg-info/requires.txt

@@ -0,0 +1,2 @@
+Flask
+Flask-MySQLdb

pyawaish-1.0/PyAwaish.egg-info/top_level.txt

@@ -0,0 +1 @@
+PyAwaish

pyawaish-1.0/README.rst

@@ -0,0 +1,147 @@
+PyAwaish
+===========
+
+**PyAwaish** is a Flask-based Python framework that simplifies the development of MySQL-powered web applications. It provides a streamlined interface for connecting to a MySQL database, rendering templates, and executing queries dynamically via RESTful APIs.
+
+Features
+--------
+- **Dynamic MySQL Configuration**: Configure MySQL database settings at runtime via a web interface.
+- **Template Rendering**: Built-in support for rendering templates stored in the `templates` folder.
+- **Query Execution API**: Execute MySQL queries dynamically through POST requests.
+- **CRUD Operations**: Perform create, read, update, and delete operations programmatically.
+- **RESTful Design**: Leverage Flask to expose endpoints for database interactions.
+- **Environment Configuration**: Load sensitive credentials securely using environment variables.
+
+Badges
+------
+
+.. image:: https://badge.fury.io/py/PyAwaish.svg
+    :target: https://pypi.org/project/PyAwaish/
+
+.. image:: https://img.shields.io/badge/License-MIT-yellow.svg
+    :target: https://opensource.org/licenses/MIT
+
+
+Endpoints
+---------
+1. **`/`**: Displays the MySQL configuration page.
+2. **`/home`**: Displays the home page.
+3. **`/config_mysql`**: Accepts a POST request to configure MySQL connection details dynamically.
+4. **`/execute_query`**: Accepts a POST request to execute MySQL queries or perform operations (e.g., insert, delete, update).
+
+Installation
+------------
+1. Clone the repository:
+
+   .. code-block:: bash
+
+       git clone https://github.com/abuawaish/CRUD_App.git
+       cd CRUD_App
+
+2. Install the required dependencies:
+
+   .. code-block:: bash
+
+       pip install -r requirements.txt
+
+3. Install the package:
+
+   .. code-block:: bash
+
+       pip install PyAwaish
+
+4. Set environment variables for database configuration:
+
+   .. code-block:: bash
+
+       export MYSQL_HOST=localhost
+       export MYSQL_USER=root
+       export MYSQL_PASSWORD=your password
+       export MYSQL_DB=mydatabase
+       export SECRET_KEY=your_secret_key
+
+
+Usage
+-----
+
+**Running the Application**
+
+To start the MysqlWebApp server, instantiate the `MysqlApplication` class and call its `execute` method. For example:
+
+.. code-block:: python
+
+    from PyAwaish.MysqlApplication import MysqlApplication
+
+    if __name__ == "__main__":
+        app = MysqlApplication()
+        app.execute()
+
+**This will:**
+
+- Start a Flask server on `http://0.0.0.0:5001`.
+- Serve endpoints for configuring and interacting with the MySQL database.
+
+
+**Configuring MySQL**
+
+1. Navigate to the root endpoint (`http://localhost:5001/`) to access the configuration page.
+2. Enter the database details (host, username, password, database name) and click "Save".
+3. Upon successful configuration, you will be redirected to the home page.
+
+**Executing Queries**
+
+Use the `/execute_query` endpoint to run SQL queries or perform operations. Example request:
+
+- **POST Request Example**:
+
+  .. code-block:: json
+
+      {
+          "operation": "insert",
+          "table_name": "users",
+          "columns": "name, email",
+          "values": "'John Doe', 'john@example.com'"
+      }
+
+- **Supported Operations**:
+  - `insert`: Insert data into a table.
+  - `delete`: Delete data from a table with a condition.
+  - `update`: Update data in a table with a condition.
+  - `fetch_data`: Fetch all data from a table.
+  - `show_tables`: List all tables in the database.
+
+Dependencies
+------------
+The application requires the following dependencies (listed in `requirements.txt`):
+
+- Flask: Web framework.
+- Flask-MySQLdb: MySQL connector for Flask.
+
+To install them, run:
+
+.. code-block:: bash
+
+    pip install -r requirements.txt
+
+Environment Variables
+---------------------
+- **MYSQL_HOST**: MySQL server hostname (default: `localhost`).
+- **MYSQL_USER**: MySQL username (default: `root`).
+- **MYSQL_PASSWORD**: MySQL password.
+- **MYSQL_DB**: Default MySQL database name.
+- **SECRET_KEY**: Flask secret key for session security.
+
+Changelog
+---------
+Refer to `CHANGELOG.txt` for the complete version history of the project.
+
+License
+-------
+This project is licensed under the MIT License. See `LICENSE.txt` for full details.
+
+Contact
+-------
+For questions or feedback, contact:
+
+- Email: abuawaish7@gmail.com
+- GitHub: https://github.com/abuawaish/CRUD_App

pyawaish-1.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools", "wheel"]
+build-backend = "setuptools.build_meta"

pyawaish-1.0/requirements.txt

@@ -0,0 +1,2 @@
+Flask
+Flask-MySQLdb

pyawaish-1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

pyawaish-1.0/setup.py

@@ -0,0 +1,36 @@
+from setuptools import setup, find_packages
+
+with open('README.rst', encoding='utf-8') as readme_file:
+    long_description = readme_file.read()
+
+with open('CHANGELOG.txt', encoding='utf-8') as changelog_file:
+    long_description += '\n\n' + changelog_file.read()
+
+setup(
+    name="PyAwaish",
+    version="1.0",
+    author="Abu Awaish",
+    author_email="abuawaish7@gmail.com",
+    description="A Python package for building dynamic MySQL-powered web applications with template support",
+    long_description=long_description,
+    long_description_content_type="text/x-rst",  # Use RST for README and changelog
+    url="https://github.com/abuawaish/Crud_app",
+    packages=find_packages(),
+    include_package_data=True,  # Include non-code files specified in MANIFEST.in
+    package_data={
+        "PyAwaish": ["templates/**/*"],  # Include all files in templates and subdirectories
+    },
+    license="MIT",
+    license_files=['LICENSE.txt'],  # Explicitly include the license file
+    install_requires=[
+        'Flask',
+        'Flask-MySQLdb',
+    ],
+    keywords="web application flask mysql dynamic templates",
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.6",  # Specify the minimum Python version
+)