habarico 7.2.0__tar.gz

habarico-7.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Eluvia.land s.r.o.
+
+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.
+
+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.

habarico-7.2.0/MANIFEST.in

@@ -0,0 +1,4 @@
+include README.md
+include LICENSE
+include MANIFEST.in
+recursive-include src *.py *.txt *.html *.po *.mo *.xml *.xslt *.xsl *.js *.sass *.css *.png *.jpg *.jpeg *.gif

habarico-7.2.0/PKG-INFO

@@ -0,0 +1,140 @@
+Metadata-Version: 2.4
+Name: habarico
+Version: 7.2.0
+Summary: Habarico REST admin Django library
+Author-email: Luboš Mátl <lubos.matl@eluvia.com>
+License: MIT License
+        
+        Copyright (c) 2024 Eluvia.land s.r.o.
+        
+        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.
+        
+        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.
+        
+Project-URL: Documentation, https://docs.habarico.com/python/intro
+Project-URL: Source Code, https://github.com/eluvia-com/habarico
+Project-URL: Changelog, https://github.com/eluvia-com/habarico/blob/master/python/CHANGELOG.md
+Keywords: package,django,admin,eluvia,habarico
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: eluvia-base>=2.0.0
+Requires-Dist: eluvia-base-django>=2.3.2
+Requires-Dist: djangorestframework>=3.14
+Requires-Dist: django>=3.0.0
+Requires-Dist: django-filter>=23.1
+Requires-Dist: django-phonenumber-field[phonenumbers]>=7.1.0
+Requires-Dist: python-dateutil>=2.9.0
+Requires-Dist: drf-extra-fields>=3.4.0
+Requires-Dist: jsonschema>=4.0.0
+Requires-Dist: pydantic<3,>=2
+Provides-Extra: export-xlsx
+Requires-Dist: openpyxl>=3.1; extra == "export-xlsx"
+Dynamic: license-file
+
+# habarico
+
+Habarico is a schema-driven admin library for Django REST Framework. It turns Django models into a
+complete admin API: REST endpoints plus JSON schemas describing resources, fields, views and
+actions. The [React frontend](https://docs.habarico.com/node/intro) renders the whole admin UI from
+those schemas — no screen is written per resource.
+
+## Installation
+
+```bash
+pip install habarico
+```
+
+Add the app to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    ...,
+    "phonenumber_field",  # required for phone number field localization
+    "habarico",
+    "rest_framework",  # after habarico, which overrides its localization
+    ...
+]
+```
+
+And mount the admin site in `urls.py`:
+
+```python
+from django.urls import include, path
+from habarico import site
+
+urlpatterns = [
+    path("admin/", include(site.urls)),
+]
+```
+
+## Quick start
+
+```python
+# admin.py
+from habarico import ModelAdmin
+
+from .models import Product
+
+
+class ProductAdmin(ModelAdmin):
+    model = Product
+    fields = ["name", "sku", "description", "status", "category", "price", "stock"]
+    read_only_fields = ["created_at"]
+    search_fields = ["name", "description"]
+    filter_fields = ["status", "category", "price"]
+    ordering_fields = ["name", "price"]
+    can_create = True
+    can_update = True
+```
+
+Importing the module registers the admin — that is a full CRUD resource: a list with filters and
+sorting, a detail page, a create and an edit form.
+
+## Documentation
+
+Full documentation is at **[docs.habarico.com/python](https://docs.habarico.com/python/intro)** —
+this file is only a quick start.
+
+| Section | What it covers |
+| --- | --- |
+| [Installation](https://docs.habarico.com/python/installation) and [configuration](https://docs.habarico.com/python/configuration) | Settings, permissions and authentication classes |
+| [Basic usage](https://docs.habarico.com/python/basic-usage/) | Fields, permissions, custom serializers and viewsets, configuration validation |
+| [View generators](https://docs.habarico.com/python/view-generators/) | Shaping the list, detail and form views |
+| [Filtering and searching](https://docs.habarico.com/python/filtering-and-searching/) | Filters, ordering and fulltext search |
+| [Aggregations](https://docs.habarico.com/python/aggregations/) and [dashboard](https://docs.habarico.com/python/dashboard) | The `/aggregate` endpoint and the widgets built on it |
+| [Chunked uploads](https://docs.habarico.com/python/chunked-uploads/) | Large files over TUS or S3 multipart |
+| [AI integration](https://docs.habarico.com/python/ai-integration/) | Predictive fields and the assistant endpoints |
+| [User preferences](https://docs.habarico.com/python/user-preferences/) | The per-user preference store the frontend syncs to |
+| [Complete example](https://docs.habarico.com/python/complete-example) | One resource wired up end to end |
+
+The frontend consuming these schemas is documented at
+[docs.habarico.com/node](https://docs.habarico.com/node/intro), and the contract between them is
+the [API reference](https://docs.habarico.com/api).
+
+## License
+
+[MIT](LICENSE)

habarico-7.2.0/README.md

@@ -0,0 +1,83 @@
+# habarico
+
+Habarico is a schema-driven admin library for Django REST Framework. It turns Django models into a
+complete admin API: REST endpoints plus JSON schemas describing resources, fields, views and
+actions. The [React frontend](https://docs.habarico.com/node/intro) renders the whole admin UI from
+those schemas — no screen is written per resource.
+
+## Installation
+
+```bash
+pip install habarico
+```
+
+Add the app to `INSTALLED_APPS`:
+
+```python
+INSTALLED_APPS = [
+    ...,
+    "phonenumber_field",  # required for phone number field localization
+    "habarico",
+    "rest_framework",  # after habarico, which overrides its localization
+    ...
+]
+```
+
+And mount the admin site in `urls.py`:
+
+```python
+from django.urls import include, path
+from habarico import site
+
+urlpatterns = [
+    path("admin/", include(site.urls)),
+]
+```
+
+## Quick start
+
+```python
+# admin.py
+from habarico import ModelAdmin
+
+from .models import Product
+
+
+class ProductAdmin(ModelAdmin):
+    model = Product
+    fields = ["name", "sku", "description", "status", "category", "price", "stock"]
+    read_only_fields = ["created_at"]
+    search_fields = ["name", "description"]
+    filter_fields = ["status", "category", "price"]
+    ordering_fields = ["name", "price"]
+    can_create = True
+    can_update = True
+```
+
+Importing the module registers the admin — that is a full CRUD resource: a list with filters and
+sorting, a detail page, a create and an edit form.
+
+## Documentation
+
+Full documentation is at **[docs.habarico.com/python](https://docs.habarico.com/python/intro)** —
+this file is only a quick start.
+
+| Section | What it covers |
+| --- | --- |
+| [Installation](https://docs.habarico.com/python/installation) and [configuration](https://docs.habarico.com/python/configuration) | Settings, permissions and authentication classes |
+| [Basic usage](https://docs.habarico.com/python/basic-usage/) | Fields, permissions, custom serializers and viewsets, configuration validation |
+| [View generators](https://docs.habarico.com/python/view-generators/) | Shaping the list, detail and form views |
+| [Filtering and searching](https://docs.habarico.com/python/filtering-and-searching/) | Filters, ordering and fulltext search |
+| [Aggregations](https://docs.habarico.com/python/aggregations/) and [dashboard](https://docs.habarico.com/python/dashboard) | The `/aggregate` endpoint and the widgets built on it |
+| [Chunked uploads](https://docs.habarico.com/python/chunked-uploads/) | Large files over TUS or S3 multipart |
+| [AI integration](https://docs.habarico.com/python/ai-integration/) | Predictive fields and the assistant endpoints |
+| [User preferences](https://docs.habarico.com/python/user-preferences/) | The per-user preference store the frontend syncs to |
+| [Complete example](https://docs.habarico.com/python/complete-example) | One resource wired up end to end |
+
+The frontend consuming these schemas is documented at
+[docs.habarico.com/node](https://docs.habarico.com/node/intro), and the contract between them is
+the [API reference](https://docs.habarico.com/api).
+
+## License
+
+[MIT](LICENSE)

habarico-7.2.0/pyproject.toml

@@ -0,0 +1,69 @@
+[project]
+name = "habarico"
+version = "7.2.0"
+description = "Habarico REST admin Django library"
+keywords = [
+    "package",
+    "django",
+    "admin",
+    "eluvia",
+    "habarico",
+]
+dependencies = [
+    "eluvia-base>=2.0.0",
+    "eluvia-base-django>=2.3.2",
+    "djangorestframework>=3.14",
+    "django>=3.0.0",
+    "django-filter>=23.1",
+    "django-phonenumber-field[phonenumbers]>=7.1.0",
+    "python-dateutil>=2.9.0",
+    "drf-extra-fields>=3.4.0",
+    "jsonschema>=4.0.0",
+    "pydantic>=2,<3",
+]
+readme = "README.md"
+requires-python = ">=3.10"
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Topic :: Software Development :: Libraries",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3 :: Only",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+[[project.authors]]
+name = "Luboš Mátl"
+email = "lubos.matl@eluvia.com"
+
+[project.optional-dependencies]
+export-xlsx = [
+    "openpyxl>=3.1",
+]
+
+[project.license]
+file = "LICENSE"
+
+[project.urls]
+Documentation = "https://docs.habarico.com/python/intro"
+"Source Code" = "https://github.com/eluvia-com/habarico"
+Changelog = "https://github.com/eluvia-com/habarico/blob/master/python/CHANGELOG.md"
+
+[tool.black]
+line-length = 120
+target-version = [
+    "py310",
+]
+
+[tool.flake8]
+max-line-length = 120
+ignore = "E203,W503"
+
+[tool.isort]
+profile = "black"
+line_length = 120
+known_third_party = [
+    "habarico",
+]

habarico-7.2.0/setup.cfg

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

habarico-7.2.0/src/habarico/__init__.py

@@ -0,0 +1,29 @@
+from django.utils.translation import gettext_lazy as _
+from django_filters.conf import DEFAULTS
+from habarico.admin import Admin
+from habarico.settings import admin_api_settings
+from habarico.site import site
+
+__all__ = [
+    "Admin",
+    "ModelAdmin",
+    "site",
+]
+
+
+def __getattr__(name):
+    # Resolved lazily via DEFAULT_MODEL_ADMIN_CLASS (habarico.settings), on first attribute
+    # access - never as a module-level assignment. Django imports this package while iterating
+    # INSTALLED_APPS during AppConfig.create(), before apps.apps_ready is set, so an eager
+    # assignment here would force-import whatever dependency graph the configured class (core or
+    # a pro/enterprise override) pulls in at that moment - see HAB-852, where
+    # habarico_enterprise.admin.ModelAdmin's import chain reached DRF's schema machinery and
+    # crashed with AppRegistryNotReady. Admin and site stay eager imports above: Admin is shallow
+    # and core-only, and site.py itself defers building its DEFAULT_ADMIN_SITE_CLASS singleton the
+    # same way (see habarico.site._build_site) - importing the *module* here is cheap.
+    if name == "ModelAdmin":
+        return admin_api_settings.DEFAULT_MODEL_ADMIN_CLASS
+    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")
+
+
+DEFAULTS["VERBOSE_LOOKUPS"]["in"] = _("list")