v0.8.0

README.md

@@ -31,8 +31,11 @@ Created and developed by [Miguel Sanda](https://www.miguelsanda.com).
 
 ## Getting Involved
 
-All pull requests are welcome, as long as they address bugfixes, enhancements, new ideas, or add value to the project in any shape or form.
-Please refrain from submitting pull requests that focus solely on code linting, refactoring, or similar cosmetic changes.
+All pull requests are welcome, as long as they address bugfixes, enhancements, new ideas, or add value to the project in
+any shape or form.
+
+Please refrain from submitting pull requests that focus solely on code linting, auto-generated code,
+refactoring, or similar cosmetic non-value add changes.
 
 - **Feature Requests/Bug Reports**: Open an issue in the repository
 - **For software customization, advanced features and consulting services**:
@@ -59,56 +62,12 @@ is [here](https://docs.djangoproject.com/en/4.2/intro/tutorial01/#creating-a-pro
 Make sure you refer to the django version you are using.
 
 The easiest way to start is to use the zero-config Django Ledger starter template. See
-details [here](https://github.com/arrobalytics/django-ledger-starter). Otherwise, you may create your
-project from scratch.
-
-To create a new Django Ledger project:
-
-* Make sure you have the latest version of python [here](https://www.python.org/) (recommended).
-
-* Install Django:
-
-```shell
-pip install django
-```
-
-* Install Python [Pipenv](https://pipenv.pypa.io/en/latest/) (python package manager):
-
-```shell script
-pip install pipenv
-```
+details [here](https://github.com/arrobalytics/django-ledger-starter).
+Otherwise, you may create your project from scratch.
 
-* Go to your desired development folder and create a new django project:
+## Adding Django Ledger to an existing project.
 
-```shell
-django-admin startproject django_ledger_project && cd django_ledger_project
-```
-
-* Install Django on you virtual environment.
-
-```shell
-pipenv install django
-```
-
-* Install Django Ledger
-
-```shell script
-pipenv install "django-ledger[graphql,pdf]"
-```
-
-Alternatively, you can use:
-
-```shell script
-pipenv install django-ledger\[graphql,pdf\]
-```
-
-* Activate your new virtual environment:
-
-```shell
-pipenv shell
-```
-
-* Add django_ledger to INSTALLED_APPS in you new Django Project.
+### Add django_ledger to INSTALLED_APPS in you new Django Project.
 
 ```python
 INSTALLED_APPS = [
@@ -118,16 +77,25 @@ INSTALLED_APPS = [
 ]
 ```
 
-* Perform database migrations:
+### Add Django Ledger Context Preprocessor
 
-```shell
-python manage.py migrate
+```python
+TEMPLATES = [
+    {
+        'OPTIONS': {
+            'context_processors': [
+                '...',
+                'django_ledger.context.django_ledger_context'  # Add this line to a context_processors list..
+            ],
+        },
+    },
+]
 ```
 
-* Add Django SuperUser and follow the prompts.
+### Perform database migrations:
 
 ```shell
-python manage.py createsuperuser
+python manage.py migrate
 ```
 
 * Add URLs to your project's __urls.py__:
@@ -142,7 +110,7 @@ urlpatterns = [
 ]
 ```
 
-* Run your project:
+### Run your project:
 
 ```shell
 python manage.py runserver
@@ -153,7 +121,15 @@ python manage.py runserver
   if you followed this installation guide).
 * Use your superuser credentials to login.
 
-# How To Set Up Django Ledger for Development
+## Deprecated behavior setting (v0.8.0+)
+
+Starting with version v0.8.0, Django Ledger introduces the DJANGO_LEDGER_USE_DEPRECATED_BEHAVIOR setting to control
+access to deprecated features and legacy behaviors.
+
+- Default: False (deprecated features are disabled by default)
+- To temporarily keep using deprecated features while you transition, set this to True in your Django settings.
+
+## Setting Up Django Ledger for Development
 
 Django Ledger comes with a basic development environment already configured under __dev_env/__ folder not to be used
 for production environments. If you want to contribute to the project perform the following steps:

assets/package.json

@@ -3,27 +3,29 @@
     "@types/lodash": "^4.17.16",
     "@vue/compiler-sfc": "^3.5.13",
     "animate.css": "^4.1.1",
-    "axios": "^1.9.0",
+    "axios": "^1.11.0",
     "bulma": "^1.0.4",
+    "bulmaswatch": "^0.8.1",
     "chart.js": "^4.4.9",
     "iconify-icon": "^2.3.0",
-    "json-schema": "^0.4.0",
     "pikaday": "^1.8.2",
+    "moment": "^2.30.1",
     "scss-tokenizer": "^0.4.3",
     "trim-newlines": "^4.1.1",
     "vue": "^3.5.13",
-    "vue-loader": "^17.4.2"
+    "vue-loader": "^17.4.2",
+    "less": "^4.4.1"
   },
   "devDependencies": {
     "css-loader": "^7.1.2",
     "file-loader": "^6.2.0",
-    "less": "^4.3.0",
+    "less": "^4.4.1",
     "less-loader": "^12.3.0",
     "sass": "^1.88.0",
-    "sass-loader": "^13.3.3",
+    "sass-loader": "^16.0.5",
     "style-loader": "^4.0.0",
     "ts-loader": "^9.5.2",
-    "typescript": "^5.8.3",
+    "typescript": "^5.9.2",
     "url-loader": "^4.1.1",
     "webpack": "^5.99.8",
     "webpack-cli": "^6.0.1"