django-ledger 0.7.11__py3-none-any.whl → 0.8.0__py3-none-any.whl

django_ledger/views/data_import.py

@@ -26,12 +26,13 @@ class ImportJobModelViewBaseView(DjangoLedgerSecurityMixIn):
     def get_queryset(self):
         if self.queryset is None:
             self.queryset = ImportJobModel.objects.for_entity(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=self.request.user
-            ).order_by('-created').select_related('bank_account_model',
-                                                  'bank_account_model__entity_model',
-                                                  'bank_account_model__account_model',
-                                                  'bank_account_model__account_model__coa_model')
+                entity_model=self.AUTHORIZED_ENTITY_MODEL,
+            ).order_by('-created').select_related(
+                'bank_account_model',
+                'bank_account_model__entity_model',
+                'bank_account_model__account_model',
+                'bank_account_model__account_model__coa_model'
+            )
         return self.queryset
 
 

django_ledger/views/djl_api.py

@@ -73,8 +73,7 @@ class PayableNetAPIView(DjangoLedgerSecurityMixIn, EntityUnitMixIn, View):
     def get(self, request, *args, **kwargs):
         if request.user.is_authenticated:
             bill_qs = BillModel.objects.for_entity(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=request.user,
+                entity_model=self.AUTHORIZED_ENTITY_MODEL
             ).unpaid()
 
             # todo: implement this...
@@ -105,9 +104,8 @@ class ReceivableNetAPIView(DjangoLedgerSecurityMixIn, EntityUnitMixIn, View):
     def get(self, request, *args, **kwargs):
         if request.user.is_authenticated:
             invoice_qs = InvoiceModel.objects.for_entity(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=request.user,
-            ).unpaid()
+                entity_model=self.kwargs['entity_slug']
+            ).for_user(self.request.user).unpaid()
 
             # todo: implement this...
             # unit_slug = self.get_unit_slug()

django_ledger/views/entity.py

@@ -146,13 +146,11 @@ class EntityDeleteView(DjangoLedgerSecurityMixIn, EntityModelModelViewQuerySetMi
         entity_model.save(update_fields=['default_coa'])
 
         ItemTransactionModel.objects.for_entity(
-            user_model=self.request.user,
-            entity_slug=self.kwargs['entity_slug']
+            entity_model=self.AUTHORIZED_ENTITY_MODEL
         ).delete()
 
         TransactionModel.objects.for_entity(
-            user_model=self.request.user,
-            entity_slug=self.kwargs['entity_slug']
+            entity_model=self.kwargs['entity_slug']
         ).delete()
 
         return super().form_valid(form=form)

django_ledger/views/estimate.py

@@ -6,7 +6,6 @@ Contributions to this module:
     * Miguel Sanda <msanda@arrobalytics.com>
 """
 
-
 from django.contrib import messages
 from django.core.exceptions import ValidationError, ImproperlyConfigured
 from django.http import HttpResponseRedirect, HttpResponseForbidden
@@ -102,20 +101,17 @@ class EstimateModelDetailView(DjangoLedgerSecurityMixIn, EstimateModelModelViewQ
 
         # PO Model Queryset...
         po_qs = ce_model.purchaseordermodel_set.for_entity(
-            user_model=self.request.user,
-            entity_slug=self.kwargs['entity_slug']
+            entity_model=self.kwargs['entity_slug']
         ) if ce_model.is_approved() else ce_model.purchaseordermodel_set.none()
         context['estimate_po_model_queryset'] = po_qs
 
         invoice_qs = ce_model.invoicemodel_set.for_entity(
-            user_model=self.request.user,
-            entity_slug=self.kwargs['entity_slug']
+            entity_model=self.kwargs['entity_slug']
         ) if ce_model.is_approved() else ce_model.invoicemodel_set.none()
         context['estimate_invoice_model_queryset'] = invoice_qs
 
         bill_qs = ce_model.billmodel_set.for_entity(
-            user_model=self.request.user,
-            entity_slug=self.kwargs['entity_slug']
+            entity_model=self.kwargs['entity_slug']
         ) if ce_model.is_approved() else ce_model.billmodel_set.none()
         context['estimate_bill_model_queryset'] = bill_qs
 

django_ledger/views/inventory.py

@@ -51,7 +51,7 @@ class InventoryListView(DjangoLedgerSecurityMixIn, ListView):
     def get_queryset(self):
         if self.queryset is None:
             self.queryset = ItemTransactionModel.objects.inventory_pipeline_aggregate(
-                entity_slug=self.kwargs['entity_slug'],
+                entity_model=self.AUTHORIZED_ENTITY_MODEL
             )
         return super().get_queryset()
 
@@ -69,12 +69,10 @@ class InventoryRecountView(DjangoLedgerSecurityMixIn, DetailView):
         return super().get_queryset()
 
     def counted_inventory(self):
-        entity_slug = self.kwargs['entity_slug']
-        return ItemTransactionModel.objects.inventory_count(entity_slug=entity_slug)
+        return ItemTransactionModel.objects.inventory_count(entity_model=self.AUTHORIZED_ENTITY_MODEL)
 
     def recorded_inventory(self, queryset=None, as_values=True):
-        entity_model: EntityModel = self.get_object()
-        user_model = self.request.user
+        entity_model: EntityModel = self.AUTHORIZED_ENTITY_MODEL
         recorded_qs = entity_model.recorded_inventory(item_qs=queryset)
         return recorded_qs
 

django_ledger/views/invoice.py

@@ -33,8 +33,7 @@ class InvoiceModelModelViewQuerySetMixIn:
     def get_queryset(self):
         if self.queryset is None:
             self.queryset = InvoiceModel.objects.for_entity(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=self.request.user
+                entity_model=self.kwargs['entity_slug']
             ).select_related('customer', 'ledger').order_by('-created')
         return super().get_queryset()
 
@@ -97,8 +96,7 @@ class InvoiceModelCreateView(DjangoLedgerSecurityMixIn, InvoiceModelModelViewQue
                                                      'ce_pk': self.kwargs['ce_pk']
                                                  })
             estimate_qs = EstimateModel.objects.for_entity(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=self.request.user
+                entity_model=self.AUTHORIZED_ENTITY_MODEL,
             ).select_related('customer')
             estimate_model = get_object_or_404(estimate_qs, uuid__exact=self.kwargs['ce_pk'])
             context['estimate_model'] = estimate_model
@@ -138,8 +136,8 @@ class InvoiceModelCreateView(DjangoLedgerSecurityMixIn, InvoiceModelModelViewQue
         if self.for_estimate:
             ce_pk = self.kwargs['ce_pk']
             estimate_model_qs = EstimateModel.objects.for_entity(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=self.request.user)
+                entity_model=self.AUTHORIZED_ENTITY_MODEL,
+            )
 
             estimate_model = get_object_or_404(estimate_model_qs, uuid__exact=ce_pk)
             invoice_model.bind_estimate(estimate_model=estimate_model, commit=False)

django_ledger/views/item.py

@@ -21,21 +21,21 @@ from django_ledger.forms.item import (
     ExpenseItemCreateForm, ExpenseItemUpdateForm, InventoryItemCreateForm, InventoryItemUpdateForm,
     ServiceCreateForm, ServiceUpdateForm
 )
-from django_ledger.models import ItemModel, UnitOfMeasureModel, EntityModel
+from django_ledger.models import ItemModel, UnitOfMeasureModel, EntityModel, UnitOfMeasureModelQuerySet
 from django_ledger.views.mixins import DjangoLedgerSecurityMixIn
 
 
 # todo: Create delete views...
 
-# UNIT OF MEASURE VIEWS....
+# UNIT OF MEASURE VIEWS...
 class UnitOfMeasureModelModelBaseView(DjangoLedgerSecurityMixIn):
-    queryset = None
+    queryset: UnitOfMeasureModelQuerySet = None
 
     def get_queryset(self):
         if self.queryset is None:
             entity_model: EntityModel = self.get_authorized_entity_instance()
             self.queryset = entity_model.unitofmeasuremodel_set.all()
-        return super().get_queryset()
+        return self.queryset
 
 
 class UnitOfMeasureModelListView(UnitOfMeasureModelModelBaseView, ListView):
@@ -75,9 +75,7 @@ class UnitOfMeasureModelCreateView(UnitOfMeasureModelModelBaseView, CreateView):
         instance: UnitOfMeasureModel = form.save(commit=False)
         entity_slug = self.kwargs['entity_slug']
         try:
-            entity_model: EntityModel = EntityModel.objects.for_user(
-                user_model=self.request.user
-            ).get(slug__iexact=entity_slug)
+            entity_model: EntityModel = self.AUTHORIZED_ENTITY_MODEL
             instance.entity = entity_model
         except ObjectDoesNotExist:
             add_message(self.request,
@@ -227,8 +225,7 @@ class ProductUpdateView(ProductItemModelModelBaseView, UpdateView):
 
     def get_queryset(self):
         return ItemModel.objects.for_entity(
-            entity_slug=self.AUTHORIZED_ENTITY_MODEL,
-            user_model=self.request.user
+            entity_model=self.AUTHORIZED_ENTITY_MODEL
         ).products()
 
     def get_form(self, form_class=None):
@@ -348,8 +345,7 @@ class ServiceUpdateView(ServiceItemModelModelBaseView, UpdateView):
 
     def get_queryset(self):
         return ItemModel.objects.for_entity(
-            entity_slug=self.kwargs['entity_slug'],
-            user_model=self.request.user
+            entity_model=self.kwargs['entity_slug']
         ).services()
 
     def get_form(self, form_class=None):

django_ledger/views/journal_entry.py

@@ -259,8 +259,7 @@ class BaseJournalEntryActionView(
 
     def get_queryset(self):
         return JournalEntryModel.objects.for_entity(
-            entity_slug=self.get_authorized_entity_instance(),
-            user_model=self.request.user
+            entity_model=self.AUTHORIZED_ENTITY_MODEL
         ).for_ledger(ledger_pk=self.kwargs['ledger_pk'])
 
     def get_redirect_url(self, *args, **kwargs):

django_ledger/views/mixins.py

@@ -19,9 +19,9 @@ from django.utils.dateparse import parse_date
 from django.utils.translation import gettext_lazy as _
 from django.views.generic.dates import YearMixin, MonthMixin, DayMixin
 
-from django_ledger.models import EntityModel, InvoiceModel, BillModel
+from django_ledger.models import EntityModel, InvoiceModel, BillModel, LedgerModel
 from django_ledger.models.entity import EntityModelFiscalPeriodMixIn
-from django_ledger.settings import DJANGO_LEDGER_PDF_SUPPORT_ENABLED, DJANGO_LEDGER_AUTHORIZED_SUPERUSER
+from django_ledger.settings import DJANGO_LEDGER_AUTHORIZED_SUPERUSER
 
 
 class ContextFromToDateMixin:
@@ -424,11 +424,13 @@ class DigestContextMixIn:
                       to_date=None,
                       **kwargs):
 
-        if any([self.IO_DIGEST_UNBOUNDED,
-                self.IO_DIGEST_BOUNDED]):
+        if any([
+            self.IO_DIGEST_UNBOUNDED,
+            self.IO_DIGEST_BOUNDED
+        ]):
 
             by_period = self.request.GET.get('by_period')
-            entity_model: EntityModel = self.object
+            io_model: EntityModel | LedgerModel = self.object
             if not to_date:
                 to_date = context['to_date']
             if not from_date:
@@ -441,19 +443,22 @@ class DigestContextMixIn:
                 unit_slug = None
 
             if self.IO_DIGEST_UNBOUNDED:
-                io_digest = entity_model.digest(user_model=self.request.user,
-                                                to_date=to_date,
-                                                unit_slug=unit_slug,
-                                                by_period=True if by_period else False,
-                                                process_ratios=True,
-                                                process_roles=True,
-                                                process_groups=True)
+                io_digest = io_model.digest(
+                    user_model=self.request.user,
+                    entity_slug=io_model.entity_slug if isinstance(io_model, LedgerModel) else None,
+                    to_date=to_date,
+                    unit_slug=unit_slug,
+                    by_period=True if by_period else False,
+                    process_ratios=True,
+                    process_roles=True,
+                    process_groups=True
+                )
 
                 context[self.get_io_manager_unbounded_context_name()] = io_digest
                 context[self.get_io_digest_unbounded_context_name()] = io_digest.get_io_data()
 
             if self.IO_DIGEST_BOUNDED:
-                io_digest_equity = entity_model.digest(
+                io_digest_equity = io_model.digest(
                     user_model=self.request.user,
                     equity_only=True,
                     to_date=to_date,
@@ -489,8 +494,9 @@ class UnpaidElementsMixIn:
             to_date = context['to_date'] if not to_date else to_date
 
             qs = InvoiceModel.objects.for_entity(
-                user_model=self.request.user,
-                entity_slug=self.kwargs['entity_slug']
+                entity_model=self.kwargs['entity_slug']
+            ).for_user(
+                user_model=self.request.user
             ).approved().filter(
                 Q(date_approved__gte=from_date) &
                 Q(date_approved__lte=to_date)
@@ -508,14 +514,16 @@ class UnpaidElementsMixIn:
             to_date = context['to_date'] if not to_date else to_date
 
             qs = BillModel.objects.for_entity(
-                user_model=self.request.user,
-                entity_slug=self.kwargs['entity_slug']
+                entity_model=self.kwargs['entity_slug']
+            ).for_user(
+                user_model=self.request.user
             ).unpaid().filter(
                 Q(date_approved__gte=from_date) &
                 Q(date_approved__lte=to_date)
             ).select_related('vendor').order_by('date_due')
 
             unit_slug = self.get_unit_slug()
+
             if unit_slug:
                 qs = qs.filter(ledger__journal_entries__entity_unit__slug__exact=unit_slug)
 
@@ -595,8 +603,6 @@ class PDFReportMixIn:
         return ctx['to_date']
 
     def get_pdf_response(self) -> HttpResponse:
-        if not DJANGO_LEDGER_PDF_SUPPORT_ENABLED:
-            return HttpResponseNotFound(content='PDF format is not supported')
         pdf = self.get_pdf()
         response = HttpResponse(
             bytes(pdf.output()),

django_ledger/views/purchase_order.py

@@ -23,21 +23,18 @@ from django_ledger.models import PurchaseOrderModel, ItemTransactionModel, Estim
 from django_ledger.views.mixins import DjangoLedgerSecurityMixIn
 
 
-class PurchaseOrderModelModelViewQuerySetMixIn:
+class PurchaseOrderModelModelViewQuerySetMixIn(DjangoLedgerSecurityMixIn):
     queryset = None
 
     def get_queryset(self):
         if self.queryset is None:
             self.queryset = PurchaseOrderModel.objects.for_entity(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=self.request.user
+                entity_model=self.AUTHORIZED_ENTITY_MODEL,
             ).select_related('entity', 'ce_model')
         return super().get_queryset()
 
 
-class PurchaseOrderModelListView(DjangoLedgerSecurityMixIn,
-                                 PurchaseOrderModelModelViewQuerySetMixIn,
-                                 ArchiveIndexView):
+class PurchaseOrderModelListView(PurchaseOrderModelModelViewQuerySetMixIn, ArchiveIndexView):
     template_name = 'django_ledger/purchase_order/po_list.html'
     context_object_name = 'po_list'
     PAGE_TITLE = _('PO List')
@@ -76,9 +73,7 @@ class PurchaseOrderModelMonthListView(MonthArchiveView,
     date_list_period = 'year'
 
 
-class PurchaseOrderModelCreateView(DjangoLedgerSecurityMixIn,
-                                   PurchaseOrderModelModelViewQuerySetMixIn,
-                                   CreateView):
+class PurchaseOrderModelCreateView(PurchaseOrderModelModelViewQuerySetMixIn, CreateView):
     template_name = 'django_ledger/purchase_order/po_create.html'
     PAGE_TITLE = _('Create Purchase Order')
     extra_context = {
@@ -92,8 +87,7 @@ class PurchaseOrderModelCreateView(DjangoLedgerSecurityMixIn,
         response = super(PurchaseOrderModelCreateView, self).get(request, entity_slug, **kwargs)
         if self.for_estimate and 'ce_pk' in self.kwargs:
             estimate_qs = EstimateModel.objects.for_entity(
-                entity_slug=entity_slug,
-                user_model=self.request.user
+                entity_model=self.AUTHORIZED_ENTITY_MODEL,
             )
             estimate_model: EstimateModel = get_object_or_404(estimate_qs, uuid__exact=self.kwargs['ce_pk'])
             if not estimate_model.can_bind():
@@ -110,8 +104,7 @@ class PurchaseOrderModelCreateView(DjangoLedgerSecurityMixIn,
                                                      'ce_pk': self.kwargs['ce_pk']
                                                  })
             estimate_qs = EstimateModel.objects.for_entity(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=self.request.user
+                entity_model=self.AUTHORIZED_ENTITY_MODEL
             ).select_related('customer')
             estimate_model = get_object_or_404(estimate_qs, uuid__exact=self.kwargs['ce_pk'])
             context['estimate_model'] = estimate_model
@@ -125,23 +118,25 @@ class PurchaseOrderModelCreateView(DjangoLedgerSecurityMixIn,
 
     def get_form(self, form_class=None):
         entity_slug = self.kwargs['entity_slug']
-        form = PurchaseOrderModelCreateForm(entity_slug=entity_slug,
-                                            user_model=self.request.user,
-                                            **self.get_form_kwargs())
+        form = PurchaseOrderModelCreateForm(
+            entity_slug=entity_slug,
+            user_model=self.request.user,
+            **self.get_form_kwargs()
+        )
         return form
 
     def form_valid(self, form):
         po_model: PurchaseOrderModel = form.save(commit=False)
         po_model = po_model.configure(
             entity_slug=self.kwargs['entity_slug'],
-            user_model=self.request.user)
+            user_model=self.request.user
+        )
 
         if self.for_estimate:
             ce_pk = self.kwargs['ce_pk']
             estimate_model_qs = EstimateModel.objects.for_entity(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=self.request.user
-            )
+                entity_model=self.AUTHORIZED_ENTITY_MODEL,
+            ).for_user(user_model=self.request.user)
             estimate_model = get_object_or_404(estimate_model_qs, uuid__exact=ce_pk)
             po_model.action_bind_estimate(estimate_model=estimate_model, commit=False)
         return super().form_valid(form=form)
@@ -162,9 +157,7 @@ class PurchaseOrderModelCreateView(DjangoLedgerSecurityMixIn,
                        })
 
 
-class PurchaseOrderModelUpdateView(DjangoLedgerSecurityMixIn,
-                                   PurchaseOrderModelModelViewQuerySetMixIn,
-                                   UpdateView):
+class PurchaseOrderModelUpdateView(PurchaseOrderModelModelViewQuerySetMixIn, UpdateView):
     slug_url_kwarg = 'po_pk'
     slug_field = 'uuid'
     context_object_name = 'po_model'
@@ -322,8 +315,7 @@ class PurchaseOrderModelUpdateView(DjangoLedgerSecurityMixIn,
 
         if form.has_changed():
             po_items_qs = ItemTransactionModel.objects.for_po(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=self.request.user,
+                entity_model=self.kwargs['entity_slug'],
                 po_pk=po_model.uuid,
             ).select_related('bill_model')
 
@@ -360,9 +352,7 @@ class PurchaseOrderModelUpdateView(DjangoLedgerSecurityMixIn,
         return super().form_valid(form)
 
 
-class PurchaseOrderModelDetailView(DjangoLedgerSecurityMixIn,
-                                   PurchaseOrderModelModelViewQuerySetMixIn,
-                                   DetailView):
+class PurchaseOrderModelDetailView(PurchaseOrderModelModelViewQuerySetMixIn, DetailView):
     slug_url_kwarg = 'po_pk'
     slug_field = 'uuid'
     context_object_name = 'po_model'
@@ -390,9 +380,7 @@ class PurchaseOrderModelDetailView(DjangoLedgerSecurityMixIn,
         return context
 
 
-class PurchaseOrderModelDeleteView(DjangoLedgerSecurityMixIn,
-                                   PurchaseOrderModelModelViewQuerySetMixIn,
-                                   DeleteView):
+class PurchaseOrderModelDeleteView(PurchaseOrderModelModelViewQuerySetMixIn, DeleteView):
     slug_url_kwarg = 'po_pk'
     slug_field = 'uuid'
     context_object_name = 'po_model'
@@ -436,10 +424,11 @@ class PurchaseOrderModelDeleteView(DjangoLedgerSecurityMixIn,
 
 
 # ACTIONS...
-class BasePurchaseOrderActionActionView(DjangoLedgerSecurityMixIn,
-                                        PurchaseOrderModelModelViewQuerySetMixIn,
-                                        RedirectView,
-                                        SingleObjectMixin):
+class BasePurchaseOrderActionActionView(
+    PurchaseOrderModelModelViewQuerySetMixIn,
+    RedirectView,
+    SingleObjectMixin
+):
     http_method_names = ['get']
     pk_url_kwarg = 'po_pk'
     action_name = None

django_ledger/views/unit.py

@@ -28,8 +28,7 @@ class EntityUnitModelModelBaseView(DjangoLedgerSecurityMixIn):
     def get_queryset(self):
         if self.queryset is None:
             self.queryset = EntityUnitModel.objects.for_entity(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=self.request.user
+                entity_model=self.get_authorized_entity_instance()
             ).select_related('entity')
         return super().get_queryset()
 

django_ledger/views/vendor.py

@@ -22,8 +22,7 @@ class VendorModelModelBaseView(DjangoLedgerSecurityMixIn):
     def get_queryset(self):
         if self.queryset is None:
             self.queryset = VendorModel.objects.for_entity(
-                entity_slug=self.kwargs['entity_slug'],
-                user_model=self.request.user
+                entity_model=self.kwargs['entity_slug']
             ).order_by('-updated')
         return super().get_queryset()
 

{django_ledger-0.7.11.dist-info → django_ledger-0.8.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
-Metadata-Version: 2.2
+Metadata-Version: 2.4
 Name: django-ledger
-Version: 0.7.11
+Version: 0.8.0
 Summary: Double entry accounting system built on the Django Web Framework.
 Author-email: Miguel Sanda <msanda@arrobalytics.com>
 Maintainer-email: Miguel Sanda <msanda@arrobalytics.com>
@@ -18,26 +18,18 @@ Classifier: Framework :: Django :: 5.0
 Classifier: Intended Audience :: Financial and Insurance Industry
 Classifier: Intended Audience :: End Users/Desktop
 Classifier: License :: OSI Approved :: GNU General Public License v3 or later (GPLv3+)
-Requires-Python: >=3.10
+Requires-Python: >=3.11
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: AUTHORS.md
-Requires-Dist: asgiref>=3.5.2; python_version >= "3.7"
-Requires-Dist: django>=2.2
-Requires-Dist: django-treebeard>=4.5.1
-Requires-Dist: faker>=15.3.3
-Requires-Dist: markdown>=3.4.1
+Requires-Dist: django>=4.2
+Requires-Dist: django-treebeard>=4.7.1
+Requires-Dist: faker>=37.6.0
+Requires-Dist: fpdf2>=2.8.4
+Requires-Dist: markdown>=3.9
 Requires-Dist: ofxtools>=0.9.5
-Requires-Dist: pillow>=9.3.0
-Requires-Dist: python-dateutil>=2.8.2; python_version >= "2.7" and python_version not in "3.0, 3.1, 3.2, 3.3"
-Requires-Dist: six>=1.16.0; python_version >= "2.7" and python_version not in "3.0, 3.1, 3.2, 3.3"
-Requires-Dist: sqlparse>=0.4.3; python_version >= "3.5"
-Provides-Extra: dev
-Requires-Dist: sphinx~=4.5.0; extra == "dev"
-Requires-Dist: behave~=1.2.6; extra == "dev"
-Requires-Dist: pipenv-setup; extra == "dev"
-Requires-Dist: pylint; extra == "dev"
-Requires-Dist: furo; extra == "dev"
+Requires-Dist: pillow>=11.3.0
+Dynamic: license-file
 
 ![django ledger logo](https://us-east-1.linodeobjects.com/django-ledger/logo/django-ledger-logo@2x.png)
 
@@ -72,8 +64,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**:
@@ -100,56 +95,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 = [
@@ -159,16 +110,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__:
@@ -183,7 +143,7 @@ urlpatterns = [
 ]
 ```
 
-* Run your project:
+### Run your project:
 
 ```shell
 python manage.py runserver
@@ -194,7 +154,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: