Plinx 0.0.1__tar.gz → 1.0.0__tar.gz

{Plinx-0.0.1 → Plinx-1.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Plinx
-Version: 0.0.1
+Version: 1.0.0
 Summary: Plinx is an experimental, minimalistic, and extensible web framework and ORM written in Python.
 Home-page: https://github.com/dhavalsavalia/plinx
 Author: Dhaval Savalia
@@ -20,7 +20,7 @@ License-File: LICENSE
 # Plinx
 
 ![purpose](https://img.shields.io/badge/purpose-learning-green.svg)
-![PyPI](https://img.shields.io/pypi/v/bumbo.svg)
+![PyPI](https://img.shields.io/pypi/v/Plinx.svg)
 
 **Plinx** is an experimental, minimalistic, and extensible WSGI-based web framework and ORM written in Python.  
 It is designed to be simple, fast, and easy to extend, making it ideal for rapid prototyping and educational purposes.
@@ -29,8 +29,9 @@ It is designed to be simple, fast, and easy to extend, making it ideal for rapid
 
 ## Features
 
-- 🚀 Minimal and fast web framework
-- 🛣️ Intuitive routing system
+- 🚀 Minimal and fast WSGI web framework
+- 💾 Integrated Object-Relational Mapper (ORM)
+- 🛣️ Intuitive routing system (including parameterized and class-based routes)
 - 🧩 Extensible middleware support
 - 🧪 Simple, readable codebase for learning and hacking
 - 📝 Type hints and modern Python best practices
@@ -39,6 +40,12 @@ It is designed to be simple, fast, and easy to extend, making it ideal for rapid
 
 ## Installation
 
+Install from PyPI:
+
+```bash
+pip install Plinx
+```
+
 Install directly from the git source:
 
 ```bash
@@ -52,19 +59,30 @@ pip install git+https://github.com/dhavalsavalia/plinx.git
 Create a simple web application in seconds:
 
 ```python
+# myapp.py
 from plinx import Plinx
 
 app = Plinx()
 
 @app.route("/")
 def index(request, response):
-    response.text = "Hello, world!"
+    response.text = "Hello, Plinx 1.0.0!"
+
+# Example using the ORM (requires database setup)
+# from plinx.orm import Database, Table, Column
+# db = Database("my_database.db")
+# class Item(Table):
+#     name = Column(str)
+#     count = Column(int)
+# db.create(Item)
+# db.save(Item(name="Example", count=1))
 ```
 
-Run your app (example, assuming you have an ASGI server like `uvicorn`):
+Run your app using a WSGI server (like `gunicorn`):
 
 ```bash
-uvicorn myapp:app
+pip install gunicorn
+gunicorn myapp:app
 ```
 
 ## Testing
@@ -77,19 +95,6 @@ pytest --cov=.
 
 ---
 
-## Roadmap
-
-- [x] Web Framework
-  - [x] Routing
-  - [x] Explicit Routing Methods (GET, POST, etc.)
-  - [x] Parameterized Routes
-  - [x] Class Based Routes
-  - [x] Django-like Routes
-  - [x] Middleware Support
-- [ ] ORM
-
----
-
 ## Contributing
 
 Contributions are welcome! Please open issues or submit pull requests for improvements, bug fixes, or new features.
@@ -104,7 +109,7 @@ This project is licensed under the MIT License. See [LICENSE](LICENSE) for detai
 
 ## Author & Contact
 
-Created and maintained by [Dhaval Savalia](https://github.com/dhavalsavalia).  
+Created and maintained by [Dhaval Savalia](https://github.com/dhavalsavalia).
 For questions or opportunities, feel free to reach out via [LinkedIn](https://www.linkedin.com/in/dhavalsavalia/) or open an issue.
 
 ---

{Plinx-0.0.1 → Plinx-1.0.0}/Plinx.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: Plinx
-Version: 0.0.1
+Version: 1.0.0
 Summary: Plinx is an experimental, minimalistic, and extensible web framework and ORM written in Python.
 Home-page: https://github.com/dhavalsavalia/plinx
 Author: Dhaval Savalia
@@ -20,7 +20,7 @@ License-File: LICENSE
 # Plinx
 
 ![purpose](https://img.shields.io/badge/purpose-learning-green.svg)
-![PyPI](https://img.shields.io/pypi/v/bumbo.svg)
+![PyPI](https://img.shields.io/pypi/v/Plinx.svg)
 
 **Plinx** is an experimental, minimalistic, and extensible WSGI-based web framework and ORM written in Python.  
 It is designed to be simple, fast, and easy to extend, making it ideal for rapid prototyping and educational purposes.
@@ -29,8 +29,9 @@ It is designed to be simple, fast, and easy to extend, making it ideal for rapid
 
 ## Features
 
-- 🚀 Minimal and fast web framework
-- 🛣️ Intuitive routing system
+- 🚀 Minimal and fast WSGI web framework
+- 💾 Integrated Object-Relational Mapper (ORM)
+- 🛣️ Intuitive routing system (including parameterized and class-based routes)
 - 🧩 Extensible middleware support
 - 🧪 Simple, readable codebase for learning and hacking
 - 📝 Type hints and modern Python best practices
@@ -39,6 +40,12 @@ It is designed to be simple, fast, and easy to extend, making it ideal for rapid
 
 ## Installation
 
+Install from PyPI:
+
+```bash
+pip install Plinx
+```
+
 Install directly from the git source:
 
 ```bash
@@ -52,19 +59,30 @@ pip install git+https://github.com/dhavalsavalia/plinx.git
 Create a simple web application in seconds:
 
 ```python
+# myapp.py
 from plinx import Plinx
 
 app = Plinx()
 
 @app.route("/")
 def index(request, response):
-    response.text = "Hello, world!"
+    response.text = "Hello, Plinx 1.0.0!"
+
+# Example using the ORM (requires database setup)
+# from plinx.orm import Database, Table, Column
+# db = Database("my_database.db")
+# class Item(Table):
+#     name = Column(str)
+#     count = Column(int)
+# db.create(Item)
+# db.save(Item(name="Example", count=1))
 ```
 
-Run your app (example, assuming you have an ASGI server like `uvicorn`):
+Run your app using a WSGI server (like `gunicorn`):
 
 ```bash
-uvicorn myapp:app
+pip install gunicorn
+gunicorn myapp:app
 ```
 
 ## Testing
@@ -77,19 +95,6 @@ pytest --cov=.
 
 ---
 
-## Roadmap
-
-- [x] Web Framework
-  - [x] Routing
-  - [x] Explicit Routing Methods (GET, POST, etc.)
-  - [x] Parameterized Routes
-  - [x] Class Based Routes
-  - [x] Django-like Routes
-  - [x] Middleware Support
-- [ ] ORM
-
----
-
 ## Contributing
 
 Contributions are welcome! Please open issues or submit pull requests for improvements, bug fixes, or new features.
@@ -104,7 +109,7 @@ This project is licensed under the MIT License. See [LICENSE](LICENSE) for detai
 
 ## Author & Contact
 
-Created and maintained by [Dhaval Savalia](https://github.com/dhavalsavalia).  
+Created and maintained by [Dhaval Savalia](https://github.com/dhavalsavalia).
 For questions or opportunities, feel free to reach out via [LinkedIn](https://www.linkedin.com/in/dhavalsavalia/) or open an issue.
 
 ---

{Plinx-0.0.1 → Plinx-1.0.0}/Plinx.egg-info/SOURCES.txt

@@ -4,6 +4,7 @@ setup.py
 Plinx.egg-info/PKG-INFO
 Plinx.egg-info/SOURCES.txt
 Plinx.egg-info/dependency_links.txt
+Plinx.egg-info/requires.txt
 Plinx.egg-info/top_level.txt
 plinx/__init__.py
 plinx/applications.py
@@ -12,8 +13,8 @@ plinx/middleware.py
 plinx/response.py
 plinx/status_codes.py
 plinx/utils.py
-plinx.egg-info/PKG-INFO
-plinx.egg-info/SOURCES.txt
-plinx.egg-info/dependency_links.txt
-plinx.egg-info/top_level.txt
-tests/test_application.py
+plinx/orm/__init__.py
+plinx/orm/orm.py
+plinx/orm/utils.py
+tests/test_application.py
+tests/test_orm.py

Plinx-1.0.0/Plinx.egg-info/requires.txt

@@ -0,0 +1,2 @@
+webob
+parse

{Plinx-0.0.1 → Plinx-1.0.0}/README.md

@@ -1,7 +1,7 @@
 # Plinx
 
 ![purpose](https://img.shields.io/badge/purpose-learning-green.svg)
-![PyPI](https://img.shields.io/pypi/v/bumbo.svg)
+![PyPI](https://img.shields.io/pypi/v/Plinx.svg)
 
 **Plinx** is an experimental, minimalistic, and extensible WSGI-based web framework and ORM written in Python.  
 It is designed to be simple, fast, and easy to extend, making it ideal for rapid prototyping and educational purposes.
@@ -10,8 +10,9 @@ It is designed to be simple, fast, and easy to extend, making it ideal for rapid
 
 ## Features
 
-- 🚀 Minimal and fast web framework
-- 🛣️ Intuitive routing system
+- 🚀 Minimal and fast WSGI web framework
+- 💾 Integrated Object-Relational Mapper (ORM)
+- 🛣️ Intuitive routing system (including parameterized and class-based routes)
 - 🧩 Extensible middleware support
 - 🧪 Simple, readable codebase for learning and hacking
 - 📝 Type hints and modern Python best practices
@@ -20,6 +21,12 @@ It is designed to be simple, fast, and easy to extend, making it ideal for rapid
 
 ## Installation
 
+Install from PyPI:
+
+```bash
+pip install Plinx
+```
+
 Install directly from the git source:
 
 ```bash
@@ -33,19 +40,30 @@ pip install git+https://github.com/dhavalsavalia/plinx.git
 Create a simple web application in seconds:
 
 ```python
+# myapp.py
 from plinx import Plinx
 
 app = Plinx()
 
 @app.route("/")
 def index(request, response):
-    response.text = "Hello, world!"
+    response.text = "Hello, Plinx 1.0.0!"
+
+# Example using the ORM (requires database setup)
+# from plinx.orm import Database, Table, Column
+# db = Database("my_database.db")
+# class Item(Table):
+#     name = Column(str)
+#     count = Column(int)
+# db.create(Item)
+# db.save(Item(name="Example", count=1))
 ```
 
-Run your app (example, assuming you have an ASGI server like `uvicorn`):
+Run your app using a WSGI server (like `gunicorn`):
 
 ```bash
-uvicorn myapp:app
+pip install gunicorn
+gunicorn myapp:app
 ```
 
 ## Testing
@@ -58,19 +76,6 @@ pytest --cov=.
 
 ---
 
-## Roadmap
-
-- [x] Web Framework
-  - [x] Routing
-  - [x] Explicit Routing Methods (GET, POST, etc.)
-  - [x] Parameterized Routes
-  - [x] Class Based Routes
-  - [x] Django-like Routes
-  - [x] Middleware Support
-- [ ] ORM
-
----
-
 ## Contributing
 
 Contributions are welcome! Please open issues or submit pull requests for improvements, bug fixes, or new features.
@@ -85,7 +90,7 @@ This project is licensed under the MIT License. See [LICENSE](LICENSE) for detai
 
 ## Author & Contact
 
-Created and maintained by [Dhaval Savalia](https://github.com/dhavalsavalia).  
+Created and maintained by [Dhaval Savalia](https://github.com/dhavalsavalia).
 For questions or opportunities, feel free to reach out via [LinkedIn](https://www.linkedin.com/in/dhavalsavalia/) or open an issue.
 
 ---

Plinx-1.0.0/plinx/orm/__init__.py

@@ -0,0 +1 @@
+from .orm import Column, Database, ForeignKey, Table  # noqa

Plinx-1.0.0/plinx/orm/orm.py

@@ -0,0 +1,240 @@
+import inspect
+import sqlite3
+from typing import Generic, TypeVar
+
+from .utils import SQLITE_TYPE_MAP
+
+T = TypeVar("T")
+
+
+class Database:
+    def __init__(self, path: str):
+        self.connection = sqlite3.Connection(path)
+
+    def create(self, table: "Table"):
+        self.connection.execute(table._get_create_sql())
+
+    def save(self, instance: "Table"):
+        sql, values = instance._get_insert_sql()
+        cursor = self.connection.execute(sql, values)
+        instance._data["id"] = cursor.lastrowid
+        self.connection.commit()
+
+    def all(self, table: "Table"):
+        sql, fields = table._get_select_all_sql()
+        rows = self.connection.execute(sql).fetchall()
+
+        result = []
+
+        for row in rows:
+            properties = {}
+            for field, value in zip(fields, row):
+                if field.endswith("_id"):
+                    foreign_key = field[:-3]
+                    foreign_table = getattr(table, foreign_key).table
+                    properties[foreign_key] = self.get(foreign_table, id=value)
+                else:
+                    properties[field] = value
+            result.append(table(**properties))
+
+        return result
+
+    def get(self, table: "Table", **kwargs):
+        sql, fields, params = table._get_select_where_sql(**kwargs)
+        row = self.connection.execute(sql, params).fetchone()
+
+        if row is None:
+            raise Exception(f"{table.__name__} instance with {kwargs} does not exist")
+
+        properties = {}
+
+        for field, value in zip(fields, row):
+            if field.endswith("_id"):
+                foreign_key = field[:-3]
+                foreign_table = getattr(table, foreign_key).table
+                properties[foreign_key] = self.get(foreign_table, id=value)
+            else:
+                properties[field] = value
+
+        return table(**properties)
+
+    def update(self, instance: "Table"):
+        sql, values = instance._get_update_sql()
+        self.connection.execute(sql, values)
+        self.connection.commit()
+
+    def delete(self, instance: "Table"):
+        sql, values = instance._get_delete_sql()
+        self.connection.execute(sql, values)
+        self.connection.commit()
+
+    def close(self):
+        if self.connection:
+            self.connection.close()
+        self.connection = None
+
+    @property
+    def tables(self):
+        SELECT_TABLES_SQL = "SELECT name FROM sqlite_master WHERE type = 'table';"
+        return [x[0] for x in self.connection.execute(SELECT_TABLES_SQL).fetchall()]
+
+
+class Column:
+    def __init__(self, type: Generic[T]):
+        self.type = type
+
+    @property
+    def sql_type(self):
+        return SQLITE_TYPE_MAP[self.type]
+
+
+class ForeignKey:
+    def __init__(self, table):
+        self.table = table
+
+
+class Table:
+    def __init__(self, **kwargs):
+        self._data = {"id": None}
+
+        for key, value in kwargs.items():
+            self._data[key] = value
+
+    def __getattribute__(self, key):
+        """
+        Values to be access are in `self._data`
+        Accessing without __getattribute__ will return Column or ForeignKey and not the actual value
+        """
+        # Why use super().__getattribute__ instead of self._data[key]?
+        # Because otherwise it will create an infinite loop since __getattribute__ will call itself
+        # and will never return the value
+        _data = super().__getattribute__("_data")
+        if key in _data:
+            return _data[key]
+        return super().__getattribute__(key)
+
+    def __setattr__(self, key, value):
+        """
+        Values to be set are in `self._data`
+        """
+        super().__setattr__(key, value)
+        if key in self._data:
+            self._data[key] = value
+
+    @classmethod
+    def _get_create_sql(cls):
+        CREATE_TABLE_SQL = "CREATE TABLE IF NOT EXISTS {name} ({fields});"
+        fields = [
+            "id INTEGER PRIMARY KEY AUTOINCREMENT",
+        ]
+
+        for name, field in inspect.getmembers(cls):
+            if isinstance(field, Column):
+                fields.append(f"{name} {field.sql_type}")
+            elif isinstance(field, ForeignKey):
+                fields.append(f"{name}_id INTEGER")
+
+        fields = ", ".join(fields)
+        name = cls.__name__.lower()
+        return CREATE_TABLE_SQL.format(name=name, fields=fields)
+
+    def _get_insert_sql(self):
+        INSERT_SQL = "INSERT INTO {name} ({fields}) VALUES ({placeholders});"
+
+        cls = self.__class__
+        fields = []
+        placeholders = []
+        values = []
+
+        for name, field in inspect.getmembers(cls):
+            if isinstance(field, Column):
+                fields.append(name)
+                values.append(getattr(self, name))
+                placeholders.append("?")
+            elif isinstance(field, ForeignKey):
+                fields.append(name + "_id")
+                values.append(getattr(self, name).id)
+                placeholders.append("?")
+
+        fields = ", ".join(fields)
+        placeholders = ", ".join(placeholders)
+
+        sql = INSERT_SQL.format(
+            name=cls.__name__.lower(), fields=fields, placeholders=placeholders
+        )
+
+        return sql, values
+
+    @classmethod
+    def _get_select_all_sql(cls):
+        SELECT_ALL_SQL = "SELECT {fields} FROM {name};"
+
+        fields = ["id"]
+
+        for name, field in inspect.getmembers(cls):
+            if isinstance(field, Column):
+                fields.append(name)
+            elif isinstance(field, ForeignKey):
+                fields.append(name + "_id")
+
+        return SELECT_ALL_SQL.format(
+            fields=", ".join(fields),
+            name=cls.__name__.lower(),
+        ), fields
+
+    @classmethod
+    def _get_select_where_sql(cls, **kwargs):
+        SELECT_WHERE_SQL = "SELECT {fields} FROM {name} WHERE {query};"
+
+        fields = ["id"]
+        query = []
+        values = []
+
+        for name, field in inspect.getmembers(cls):
+            if isinstance(field, Column):
+                fields.append(name)
+            elif isinstance(field, ForeignKey):
+                fields.append(name + "_id")
+
+        for key, value in kwargs.items():
+            query.append(f"{key} = ?")
+            values.append(value)
+
+        return (
+            SELECT_WHERE_SQL.format(
+                fields=", ".join(fields),
+                name=cls.__name__.lower(),
+                query=", ".join(query),
+            ),
+            fields,
+            values,
+        )
+
+    def _get_update_sql(self):
+        UPDATE_SQL = "UPDATE {name} SET {fields} WHERE id = ?;"
+
+        cls = self.__class__
+        fields = []
+        values = []
+
+        for name, field in inspect.getmembers(cls):
+            if isinstance(field, Column):
+                fields.append(name)
+                values.append(getattr(self, name))
+            elif isinstance(field, ForeignKey):
+                fields.append(name + "_id")
+                values.append(getattr(self, name).id)
+
+        values.append(getattr(self, "id"))
+
+        return UPDATE_SQL.format(
+            name=cls.__name__.lower(),
+            fields=", ".join([f"{field} = ?" for field in fields]),
+        ), values
+
+    def _get_delete_sql(self):
+        DELETE_SQL = "DELETE FROM {name} WHERE id = ?;"
+
+        return DELETE_SQL.format(
+            name=self.__class__.__name__.lower()
+        ), [getattr(self, "id")]

Plinx-1.0.0/plinx/orm/utils.py

@@ -0,0 +1,7 @@
+SQLITE_TYPE_MAP = {
+    int: "INTEGER",
+    float: "REAL",
+    str: "TEXT",
+    bytes: "BLOB",
+    bool: "INTEGER"
+}

{Plinx-0.0.1 → Plinx-1.0.0}/setup.py

@@ -15,7 +15,7 @@ AUTHOR = "Dhaval Savalia"
 REQUIRES_PYTHON = ">=3.11.0"
 VERSION = None
 
-REQUIRED = []
+REQUIRED = ["webob", "parse"]
 EXTRAS = {}
 
 with open("VERSION", "r") as f:

{Plinx-0.0.1 → Plinx-1.0.0}/tests/test_application.py

@@ -1,20 +1,9 @@
 import pytest
 
-from plinx import Plinx
 from plinx.methods import HTTPMethods
 from plinx.middleware import Middleware
 
 
-@pytest.fixture
-def app():
-    return Plinx()
-
-
-@pytest.fixture
-def client(app):
-    return app.test_session()
-
-
 class TestFlaskLikeApplication:
     def test_app_object(self, app):
         assert app.routes == {}

Plinx-1.0.0/tests/test_orm.py

@@ -0,0 +1,272 @@
+import sqlite3
+
+import pytest
+
+
+def test_database_connection(db):
+    assert db.connection is not None
+    assert isinstance(db.connection, sqlite3.Connection)
+    assert db.tables == []
+
+
+def test_define_tables(Author, Book):
+    assert Author.name.type is str
+    assert Book.author.table is Author
+
+    assert Author.name.sql_type == "TEXT"
+    assert Author.age.sql_type == "INTEGER"
+
+
+def test_create_tables(db, Author, Book):
+    db.create(Author)
+    db.create(Book)
+
+    assert (
+        Author._get_create_sql()
+        == "CREATE TABLE IF NOT EXISTS author (id INTEGER PRIMARY KEY AUTOINCREMENT, age INTEGER, name TEXT);"
+    )
+    assert (
+        Book._get_create_sql()
+        == "CREATE TABLE IF NOT EXISTS book (id INTEGER PRIMARY KEY AUTOINCREMENT, author_id INTEGER, published INTEGER, title TEXT);"
+    )
+
+    for table in ("author", "book"):
+        assert table in db.tables
+
+
+def test_create_author_instance(db, Author):
+    db.create(Author)
+
+    john = Author(name="John Doe", age=35)
+
+    assert john.name == "John Doe"
+    assert john.age == 35
+    assert john.id is None
+
+
+def test_save_author_instances(db, Author):
+    db.create(Author)
+
+    john = Author(name="John Doe", age=23)
+    db.save(john)
+    assert john._get_insert_sql() == (
+        "INSERT INTO author (age, name) VALUES (?, ?);",
+        [23, "John Doe"],
+    )
+    assert john.id == 1
+
+    man = Author(name="Man Harsh", age=28)
+    db.save(man)
+    assert man.id == 2
+
+    vik = Author(name="Vik Star", age=43)
+    db.save(vik)
+    assert vik.id == 3
+
+    jack = Author(name="Jack Ma", age=39)
+    db.save(jack)
+    assert jack.id == 4
+
+
+def test_save_book_instance(db, Author, Book):
+    db.create(Author)
+    db.create(Book)
+
+    john = Author(name="John Doe", age=23)
+    db.save(john)
+
+    book = Book(
+        title="Test Book",
+        published=True,
+        author=john,
+    )
+    db.save(book)
+
+    assert book._get_insert_sql() == (
+        "INSERT INTO book (author_id, published, title) VALUES (?, ?, ?);",
+        [1, True, "Test Book"],
+    )
+    assert book.id == 1
+
+
+def test_query_all_authors(db, Author):
+    db.create(Author)
+    john = Author(name="John Doe", age=23)
+    vik = Author(name="Vik Star", age=43)
+    db.save(john)
+    db.save(vik)
+
+    authors = db.all(Author)
+
+    assert Author._get_select_all_sql() == (
+        "SELECT id, age, name FROM author;",
+        ["id", "age", "name"],
+    )
+    assert len(authors) == 2
+    assert type(authors[0]) is Author
+    assert {a.age for a in authors} == {23, 43}
+    assert {a.name for a in authors} == {"John Doe", "Vik Star"}
+
+
+def test_query_all_books(db, Author, Book):
+    db.create(Author)
+    db.create(Book)
+
+    john = Author(name="John Doe", age=23)
+    db.save(john)
+
+    book = Book(
+        title="Test Book",
+        published=True,
+        author=john,
+    )
+    db.save(book)
+
+    books = db.all(Book)
+
+    assert Book._get_select_all_sql() == (
+        "SELECT id, author_id, published, title FROM book;",
+        ["id", "author_id", "published", "title"],
+    )
+    assert len(books) == 1
+    assert type(books[0]) is Book
+    assert {b.title for b in books} == {"Test Book"}
+    assert books[0].author.name == "John Doe"
+    assert books[0].author.age == 23
+
+
+def test_get_author(db, Author):
+    db.create(Author)
+    john_srow = Author(name="John Doe", age=43)  # get it? John Snow
+    db.save(john_srow)
+
+    john_from_db = db.get(Author, id=1)
+
+    assert Author._get_select_where_sql(id=1) == (
+        "SELECT id, age, name FROM author WHERE id = ?;",
+        ["id", "age", "name"],
+        [1],
+    )
+    assert type(john_from_db) is Author
+    assert john_from_db.age == 43
+    assert john_from_db.name == "John Doe"
+    assert john_from_db.id == 1
+
+
+def test_get_book(db, Author, Book):
+    db.create(Author)
+    db.create(Book)
+
+    john = Author(name="John Doe", age=23)
+    db.save(john)
+
+    book = Book(
+        title="Test Book",
+        published=True,
+        author=john,
+    )
+    db.save(book)
+
+    book_from_db = db.get(Book, title="Test Book")
+    assert Book._get_select_where_sql(title="Test Book") == (
+        "SELECT id, author_id, published, title FROM book WHERE title = ?;",
+        ["id", "author_id", "published", "title"],
+        ["Test Book"],
+    )
+    assert type(book_from_db) is Book
+    assert book_from_db.id == 1
+    assert book_from_db.title == "Test Book"
+    assert book_from_db.author.name == "John Doe"
+    assert book_from_db.author.age == 23
+
+
+def test_get_invalid_book(db, Author, Book):
+    db.create(Author)
+    db.create(Book)
+
+    john = Author(name="John Doe", age=23)
+    db.save(john)
+
+    book = Book(
+        title="Test Book",
+        published=True,
+        author=john,
+    )
+    db.save(book)
+
+    
+    with pytest.raises(Exception) as excinfo:
+        db.get(Book, id=2)
+
+        assert isinstance(excinfo.value, Exception)
+        assert "Book instance with {'id': 2} does not exist" == str(excinfo.value)
+
+
+def test_update_author(db, Author):
+    db.create(Author)
+    john = Author(name="John Doe", age=23)
+    db.save(john)
+
+    john.age = 43
+    john.name = "John Snow"
+    db.update(john)
+
+    assert john._get_update_sql() == (
+        "UPDATE author SET age = ?, name = ? WHERE id = ?;",
+        [43, "John Snow", 1],
+    )
+
+    john_from_db = db.get(Author, id=john.id)
+
+    assert john_from_db.age == 43
+    assert john_from_db.name == "John Snow"
+    assert john_from_db.id == 1
+
+
+def test_update_book(db, Author, Book):
+    db.create(Author)
+    db.create(Book)
+
+    john = Author(name="John Doe", age=23)
+    db.save(john)
+
+    book = Book(
+        title="Test Book",
+        published=1,
+        author=john,
+    )
+    db.save(book)
+
+    book.title = "Updated Book"
+    book.published = False
+    db.update(book)
+
+    assert book._get_update_sql() == (
+        "UPDATE book SET author_id = ?, published = ?, title = ? WHERE id = ?;",
+        [1, False, "Updated Book", 1],
+    )
+
+    book_from_db = db.get(Book, id=book.id)
+
+    assert book_from_db.title == "Updated Book"
+    assert book_from_db.id == 1
+    assert book_from_db.published == False # noqa 0 is False 
+
+
+def test_delete_author(db, Author):
+    db.create(Author)
+    john = Author(name="John Doe", age=23)
+    db.save(john)
+
+    assert john._get_delete_sql() == (
+        "DELETE FROM author WHERE id = ?;",
+        [1]
+    )
+
+    db.delete(john)
+
+    with pytest.raises(Exception) as excinfo:
+        db.get(Author, id=john.id)
+
+        assert isinstance(excinfo.value, Exception)
+        assert "Author instance with {'id': 1} does not exist" == str(excinfo.value)