django-virtualqueryset 0.1.0__tar.gz

django_virtualqueryset-0.1.0/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2025 Hicinformatic
+
+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.
+

django_virtualqueryset-0.1.0/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: django-virtualqueryset
+Version: 0.1.0
+Summary: Django library for QuerySet-like objects not backed by a database
+Author-email: Hicinformatic <hicinformatic@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/hicinformatic/django-virtualqueryset
+Project-URL: Repository, https://github.com/hicinformatic/django-virtualqueryset
+Project-URL: Documentation, https://github.com/hicinformatic/django-virtualqueryset#readme
+Project-URL: Issues, https://github.com/hicinformatic/django-virtualqueryset/issues
+Keywords: django,queryset,virtual-queryset,virtual-model,in-memory,api-queryset,json-queryset,django-orm,python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 3.2
+Classifier: Framework :: Django :: 4.0
+Classifier: Framework :: Django :: 4.1
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=3.2
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3; extra == "dev"
+Requires-Dist: pytest-django>=4.5; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: django-stubs>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# django-virtualqueryset
+
+Django library for creating QuerySet-like objects that are not backed by a database.
+
+This is a minimal Django library ready for migration of existing tools.
+
+## Purpose
+
+Create virtual QuerySets for:
+- Data from external APIs
+- In-memory computed data
+- Configuration/settings as models
+- Read-only models without database tables
+
+## Installation
+
+```bash
+pip install django-virtualqueryset
+```
+
+## Quick Start
+
+```python
+INSTALLED_APPS = [
+    ...
+    'virtualqueryset',
+]
+```
+
+## Development
+
+```bash
+python dev.py venv
+python dev.py install-dev
+python dev.py migrate
+python dev.py test
+```
+
+## License
+
+MIT
+

django_virtualqueryset-0.1.0/README.md

@@ -0,0 +1,42 @@
+# django-virtualqueryset
+
+Django library for creating QuerySet-like objects that are not backed by a database.
+
+This is a minimal Django library ready for migration of existing tools.
+
+## Purpose
+
+Create virtual QuerySets for:
+- Data from external APIs
+- In-memory computed data
+- Configuration/settings as models
+- Read-only models without database tables
+
+## Installation
+
+```bash
+pip install django-virtualqueryset
+```
+
+## Quick Start
+
+```python
+INSTALLED_APPS = [
+    ...
+    'virtualqueryset',
+]
+```
+
+## Development
+
+```bash
+python dev.py venv
+python dev.py install-dev
+python dev.py migrate
+python dev.py test
+```
+
+## License
+
+MIT
+

django_virtualqueryset-0.1.0/pyproject.toml

@@ -0,0 +1,84 @@
+[build-system]
+requires = ["setuptools>=61.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "django-virtualqueryset"
+version = "0.1.0"
+description = "Django library for QuerySet-like objects not backed by a database"
+readme = "README.md"
+authors = [{ name = "Hicinformatic", email = "hicinformatic@gmail.com" }]
+license = { text = "MIT" }
+requires-python = ">=3.10"
+keywords = [
+    "django",
+    "queryset",
+    "virtual-queryset",
+    "virtual-model",
+    "in-memory",
+    "api-queryset",
+    "json-queryset",
+    "django-orm",
+    "python",
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Framework :: Django",
+    "Framework :: Django :: 3.2",
+    "Framework :: Django :: 4.0",
+    "Framework :: Django :: 4.1",
+    "Framework :: Django :: 4.2",
+    "Framework :: Django :: 5.0",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+]
+dependencies = [
+    "Django>=3.2",
+]
+
+[project.urls]
+Homepage = "https://github.com/hicinformatic/django-virtualqueryset"
+Repository = "https://github.com/hicinformatic/django-virtualqueryset"
+Documentation = "https://github.com/hicinformatic/django-virtualqueryset#readme"
+Issues = "https://github.com/hicinformatic/django-virtualqueryset/issues"
+
+[project.optional-dependencies]
+dev = [
+    "pytest>=8.3",
+    "pytest-django>=4.5",
+    "ruff>=0.5",
+    "mypy>=1.0",
+    "django-stubs>=5.0.0",
+]
+
+[tool.setuptools]
+license-files = ["LICENSE"]
+
+[tool.setuptools.packages.find]
+where = ["src"]
+include = ["virtualqueryset*"]
+exclude = ["tests*"]
+
+[tool.pytest.ini_options]
+DJANGO_SETTINGS_MODULE = "tests.settings"
+testpaths = ["tests"]
+pythonpath = ["src"]
+
+[tool.mypy]
+python_version = "3.10"
+warn_return_any = true
+plugins = ["mypy_django_plugin.main"]
+
+[tool.django-stubs]
+django_settings_module = "tests.settings"
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"
+

django_virtualqueryset-0.1.0/setup.cfg

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

django_virtualqueryset-0.1.0/src/django_virtualqueryset.egg-info/PKG-INFO

@@ -0,0 +1,80 @@
+Metadata-Version: 2.4
+Name: django-virtualqueryset
+Version: 0.1.0
+Summary: Django library for QuerySet-like objects not backed by a database
+Author-email: Hicinformatic <hicinformatic@gmail.com>
+License: MIT
+Project-URL: Homepage, https://github.com/hicinformatic/django-virtualqueryset
+Project-URL: Repository, https://github.com/hicinformatic/django-virtualqueryset
+Project-URL: Documentation, https://github.com/hicinformatic/django-virtualqueryset#readme
+Project-URL: Issues, https://github.com/hicinformatic/django-virtualqueryset/issues
+Keywords: django,queryset,virtual-queryset,virtual-model,in-memory,api-queryset,json-queryset,django-orm,python
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 3.2
+Classifier: Framework :: Django :: 4.0
+Classifier: Framework :: Django :: 4.1
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: Django>=3.2
+Provides-Extra: dev
+Requires-Dist: pytest>=8.3; extra == "dev"
+Requires-Dist: pytest-django>=4.5; extra == "dev"
+Requires-Dist: ruff>=0.5; extra == "dev"
+Requires-Dist: mypy>=1.0; extra == "dev"
+Requires-Dist: django-stubs>=5.0.0; extra == "dev"
+Dynamic: license-file
+
+# django-virtualqueryset
+
+Django library for creating QuerySet-like objects that are not backed by a database.
+
+This is a minimal Django library ready for migration of existing tools.
+
+## Purpose
+
+Create virtual QuerySets for:
+- Data from external APIs
+- In-memory computed data
+- Configuration/settings as models
+- Read-only models without database tables
+
+## Installation
+
+```bash
+pip install django-virtualqueryset
+```
+
+## Quick Start
+
+```python
+INSTALLED_APPS = [
+    ...
+    'virtualqueryset',
+]
+```
+
+## Development
+
+```bash
+python dev.py venv
+python dev.py install-dev
+python dev.py migrate
+python dev.py test
+```
+
+## License
+
+MIT
+

django_virtualqueryset-0.1.0/src/django_virtualqueryset.egg-info/SOURCES.txt

@@ -0,0 +1,20 @@
+LICENSE
+README.md
+pyproject.toml
+src/django_virtualqueryset.egg-info/PKG-INFO
+src/django_virtualqueryset.egg-info/SOURCES.txt
+src/django_virtualqueryset.egg-info/dependency_links.txt
+src/django_virtualqueryset.egg-info/requires.txt
+src/django_virtualqueryset.egg-info/top_level.txt
+src/virtualqueryset/__init__.py
+src/virtualqueryset/admin.py
+src/virtualqueryset/apps.py
+src/virtualqueryset/managers.py
+src/virtualqueryset/models.py
+src/virtualqueryset/queryset/__init__.py
+src/virtualqueryset/queryset/api.py
+src/virtualqueryset/queryset/base.py
+src/virtualqueryset/queryset/cached.py
+src/virtualqueryset/queryset/config.py
+src/virtualqueryset/queryset/json_qs.py
+tests/test_base_queryset.py

django_virtualqueryset-0.1.0/src/django_virtualqueryset.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

django_virtualqueryset-0.1.0/src/django_virtualqueryset.egg-info/requires.txt

@@ -0,0 +1,8 @@
+Django>=3.2
+
+[dev]
+pytest>=8.3
+pytest-django>=4.5
+ruff>=0.5
+mypy>=1.0
+django-stubs>=5.0.0

django_virtualqueryset-0.1.0/src/django_virtualqueryset.egg-info/top_level.txt

@@ -0,0 +1 @@
+virtualqueryset

django_virtualqueryset-0.1.0/src/virtualqueryset/__init__.py

@@ -0,0 +1,39 @@
+"""Django VirtualQuerySet - QuerySet-like objects not backed by a database."""
+
+__version__ = "0.1.0"
+
+default_app_config = "virtualqueryset.apps.VirtualQuerySetConfig"
+
+# QuerySets can be imported at module level
+from .queryset.base import InMemoryQuerySet
+from .queryset.config import ConfigQuerySet
+from .queryset.api import APIQuerySet
+from .queryset.json_qs import JSONQuerySet
+from .queryset.cached import CachedQuerySet
+
+# Managers can be imported at module level
+from .managers import (
+    VirtualManager,
+    ConfigQuerySetManager,
+    APIQuerySetManager,
+    JSONQuerySetManager,
+    CachedQuerySetManager,
+)
+
+# Models should NOT be imported at module level (Django not ready yet)
+# Import them as: from virtualqueryset.models import VirtualModel
+
+__all__ = [
+    # QuerySets
+    "InMemoryQuerySet",
+    "ConfigQuerySet",
+    "APIQuerySet",
+    "JSONQuerySet",
+    "CachedQuerySet",
+    # Managers
+    "VirtualManager",
+    "ConfigQuerySetManager",
+    "APIQuerySetManager",
+    "JSONQuerySetManager",
+    "CachedQuerySetManager",
+]

django_virtualqueryset-0.1.0/src/virtualqueryset/admin.py

@@ -0,0 +1,9 @@
+"""Django admin configuration.
+
+This is a minimal placeholder. Add your admin utilities here when migrating tools.
+"""
+
+from django.contrib import admin
+
+# TODO: Add VirtualModelAdmin base class and utilities when migrating existing tools
+

django_virtualqueryset-0.1.0/src/virtualqueryset/apps.py

@@ -0,0 +1,12 @@
+"""Django app configuration."""
+
+from django.apps import AppConfig
+
+
+class VirtualQuerySetConfig(AppConfig):
+    """Configuration for the virtualqueryset app."""
+
+    default_auto_field = "django.db.models.BigAutoField"
+    name = "virtualqueryset"
+    verbose_name = "Virtual QuerySet"
+

django_virtualqueryset-0.1.0/src/virtualqueryset/managers.py

@@ -0,0 +1,167 @@
+"""Managers for virtual models."""
+
+from typing import Any, Callable, List, Optional
+
+from django.db import models
+
+from .queryset.base import InMemoryQuerySet
+from .queryset.config import ConfigQuerySet
+from .queryset.api import APIQuerySet
+from .queryset.json_qs import JSONQuerySet
+from .queryset.cached import CachedQuerySet
+
+
+class VirtualManager(models.Manager):
+    """Base manager for virtual models (no database).
+
+    Subclass and override get_data() to provide data source.
+
+    Example:
+        class MyVirtualModel(models.Model):
+            name = models.CharField(max_length=255)
+            
+            objects = MyCustomManager()
+            
+            class Meta:
+                managed = False
+    """
+
+    queryset_class = InMemoryQuerySet
+
+    def get_queryset(self):
+        """Return queryset with data from get_data()."""
+        data = self.get_data()
+        return self.queryset_class(model=self.model, data=data)
+
+    def get_data(self) -> List[Any]:
+        """Override this method to provide data source.
+
+        Returns:
+            List of model instances or dictionaries
+        """
+        return []
+
+
+class ConfigQuerySetManager(VirtualManager):
+    """Manager that loads data from Django settings.
+
+    Args:
+        setting_name: Name of Django setting to load
+    """
+
+    queryset_class = ConfigQuerySet
+
+    def __init__(self, setting_name: str):
+        """Initialize with setting name.
+
+        Args:
+            setting_name: Django setting name (e.g., 'INSTALLED_APPS')
+        """
+        super().__init__()
+        self.setting_name = setting_name
+
+    def get_queryset(self):
+        """Return queryset with data from Django setting."""
+        return self.queryset_class(
+            model=self.model, setting_name=self.setting_name
+        )
+
+
+class APIQuerySetManager(VirtualManager):
+    """Manager that loads data from external API.
+
+    Args:
+        fetch_func: Callable that fetches data from API
+        cache_timeout: Cache duration in seconds
+    """
+
+    queryset_class = APIQuerySet
+
+    def __init__(self, fetch_func: Callable, cache_timeout: int = 300):
+        """Initialize with API fetch function.
+
+        Args:
+            fetch_func: Callable that returns list of data
+            cache_timeout: Cache duration in seconds (default: 5 minutes)
+        """
+        super().__init__()
+        self.fetch_func = fetch_func
+        self.cache_timeout = cache_timeout
+
+    def get_queryset(self):
+        """Return queryset with data from API."""
+        return self.queryset_class(
+            model=self.model,
+            fetch_func=self.fetch_func,
+            cache_timeout=self.cache_timeout,
+        )
+
+
+class JSONQuerySetManager(VirtualManager):
+    """Manager that loads data from JSON source.
+
+    Args:
+        json_source: Path to JSON file or JSON string
+        json_path: Optional JSONPath to extract nested data
+    """
+
+    queryset_class = JSONQuerySet
+
+    def __init__(self, json_source, json_path: Optional[str] = None):
+        """Initialize with JSON source.
+
+        Args:
+            json_source: Path to file, JSON string, or dict
+            json_path: Optional path to nested data (e.g., 'results.items')
+        """
+        super().__init__()
+        self.json_source = json_source
+        self.json_path = json_path
+
+    def get_queryset(self):
+        """Return queryset with data from JSON."""
+        return self.queryset_class(
+            model=self.model,
+            json_source=self.json_source,
+            json_path=self.json_path,
+        )
+
+
+class CachedQuerySetManager(VirtualManager):
+    """Manager with caching support.
+
+    Args:
+        fetch_func: Callable that fetches data
+        cache_key: Unique cache key
+        cache_timeout: Cache duration in seconds
+    """
+
+    queryset_class = CachedQuerySet
+
+    def __init__(
+        self,
+        fetch_func: Callable,
+        cache_key: Optional[str] = None,
+        cache_timeout: int = 3600,
+    ):
+        """Initialize with caching configuration.
+
+        Args:
+            fetch_func: Callable that returns data
+            cache_key: Unique cache key (auto-generated if None)
+            cache_timeout: Cache duration in seconds (default: 1 hour)
+        """
+        super().__init__()
+        self.fetch_func = fetch_func
+        self.cache_key = cache_key
+        self.cache_timeout = cache_timeout
+
+    def get_queryset(self):
+        """Return queryset with caching."""
+        return self.queryset_class(
+            model=self.model,
+            fetch_func=self.fetch_func,
+            cache_key=self.cache_key,
+            cache_timeout=self.cache_timeout,
+        )
+

django_virtualqueryset-0.1.0/src/virtualqueryset/models.py

@@ -0,0 +1,75 @@
+"""Base models for virtual models."""
+
+from django.db import models
+
+
+class VirtualModel(models.Model):
+    """Base class for virtual models (no database table).
+
+    Virtual models behave like Django models but don't have database tables.
+    They use in-memory QuerySets to display data from external sources.
+
+    Features:
+    - No migrations created
+    - No database queries
+    - Compatible with Django admin
+    - Read-only by default
+
+    Example:
+        class ConfigSetting(VirtualModel):
+            key = models.CharField(max_length=255)
+            value = models.TextField()
+            
+            objects = ConfigQuerySetManager('MY_SETTINGS')
+            
+            def __str__(self):
+                return self.key
+    """
+
+    class Meta:
+        abstract = True
+        managed = False
+
+    def save(self, *args, **kwargs):
+        """Prevent saving virtual models.
+
+        Override in subclass if you want to implement custom save logic
+        (e.g., saving to API, file, cache).
+        """
+        raise NotImplementedError(
+            f"{self.__class__.__name__} is a virtual model and cannot be saved to database. "
+            "Override save() if you want to implement custom persistence."
+        )
+
+    def delete(self, *args, **kwargs):
+        """Prevent deleting virtual models.
+
+        Override in subclass if you want to implement custom delete logic.
+        """
+        raise NotImplementedError(
+            f"{self.__class__.__name__} is a virtual model and cannot be deleted from database. "
+            "Override delete() if you want to implement custom deletion."
+        )
+
+
+class ReadOnlyVirtualModel(VirtualModel):
+    """Virtual model that is explicitly read-only.
+
+    Similar to VirtualModel but with more descriptive error messages.
+    """
+
+    class Meta:
+        abstract = True
+        managed = False
+
+    def save(self, *args, **kwargs):
+        """Read-only models cannot be saved."""
+        raise NotImplementedError(
+            f"{self.__class__.__name__} is read-only and cannot be modified."
+        )
+
+    def delete(self, *args, **kwargs):
+        """Read-only models cannot be deleted."""
+        raise NotImplementedError(
+            f"{self.__class__.__name__} is read-only and cannot be deleted."
+        )

django_virtualqueryset-0.1.0/src/virtualqueryset/queryset/__init__.py

@@ -0,0 +1,16 @@
+"""QuerySet implementations for virtual models."""
+
+from .base import InMemoryQuerySet
+from .config import ConfigQuerySet
+from .api import APIQuerySet
+from .json_qs import JSONQuerySet
+from .cached import CachedQuerySet
+
+__all__ = [
+    "InMemoryQuerySet",
+    "ConfigQuerySet",
+    "APIQuerySet",
+    "JSONQuerySet",
+    "CachedQuerySet",
+]
+