Initial additions

Author: rhedgpeth

README.md

@@ -1 +1,79 @@
 # Quick Start: Python and MariaDB
+
+This repository will walk you through the process of quickly getting started with [Node.js](https://www.python.org/) and [MariaDB](https://github.com/mariadb-developers/mariadb-getting-started) using the [MariaDB Python connector](https://github.com/mariadb-corporation/mariadb-connector-python).
+
+## Requirements
+
+This sample requires the following to be installed/enabled on your machine:
+
+* [Python (v. 3+)](https://www.python.org/downloads/)
+* [MariaDB Connector/C (v. 3.1.5+)](https://mariadb.com/products/skysql/docs/clients/mariadb-connector-c-for-skysql-services/) (used by Connector/Python, find more information [here](https://mariadb.com/docs/clients/mariadb-connectors/connector-python/install/))
+
+## Installing MariaDB Connector/Python
+
+To run the sample code in this repository you'll first need to [install the MariaDB Python connector (driver)](https://mariadb.com/docs/clients/mariadb-connectors/connector-python/install/).
+
+## Running these samples
+
+Once you've installed the MariaDB Python connector you're ready to run the [tasks.py](src/tasks.py) sample.
+
+The [tasks.py](src/tasks.py) sample can be used to:
+
+* `Create` a database and table (necessary for the subsequent CRUD operations).
+
+    ```bash
+    $ python3 tasks.py create
+    ```
+
+* `Drop` the database (and table).
+
+    ```bash
+    $ python3 tasks.py drop
+    ```
+
+* `Insert` a new tasks record.
+
+    ```bash
+    $ python3 tasks.py add 'New Task Description'
+    ```
+
+* `Update` a task record's completion field (by specifying the `id` and `completion` value).
+
+    ```bash
+    $ python3 tasks.py update 3 1
+    ```
+
+* `Select` and print all tasks.
+
+    ```bash 
+    $ python3 tasks.py show
+    ```
+
+* `Delete` a task record (by `id`).
+
+    ```bash
+    $ python3 tasks.py delete 3
+    ```
+
+## Helpful Resources
+
+* [How to connect Python programs to MariaDB](https://mariadb.com/resources/blog/how-to-connect-python-programs-to-mariadb/) (blog)
+* [Official MariaDB Documentation](https://mariadb.com/docs)
+* [MariaDB Quickstart Guide](https://github.com/mariadb-developers/mariadb-getting-started)
+
+## Support and Contribution
+
+Please feel free to submit PR's, issues or requests to this project directly.
+
+If you have any other questions, comments, or looking for more information on MariaDB please check out:
+
+* [MariaDB Developer Hub](https://mariadb.com/developers)
+* [MariaDB Community Slack](https://r.mariadb.com/join-community-slack)
+
+Or reach out to us directly via:
+
+* [[email protected]](mailto:[email protected])
+* [MariaDB Twitter](https://twitter.com/mariadb)
+
+## License <a name="license"></a>
+[![License](https://img.shields.io/badge/License-MIT-blue.svg?style=plastic)](https://opensource.org/licenses/MIT)

src/tasks.py

@@ -0,0 +1,80 @@
+import sys
+import mariadb
+
+def createSchema(cur):
+    cur.execute("CREATE DATABASE todo")
+    print("todo database created")
+    cur.execute("""CREATE TABLE todo.tasks (
+                        id INT(11) unsigned NOT NULL AUTO_INCREMENT,
+                        description VARCHAR(500) NOT NULL,
+                        completed BOOLEAN NOT NULL DEFAULT 0,
+                        PRIMARY KEY (id)
+                    )""")
+    print("tasks table created")
+
+def dropSchema(cur):
+    cur.execute("DROP DATABASE todo")
+    print("todo database and tasks table dropped")
+
+def addTask(cur, description):
+    cur.execute("INSERT INTO todo.tasks (description) VALUES (?)",[description])
+    print(f"Task (id={cur.lastrowid}) added successfully")
+ 
+def updateTask(cur, description, id):
+    cur.execute("UPDATE todo.tasks set completed = ? WHERE id = ?",[description,id])
+    print(f"Task (id={id}) status updated")
+
+def showTasks(cur):
+    cur.execute("SELECT * FROM todo.tasks")
+    # Print the results stored in the cursor
+    for id, description, completed in cur: 
+        print(f"id = {id}, description = {description}, completed = {completed}")
+
+def deleteTask(cur, id):
+    cur.execute("DELETE FROM todo.tasks WHERE id = ?",[id])
+    print(f"Task (id={id}) deleted")
+
+def main():
+    try:
+        args = sys.argv[1:]
+
+        if (len(args) == 0):
+            raise Exception("Invalid arguments")
+
+        action = args[0]
+
+        conn = mariadb.connect(
+            host="127.0.0.1",
+            user="root",
+            password="RootPassword123!",
+            autocommit=True
+        )
+
+        cur = conn.cursor()
+
+        if (action == "create"):
+            createSchema(cur)
+        elif (action == "drop"):
+            dropSchema(cur)
+        elif (action == "add"):
+            description = args[1]
+            addTask(cur, description)
+        elif (action == "updateStatus"):
+            id = args[1]
+            completed = args[2]
+            updateTask(cur, id, completed)
+        elif (action == "show"):
+            showTasks(cur)
+        elif (action == "delete"):
+            id = args[1]
+            deleteTask(cur, id)
+        else:
+            raise Exception("Invalid action argument")
+
+    except Exception as e:
+        print(e)
+    finally:
+        conn.close()
+
+if __name__ == "__main__":
+    main()