add

README.md

@@ -6,27 +6,36 @@ using the native Postgres extension `ltree`.
 Postgresql has already a optimized and very useful tree implementation for data.
 The extension is [ltree](https://www.postgresql.org/docs/9.6/static/ltree.html)
 
-This fork contains a backport to Django 1.11 and Python 3.6.
+This fork contains is a continuation of the work done by [`mariocesar`](https://github.com/mariocesar/) on [`django-ltree`](https://github.com/mariocesar/django-ltree).
 
+<!--
 [![Test](https://github.com/mariocesar/django-ltree/actions/workflows/test.yml/badge.svg)](https://github.com/mariocesar/django-ltree/actions/workflows/test.yml)
-
+ -->
 
 ## Links
 
- - Pypi https://pypi.org/project/django-ltree/
- - Source code https://github.com/mariocesar/django-ltree
- - Bugs https://github.com/mariocesar/django-ltree/issues
- - Contribute https://github.com/mariocesar/django-ltree/pulls
- - Documentation `TODO`
+-   Pypi https://pypi.org/project/django-ltree/
+-   Source code https://github.com/mariocesar/django-ltree
+-   Bugs https://github.com/mariocesar/django-ltree/issues
+-   Contribute https://github.com/mariocesar/django-ltree/pulls
+-   Documentation `TODO`
 
 ## Install
 
-```
+```py
 pip install django-ltree
 ```
 
 Then add `django_ltree` to `INSTALLED_APPS` in your Django project settings.
 
+```python
+INSTALLED_APPS = [
+    ...,
+    'django_ltree',
+    ...
+]
+```
+
 And make sure to run `django_ltree` migrations before you added the `PathField`
 
 ```
@@ -38,7 +47,7 @@ python manage.py migrate django_ltree
 You can alternatively specify the `django_ltree` dependency in the migrations of
 your applications that requires `PathField`, and run migrations smoothly.
 
-```
+```python
 class Migration(migrations.Migration):
     dependencies = [
             ('django_ltree', '__latest__'),
@@ -47,8 +56,8 @@ class Migration(migrations.Migration):
 
 ## Requires
 
-- Django 1.11 or superior
-- Python 2
+-   Django 5.0 or superior
+-   Python 3.10 or higher
 
 ## Testing
 

django_ltree/fields.py

@@ -101,4 +101,4 @@ def get_db_prep_value(self, value, connection, prepared=False):
         elif isinstance(value, (list, str)):
             return str(PathValue(value))
 
-        raise ValueError("Unknown value type {}".format(type(value)))
+        raise ValueError(f"Unknown value type {type(value)}")

django_ltree/lookups.py

@@ -9,7 +9,7 @@ class SimpleLookup(Lookup):
     def as_sql(self, compiler, connection):
         lhs, lhs_params = self.process_lhs(compiler, connection)
         rhs, rhs_params = self.process_rhs(compiler, connection)
-        return "{} {} {}".format(lhs, self.lookup_operator, rhs), [
+        return f"{lhs} {self.lookup_operator} {rhs}", [
             *lhs_params,
             *rhs_params,
         ]
@@ -22,7 +22,7 @@ class EqualLookup(Lookup):
     def as_sql(self, compiler, connection):
         lhs, lhs_params = self.process_lhs(compiler, connection)
         rhs, rhs_params = self.process_rhs(compiler, connection)
-        return "{} = {}".format(lhs, rhs), [*lhs_params, *rhs_params]
+        return f"{lhs} = {rhs}", [*lhs_params, *rhs_params]
 
 
 @PathField.register_lookup

django_ltree/migrations/0001_create_extension.py

@@ -4,12 +4,10 @@
 class Migration(migrations.Migration):
     initial = True
 
-    dependencies = [
-    ]
+    dependencies = []
 
     operations = [
         migrations.RunSQL(
-            "CREATE EXTENSION IF NOT EXISTS ltree;",
-            "DROP EXTENSION ltree;"
+            "CREATE EXTENSION IF NOT EXISTS ltree;", "DROP EXTENSION ltree;"
         )
     ]

django_ltree/models.py

@@ -1,4 +1,5 @@
 from django.db import models
+from typing import Any
 
 from .fields import PathField, PathValue
 from .managers import TreeManager
@@ -15,12 +16,8 @@ class Meta:
     def label(self):
         return self.path[-1]
 
-    def get_ancestors_paths(self):  # type: () -> List[List[str]]
-        return [
-            PathValue(self.path[:n])
-            for n, p in enumerate(self.path)
-            if n > 0
-        ]
+    def get_ancestors_paths(self) -> list[list[str]]:
+        return [PathValue(self.path[:n]) for n, p in enumerate(self.path) if n > 0]
 
     def ancestors(self):
         return type(self)._default_manager.filter(path__ancestors=self.path)
@@ -44,7 +41,7 @@ def siblings(self):
             .exclude(path=self.path)
         )
 
-    def add_child(self, slug, **kwargs):  # type:(str) -> Any
+    def add_child(self, slug: str, **kwargs) -> Any:
         assert "path" not in kwargs
         kwargs["path"] = self.path[:]
         kwargs["path"].append(slug)

pyproject.toml

@@ -27,6 +27,7 @@ django = ">=5.0.2"
 
 [tool.poetry.group.dev.dependencies]
 pytest = "^8.0.1"
+tox = "^4.13.0"
 
 [build-system]
 requires = ["poetry-core"]