django-reportcraft 2025.3.20__tar.gz

django_reportcraft-2025.3.20/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Michel 4J
+
+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_reportcraft-2025.3.20/PKG-INFO

@@ -0,0 +1,99 @@
+Metadata-Version: 2.3
+Name: django-reportcraft
+Version: 2025.3.20
+Summary: A Django reusable App for dynamically designing and generating reports.
+License: MIT
+Author: Michel Fodje
+Author-email: michel4j@gmail.com
+Requires-Python: >=3.10
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
+Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Dist: django (>=4.2.20,<6.0.0)
+Requires-Dist: django-crisp-modals (>=2025.3.29,<2026.0.0)
+Requires-Dist: django-itemlist (>=2025.3.11,<2026.0.0)
+Requires-Dist: numpy (>=2.2.4,<3.0.0)
+Requires-Dist: pygments (>=2.19.1,<3.0.0)
+Requires-Dist: pyparsing (>=3.2.1,<4.0.0)
+Project-URL: Documentation, https://michel4j.github.io/django-reportcraft/
+Project-URL: Homepage, https://github.com/michel4j/django-reportcraft
+Project-URL: Issues, https://github.com/michel4j/django-reportcraft/issues
+Description-Content-Type: text/markdown
+
+# Django ReportCraft
+A Django reusable App for dynamically designing and generating data visualization and 
+business intelligence reports
+
+## Summary of Features
+
+### Report Creation
+- Create and manage reports through a graphical designer.
+- Easily add new report entries using the intuitive interface.
+
+### Data Sources & Models
+- **Data Sources:** Configure models that provide data for reports.  
+  - Define the data source name, grouping fields, and record limit.
+- **Data Source Models:**  
+  - Add models to a data source.
+  - Specify group expressions for data aggregation.
+
+### Data Fields & Expressions
+- Configure fields with attributes such as name, label, default value, and precision.
+- **Expressions:**  
+  - Use arithmetic operators (`+`, `-`, `*`, `/`, unary negation).
+  - Reference Django field names using CamelCase and related fields with the `.` operator.
+  - Group and nest expressions using parentheses.
+  - Use string literals enclosed in quotes.
+- **Supported Functions:**  
+  - Django database functions (e.g., `Sum`, `Avg`, `Count`, etc.)
+  - Custom functions (e.g., `ShiftStart`, `ShiftEnd`, `Hours`, `Minutes`, `DisplayName`).
+
+### Report Entry Types & Configurations
+- **Table Entry:**  
+  - Configure rows, columns, values, column totals, row totals, and transpose option.
+- **Bar Chart Entry:**  
+  - Set the X-axis and one or more Y-axis fields.
+  - Options for sorting, color schemes, stacking, label wrapping, and orientation.
+- **Pie Chart Entry:**  
+  - Define value and label fields for pie slices with color customization.
+- **XY Plot Entry:**  
+  - Configure dual Y-axes for left (Y1) and right (Y2).
+  - Supports both line and scatter plot options.
+- **List Entry:**  
+  - Define multiple columns with sorting and ordering features.
+- **Histogram Entry:**  
+  - Choose a numeric field, configure the number of bins, and select a color scheme.
+- **Text & Rich Text Entries:**  
+  - Display plain text or markdown formatted rich text.
+
+### Demo Application
+A demo site showcasing an example configuration of various features is available in the repository. After cloning
+the repository,
+
+    ```bash
+    poetry install
+    ./manage.py migrate
+    ./manage.py createsuperuser
+    ./manage.py runserver
+ 
+ Open the browser to http://localhost:8000/admin and log in with the superuser credentials created in the previous step.
+ Click the "View Site" link in the top right corner of the page to access the main page, also accessible 
+ from http://localhost:8000.
+ 
+### Documentation
+Detailed documentation and screenshots are available at https://michel4j.github.io/django-reportcraft/. 

django_reportcraft-2025.3.20/README.md

@@ -0,0 +1,62 @@
+# Django ReportCraft
+A Django reusable App for dynamically designing and generating data visualization and 
+business intelligence reports
+
+## Summary of Features
+
+### Report Creation
+- Create and manage reports through a graphical designer.
+- Easily add new report entries using the intuitive interface.
+
+### Data Sources & Models
+- **Data Sources:** Configure models that provide data for reports.  
+  - Define the data source name, grouping fields, and record limit.
+- **Data Source Models:**  
+  - Add models to a data source.
+  - Specify group expressions for data aggregation.
+
+### Data Fields & Expressions
+- Configure fields with attributes such as name, label, default value, and precision.
+- **Expressions:**  
+  - Use arithmetic operators (`+`, `-`, `*`, `/`, unary negation).
+  - Reference Django field names using CamelCase and related fields with the `.` operator.
+  - Group and nest expressions using parentheses.
+  - Use string literals enclosed in quotes.
+- **Supported Functions:**  
+  - Django database functions (e.g., `Sum`, `Avg`, `Count`, etc.)
+  - Custom functions (e.g., `ShiftStart`, `ShiftEnd`, `Hours`, `Minutes`, `DisplayName`).
+
+### Report Entry Types & Configurations
+- **Table Entry:**  
+  - Configure rows, columns, values, column totals, row totals, and transpose option.
+- **Bar Chart Entry:**  
+  - Set the X-axis and one or more Y-axis fields.
+  - Options for sorting, color schemes, stacking, label wrapping, and orientation.
+- **Pie Chart Entry:**  
+  - Define value and label fields for pie slices with color customization.
+- **XY Plot Entry:**  
+  - Configure dual Y-axes for left (Y1) and right (Y2).
+  - Supports both line and scatter plot options.
+- **List Entry:**  
+  - Define multiple columns with sorting and ordering features.
+- **Histogram Entry:**  
+  - Choose a numeric field, configure the number of bins, and select a color scheme.
+- **Text & Rich Text Entries:**  
+  - Display plain text or markdown formatted rich text.
+
+### Demo Application
+A demo site showcasing an example configuration of various features is available in the repository. After cloning
+the repository,
+
+    ```bash
+    poetry install
+    ./manage.py migrate
+    ./manage.py createsuperuser
+    ./manage.py runserver
+ 
+ Open the browser to http://localhost:8000/admin and log in with the superuser credentials created in the previous step.
+ Click the "View Site" link in the top right corner of the page to access the main page, also accessible 
+ from http://localhost:8000.
+ 
+### Documentation
+Detailed documentation and screenshots are available at https://michel4j.github.io/django-reportcraft/. 

django_reportcraft-2025.3.20/pyproject.toml

@@ -0,0 +1,66 @@
+[project]
+name = "django-reportcraft"
+description = "A Django reusable App for dynamically designing and generating reports."
+authors = [
+    {name = "Michel Fodje",email = "michel4j@gmail.com"}
+]
+license = "MIT"
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "django (>=4.2.20,<6.0.0)",
+    "django-crisp-modals (>=2025.3.29,<2026.0.0)",
+    "django-itemlist (>=2025.3.11,<2026.0.0)",
+    "pyparsing (>=3.2.1,<4.0.0)",
+    "pygments (>=2.19.1,<3.0.0)",
+    "numpy (>=2.2.4,<3.0.0)",
+]
+classifiers = [
+    "Environment :: Web Environment",
+    "Framework :: Django",
+    "Framework :: Django :: 4.2",
+    "Framework :: Django :: 5.0",
+    "Framework :: Django :: 5.1",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+    "Topic :: Internet :: WWW/HTTP :: Dynamic Content",
+    "Topic :: Software Development :: Libraries :: Application Frameworks",
+    "Topic :: Software Development :: Libraries :: Python Modules"
+]
+dynamic = []
+version = "2025.3.20"
+
+[project.urls]
+Homepage = "https://github.com/michel4j/django-reportcraft"
+Issues = "https://github.com/michel4j/django-reportcraft/issues"
+Documentation = "https://michel4j.github.io/django-reportcraft/"
+
+[tool.poetry]
+packages = [
+    { include = "reportcraft", from = "." },
+]
+
+[build-system]
+requires = ["poetry-core>=2.0.0,<3.0.0", "poetry-dynamic-versioning>=1.0.0,<2.0.0"]
+build-backend = "poetry_dynamic_versioning.backend"
+
+[tool.poetry.group.dev.dependencies]
+Sphinx = ">=4.2.0"
+sphinx-rtd-theme = ">=1.0.0"
+sphinxcontrib-napoleon = ">=0.7"
+
+[tool.poetry.requires-plugins]
+poetry-dynamic-versioning = { version = ">=1.0.0,<2.0.0", extras = ["plugin"] }
+
+[tool.poetry-dynamic-versioning]
+enable = false
+vcs = "git"
+format = "{base}.{revision}{distance}"

django_reportcraft-2025.3.20/reportcraft/admin.py

@@ -0,0 +1,10 @@
+from django.contrib import admin
+from . import models
+
+
+admin.site.register(models.DataModel)
+admin.site.register(models.DataSource)
+admin.site.register(models.DataField)
+admin.site.register(models.Report)
+admin.site.register(models.Entry)
+

django_reportcraft-2025.3.20/reportcraft/apps.py

@@ -0,0 +1,15 @@
+from django.apps import AppConfig
+
+
+class ReportsConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'reportcraft'
+
+    def ready(self):
+        from django.conf import settings
+        settings = settings._wrapped.__dict__
+        settings.setdefault('REPORTCRAFT_APPS', [])
+        settings.setdefault('REPORTCRAFT_MIXINS', {
+            'VIEW': [],
+            'EDIT': ['django.contrib.auth.mixins.LoginRequiredMixin'],
+        })