django-fast-treenode 2.1.4__py3-none-any.whl → 3.0.1__py3-none-any.whl

treenode/models/closure.py

@@ -1,122 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-TreeNode Closure Model
-
-This module defines the Closure Table implementation for hierarchical
-data storage in the TreeNode model. It supports efficient queries for
-retrieving ancestors, descendants, breadcrumbs, and tree depth.
-
-Features:
-- Uses a Closure Table for efficient tree operations.
-- Implements cached queries for improved performance.
-- Provides bulk operations for inserting, moving, and deleting nodes.
-
-Version: 2.1.0
-Author: Timur Kady
-Email: timurkady@yandex.com
-"""
-
-
-from django.db import models, transaction
-from django.db.models.signals import pre_save, post_save
-
-from ..managers import ClosureModelManager
-from ..signals import disable_signals
-
-
-class ClosureModel(models.Model):
-    """
-    Model for Closure Table.
-
-    Implements hierarchy storage using the Closure Table method.
-    """
-
-    parent = models.ForeignKey(
-        'TreeNodeModel',
-        related_name='children_set',
-        on_delete=models.CASCADE,
-    )
-
-    child = models.ForeignKey(
-        'TreeNodeModel',
-        related_name='parents_set',
-        on_delete=models.CASCADE,
-    )
-
-    depth = models.PositiveIntegerField()
-
-    node = models.OneToOneField(
-        'TreeNodeModel',
-        related_name="tn_closure",
-        on_delete=models.CASCADE,
-        null=True,
-        blank=True,
-    )
-
-    objects = ClosureModelManager()
-
-    class Meta:
-        """Meta Class."""
-
-        abstract = True
-        unique_together = (("parent", "child"),)
-        indexes = [
-            models.Index(fields=["parent", "child"]),
-            models.Index(fields=["parent", "depth"]),
-            models.Index(fields=["child", "depth"]),
-            models.Index(fields=["parent", "child", "depth"]),
-        ]
-
-    def __str__(self):
-        """Display information about a class object."""
-        return f"{self.parent} — {self.child} — {self.depth}"
-
-    # ----------- Methods of working with tree structure ----------- #
-
-    @classmethod
-    def get_root(cls, node):
-        """Get the root node pk for the current node."""
-        queryset = cls.objects.filter(child=node).order_by('-depth')
-        return queryset.first().parent if queryset.count() > 0 else None
-
-    @classmethod
-    def get_depth(cls, node):
-        """Get the node depth (how deep the node is in the tree)."""
-        result = cls.objects.filter(child__pk=node.pk).aggregate(
-            models.Max("depth")
-        )["depth__max"]
-        return result if result is not None else 0
-
-    @classmethod
-    def get_level(cls, node):
-        """Get the node level (starting from 1)."""
-        return cls.objects.filter(child__pk=node.pk).aggregate(
-            models.Max("depth"))["depth__max"] + 1
-
-    @classmethod
-    @transaction.atomic
-    def insert_node(cls, node):
-        """Add a node to a Closure table."""
-        # Call bulk_create passing a single object
-        cls.objects.bulk_create([node], batch_size=1000)
-
-    @classmethod
-    @transaction.atomic
-    def move_node(cls, nodes):
-        """Move a nodes (node and its subtree) to a new parent."""
-        # Call bulk_update passing a single object
-        cls.objects.bulk_update(nodes, batch_size=1000)
-
-    @classmethod
-    @transaction.atomic
-    def delete_all(cls):
-        """Clear the Closure Table."""
-        cls.objects.all().delete()
-
-    def save(self, force_insert=False, *args, **kwargs):
-        """Save method."""
-        with (disable_signals(pre_save, self._meta.model),
-              disable_signals(post_save, self._meta.model)):
-            super().save(force_insert, *args, **kwargs)
-
-# The End

treenode/static/treenode/js/.gitkeep

@@ -1 +0,0 @@
-

treenode/static/treenode/js/treenode_admin.js

@@ -1,131 +0,0 @@
-(function($) {
-  // Function "debounce" to delay execution
-  function debounce(func, wait) {
-    var timeout;
-    return function() {
-      var context = this, args = arguments;
-      clearTimeout(timeout);
-      timeout = setTimeout(function() {
-        func.apply(context, args);
-      }, wait);
-    };
-  }
-  
-  // Function to recursively delete descendants of the current child
-  function removeAllDescendants(nodeId) {
-    var $children = $tableBody.find(`tr[data-parent-of="${nodeId}"]`);
-
-    $children.each(function () {
-        var childId = $(this).data('node-id');
-        removeAllDescendants(childId); 
-    });
-
-    $children.remove();
-  }
-  
-  // Function to reveal nodes stored in storage
-  function restoreExpandedNodes() {
-    var expandedNodes = JSON.parse(localStorage.getItem('expandedNodes')) || [];
-    if (expandedNodes.length === 0) return;
-
-    function expandNext(nodes) {
-      if (nodes.length === 0) return;
-
-      var nodeId = nodes.shift();
-
-      $.getJSON('change_list/', { tn_parent_id: nodeId }, function (response) {
-        if (response.html) {
-          var $btn = $tableBody.find(`.treenode-toggle[data-node-id="${nodeId}"]`);
-          var $parentRow = $btn.closest('tr');
-          $parentRow.after(response.html);
-          $btn.html('▼').data('expanded', true);
-          // Раскрываем следующий узел после завершения AJAX-запроса
-          expandNext(nodes);
-        }
-      });
-    }
-
-    // Начинаем раскрытие узлов по порядку
-    expandNext([...expandedNodes]);
-  }
-  
-  // Global variables ---------------------------------
-  var $tableBody;
-  var originalTableHtml;
-  
-  var expandedNodes = JSON.parse(localStorage.getItem('expandedNodes')) || [];
-
-  // Events -------------------------------------------
-
-  $(document).ready(function () {
-      // Сохраняем оригинальное содержимое таблицы (корневые узлы)
-      $tableBody = $('table#result_list tbody');
-      originalTableHtml = $tableBody.html();
-      restoreExpandedNodes();
-  });
-
-  // Обработчик клика для кнопок treenode-toggle через делегирование на document
-  $(document).on('click', '.treenode-toggle', function(e) {
-    e.preventDefault();
-    var $btn = $(this);
-    var nodeId = $btn.data('node-id');
-
-    // Если узел уже развёрнут, сворачиваем его
-    if ($btn.data('expanded')) {
-      removeAllDescendants(nodeId);
-      $btn.html('►').data('expanded', false);
-      
-      // Убираем узел из списка сохранённых
-      expandedNodes = expandedNodes.filter(id => id !== nodeId);
-
-    } else {
-      // Иначе запрашиваем дочерние узлы через AJAX
-      $.getJSON('change_list/', { tn_parent_id: nodeId }, function(response) {
-        if (response.html) {
-          var $parentRow = $btn.closest('tr');
-          $parentRow.after(response.html);
-          $btn.html('▼').data('expanded', true);
-          
-          // Сохраняем узел в localStorage
-          if (!expandedNodes.includes(nodeId)) {
-            expandedNodes.push(nodeId);
-          }
-          localStorage.setItem('expandedNodes', JSON.stringify(expandedNodes));
-        }
-      });
-    }
-    localStorage.setItem('expandedNodes', JSON.stringify(expandedNodes));
-  });
-
-
-  // Обработчик ввода для поля поиска с делегированием на document
-  $(document).on('keyup', 'input[name="q"]', debounce(function(e) {
-    var query = $.trim($(this).val());
-    
-    if (query === '') {
-      $tableBody.html(originalTableHtml);
-      return;
-    }
-    
-    $.getJSON('search/', { q: query }, function(response) {
-      var rowsHtml = '';
-      if (response.results && response.results.length > 0) {
-        $.each(response.results, function(index, node) {
-          var dragCell = '<td class="drag-cell"><span class="treenode-drag-handle">↕</span></td>';
-          var toggleCell = '';
-          if (!node.is_leaf) {
-            toggleCell = '<td class="toggle-cell"><button class="treenode-toggle" data-node-id="' + node.id + '">▶</button></td>';
-          } else {
-            toggleCell = '<td class="toggle-cell"><div class="treenode-space">&nbsp;</div></td>';
-          }
-          var displayCell = '<td class="display-cell">' + node.text + '</td>';
-          rowsHtml += '<tr>' + dragCell + toggleCell + displayCell + '</tr>';
-        });
-      } else {
-        rowsHtml = '<tr><td colspan="3">Ничего не найдено</td></tr>';
-      }
-      $tableBody.html(rowsHtml);
-    });
-  }, 500));
-
-})(django.jQuery || window.jQuery);

treenode/templates/admin/export_success.html

@@ -1,26 +0,0 @@
-{% extends "admin/base_site.html" %}
-{% load i18n %}
-{% block title %}{% trans "Export Successful" %}{% endblock %}
-
-{% block content %}
-<div class="module" style="margin-top: 20px;">
-  <h2>{{ message }}</h2>
-  <div class="module ">
-    <p>{{ manual_download_label }}</p>
-    <p><a id="dl" href="{{ download_url }}" class="button">Download</a></p>
-  </div>
-  <p>
-    <input type="button" class="button" value="{{ button_text }}" onclick="window.location.href='{{ redirect_url }}';">
-  </p>
-
-</div>
-
-<script type="text/javascript">
-    // When the page loads, create a hidden iframe to initiate the download
-
-    window.onload = function() {
-        document.getElementById("dl").click();
-    };
-</script>
-{% endblock %}
-

treenode/templates/admin/tree_node_changelist.html

@@ -1,19 +0,0 @@
-{% extends "admin/change_list.html" %}
-
-{% block object-tools-items %}
-    {{ block.super }}
-    {% if import_export_enabled %}
-    <li>
-        <a href="import/" class="button">Import</a>
-    </li>
-    <li>
-        <a href="export/" class="button">Export</a>
-    </li>
-    {% endif %}
-{% endblock %}
-
-{% block extrahead %}
-
-  {{ block.super }}
-
-{% endblock %}

treenode/templates/admin/tree_node_export.html

@@ -1,27 +0,0 @@
-{% extends "admin/base_site.html" %}
-{% load i18n %}
-{% block content %}
-<div class="module">
-  <h2>{% trans "Export Tree Node Data" %}</h2>
-  <form method="get" class="form-horizontal" style="margin-top: 20px;">
-    <div class="form-group">
-      <label for="format" class="col-sm-2 control-label">{% trans "Select format:" %}</label>
-      <div class="col-sm-10">
-        <select name="format" id="format" class="form-control">
-          <option value="csv">CSV</option>
-          <option value="json">JSON</option>
-          <option value="xlsx">{% trans "Excel (XLSX)" %}</option>
-          <option value="yaml">YAML</option>
-          <option value="tsv">TSV</option>
-        </select>
-      </div>
-    </div>
-    <div class="form-group" style="margin-top: 35px;">
-      <div class="col-sm-offset-2 col-sm-10">
-        <button type="submit" class="button">{% trans "Export" %}</button>
-        <a href=".." class="button default">{% trans "Cancel" %}</a>
-      </div>
-    </div>
-  </form>
-</div>
-{% endblock %}

treenode/templates/admin/tree_node_import.html

@@ -1,45 +0,0 @@
-{% extends "admin/base_site.html" %}
-{% load static %}
-
-{% block extrahead %}
-    <link rel="stylesheet" type="text/css" href="{% static 'admin/css/forms.css' %}">
-{% endblock %}
-
-{% block content %}
-    <div class="module">
-        <h2>Import Data</h2>
-
-        {% if message %}
-            <div class="successnote">
-                <p>{{ message }}</p>
-            </div>
-        {% endif %}
-        
-        {% if errors %}
-            <div class="errornote">
-                <p>Errors occurred while importing the data:</p>
-                <ul>
-                    {% for error in errors %}
-                        <li>{{ error }}</li>
-                    {% endfor %}
-                </ul>
-            </div>
-        {% endif %}
-
-        <form id="importForm" method="post" enctype="multipart/form-data" style="margin: 20px 0;">
-            {% csrf_token %}
-            <fieldset class="module aligned">
-                <div class="form-row field-tn_parent">
-                    <label for="file">Choose file:</label>
-                    <input type="file" name="file" id="file" required>
-                </div>
-            </fieldset>
-
-            <div class="submit-row" style="margin-top: 35px;">
-                <input id="importBtn" type="submit" value="Import" name="_save">
-                <input type="button" value="Cancel" class="button cancel" onclick="window.location.href='..';">
-            </div>
-        </form>
-        
-    </div>
-{% endblock %}

treenode/templates/admin/tree_node_import_report.html

@@ -1,32 +0,0 @@
-{% extends "admin/base_site.html" %}
-{% block content %}
-    <div class="module">
-        <h2>Import Results</h2>
-        
-            <ul class="messagelist">
-                <li class="success"><strong>Created:</strong> {{ created_count }} records</li>
-                <li class="success"><strong>Updated:</strong> {{ updated_count }} records</li>
-            </ul>
-
-            {% if errors %}
-                <div class="errornote">
-                    <p>Errors occurred while importing the data:</p>
-                    <ul>
-                        {% for error in errors %}
-                            <li>{{ error }}</li>
-                        {% endfor %}
-                    </ul>
-                </div>
-            {% endif %}
-
-        <div style="margin-top: 20px;">
-            <button type="button" class="button" onclick="redirectAfterImport()">Finish</button>
-        </div>
-    </div>
-
-    <script>
-        function redirectAfterImport() {
-            window.location.href = window.location.pathname.replace("import/", "") + "?import_done=1";
-        }
-    </script>
-{% endblock %}

treenode/templates/widgets/tree_widget.css

@@ -1,23 +0,0 @@
-/* Light mode */
-.select2-container--default.select2-light .select2-selection {
-    background-color: #fff;
-    color: #333;
-    border: 1px solid #ccc;
-}
-
-.select2-container--default.select2-light .select2-dropdown {
-    background-color: #fff;
-    color: #333;
-}
-
-/* Dark mode */
-.select2-container--default.select2-dark .select2-selection {
-    background-color: #222;
-    color: #ddd;
-    border: 1px solid #444;
-}
-
-.select2-container--default.select2-dark .select2-dropdown {
-    background-color: #222;
-    color: #ddd;
-}

treenode/utils/aid.py

@@ -1,46 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Aid Utility Module
-
-This module provides various helper functions.
-
-Version: 2.1.0
-Author: Timur Kady
-Email: timurkady@yandex.com
-"""
-
-
-from django.utils.safestring import mark_safe
-
-
-def object_to_content(obj):
-    """Convert object data to widget options string."""
-    level = obj.get_depth()
-    icon = "📄 " if obj.is_leaf() else "📁 "
-    obj_str = str(obj)
-    content = (
-        f'<span class="treenode-option" style="padding-left: {level * 1.5}em;">'
-        f'{icon}{obj_str}</span>'
-    )
-    return mark_safe(content)
-
-
-def to_base16(num):
-    """
-    Convert an integer to a base16 string.
-
-    For example: 10 -> 'A', 11 -> 'B', etc.
-    """
-    digits = "0123456789ABCDEF"
-
-    if num == 0:
-        return '0'
-    sign = '-' if num < 0 else ''
-    num = abs(num)
-    result = []
-    while num:
-        num, rem = divmod(num, 16)
-        result.append(digits[rem])
-    return sign + ''.join(reversed(result))
-
-# The End

treenode/utils/base16.py

@@ -1,38 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Base16 Utility Module
-
-This module provides a utility function for converting integers
-to Base16 string representation.
-
-Features:
-- Converts integers into a more compact Base36 format.
-- Maintains lexicographic order when padded with leading zeros.
-- Supports negative numbers.
-
-Version: 2.1.0
-Author: Timur Kady
-Email: timurkady@yandex.com
-"""
-
-
-def to_base16(num):
-    """
-    Convert an integer to a base16 string.
-
-    For example: 10 -> 'A', 11 -> 'B', etc.
-    """
-    digits = "0123456789ABCDEF"
-
-    if num == 0:
-        return '0'
-    sign = '-' if num < 0 else ''
-    num = abs(num)
-    result = []
-    while num:
-        num, rem = divmod(num, 16)
-        result.append(digits[rem])
-    return sign + ''.join(reversed(result))
-
-# The End
-

treenode/utils/base36.py

@@ -1,37 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-Base36 Utility Module
-
-This module provides a utility function for converting integers
-to Base36 string representation.
-
-Features:
-- Converts integers into a more compact Base36 format.
-- Maintains lexicographic order when padded with leading zeros.
-- Supports negative numbers.
-
-Version: 2.1.0
-Author: Timur Kady
-Email: timurkady@yandex.com
-"""
-
-
-def to_base36(num):
-    """
-    Convert an integer to a base36 string.
-
-    For example: 10 -> 'A', 35 -> 'Z', 36 -> '10', etc.
-    """
-    digits = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ"
-
-    if num == 0:
-        return '0'
-    sign = '-' if num < 0 else ''
-    num = abs(num)
-    result = []
-    while num:
-        num, rem = divmod(num, 36)
-        result.append(digits[rem])
-    return sign + ''.join(reversed(result))
-
-# The End

treenode/utils/db.py

@@ -1,116 +0,0 @@
-# -*- coding: utf-8 -*-
-"""
-DB Vendor Utility Module
-
-This module provides a utility function for converting integers
-to Base36 string representation.
-
-Features:
-- Converts integers into a more compact Base36 format.
-- Maintains lexicographic order when padded with leading zeros.
-- Supports negative numbers.
-
-Version: 2.1.0
-Author: Timur Kady
-Email: timurkady@yandex.com
-"""
-
-import logging
-from django.apps import apps
-from django.db import connection
-
-from ..models import TreeNodeModel
-
-logger = logging.getLogger(__name__)
-
-
-def create_indexes(model):
-    """Create indexes for the descendants of TreeNodeModel."""
-    vendor = connection.vendor
-    sender = "Django Fast TeeNode"
-    table = model._meta.db_table
-
-    with connection.cursor() as cursor:
-        if vendor == "postgresql":
-            cursor.execute(
-                "SELECT indexname FROM pg_indexes WHERE tablename = %s AND indexname = %s;",
-                [table, f"idx_{table}_btree"]
-            )
-            if not cursor.fetchone():
-                cursor.execute(
-                    f"CREATE INDEX idx_{table}_btree ON {table} USING BTREE (id);"
-                )
-                logger.info(f"{sender}: GIN index for table {table} created.")
-
-            # Если существует первичный ключ, выполняем кластеризацию
-            cursor.execute(
-                "SELECT relname FROM pg_class WHERE relname = %s;",
-                [f"{table}_pkey"]
-            )
-            if cursor.fetchone():
-                cursor.execute(f"CLUSTER {table} USING {table}_pkey;")
-                logger.info(f"{sender}: Table {table} is clustered.")
-
-        elif vendor == "mysql":
-            cursor.execute("SHOW TABLE STATUS WHERE Name = %s;", [table])
-            columns = [col[0] for col in cursor.description]
-            row = cursor.fetchone()
-            if row:
-                table_status = dict(zip(columns, row))
-                engine = table_status.get("Engine", "").lower()
-                if engine != "innodb":
-                    cursor.execute(f"ALTER TABLE {table} ENGINE = InnoDB;")
-                    logger.info(
-                        f"{sender}: Table {table} has been converted to InnoDB."
-                    )
-
-        elif vendor in ["microsoft", "oracle"]:
-            if vendor == "microsoft":
-                cursor.execute(
-                    "SELECT name FROM sys.indexes WHERE name = %s AND object_id = OBJECT_ID(%s);",
-                    [f"idx_{table}_cluster", table]
-                )
-            else:
-                cursor.execute(
-                    "SELECT index_name FROM user_indexes WHERE index_name = %s;",
-                    [f"IDX_{table.upper()}_CLUSTER"]
-                )
-            if not cursor.fetchone():
-                cursor.execute(
-                    f"CREATE CLUSTERED INDEX idx_{table}_cluster ON {table} (id);")
-                logger.info(
-                    f"{sender}: CLUSTERED index for table {table} created."
-                )
-
-        elif vendor == "sqlite":
-            # Kick those on SQLite
-            logger.warning(
-                f"{sender} Unable to create GIN and CLUSTER indexes for SQLite."
-            )
-        else:
-            logger.warning(
-                f"{sender}: Unknown vendor. Index creation cancelled."
-            )
-
-
-def post_migrate_update(sender, **kwargs):
-    """Update indexes and tn_closure field only when necessary."""
-    # Перебираем все зарегистрированные модели
-    for model in apps.get_models():
-        # Check that the model inherits from TreeNodeModel and
-        # is not abstract
-        if issubclass(model, TreeNodeModel) and not model._meta.abstract:
-            # Create GIN and CLUSTER indexrs
-            create_indexes(model)
-            # Get ClosureModel
-            closure_model = model.closure_model
-            # Check node counts
-            al_count = model.objects.exists()
-            cl_counts = closure_model.objects.exclude(node=None).exists()
-
-            if al_count and not cl_counts:
-                # Call update_tree()
-                model.update_tree()
-
-
-# The End