o ˷ej@sddlZddlmZddlmZddlmZddlmZddl m Z ddl m Z ddl mZd d lmZd d lmZd d lmZd d lmZd dlmZmZmZmZmZGdddeZGdddZGdddedZ e dddfddZ!dS)N) OrderedDict)count)settings) Paginator)models) get_template) force_str)columns) RequestConfig) TableData) BoundRows)Accessor AttributeDictOrderBy OrderByTupleSequencecs eZdZdZfddZZS)DeclarativeColumnsMetaclassz Metaclass that converts `.Column` objects defined on a class to the dictionary `.Table.base_columns`, taking into account parent class `base_columns` as well. cst|dd||d<}gi}}|D]\}}t|tjr+d|_|||fq|||<q|}|jdddg} t |D]} t | drPt | j | } q@t | } |jrt } |jdur||jD]} tjjt| |j| |j| d| | <qcn|jjjD]}tjj||j|j|jd | |j<q| D]\}}|| vr| |jdurq|| |<q| t ||jD] }|| vr| |q|D] }|| vr| |q| D]}d}||jvrd}||jvrd }|dur|| |_q| |d<t||||S) NMeta_metaTcSs |djS)Nr )creation_counter)xrL/var/www/ideatree/venv/lib/python3.10/site-packages/django_tables2/tables.py&s z5DeclarativeColumnsMetaclass.__new__..)key base_columns)fieldaccessorlinkify)rrF) TableOptionsgetitems isinstancer Column _explicitappendsortreversedhasattrlistrrmodelfieldslibrarycolumn_for_fieldr get_fieldrrnameupdateexcludepopkeyslocalize unlocalizesuper__new__)mcsr0basesattrsoptscols remainder attr_nameattrparent_columnsbaserextra field_namerrcolumn exclusioncol_namelocalize_column __class__rrr8sj                 z#DeclarativeColumnsMetaclass.__new__)__name__ __module__ __qualname____doc__r8 __classcell__rrrIrrsrcs(eZdZdZfddZddZZS)r a Extracts and exposes options for a `.Table` from a `.Table.Meta` when the table is defined. See `.Table` for documentation on the impact of variables in this class. Arguments: options (`.Table.Meta`): options for a table from `.Table.Meta` cst|||ttdd}ttdi}t|d||_t|di|_t|di|_t|dd|_t|d d|_ t|d d|_ t|d g}t |t sRt |d }||_t|d d|_t|dd}t |trj|f}|durrt|nd|_t|dd|_t|dd|_t|dd|_t|dd|_t|dd|_t|dd |_t|dd |_t|dd|_t|dd |_t|dd|_t|d||_t|dd|_t|d d|_dS)!NDJANGO_TABLES2_TEMPLATEzdjango_tables2/table.htmlDJANGO_TABLES2_TABLE_ATTRSr; row_attrspinned_row_attrsdefaultu— empty_textr,rTr2rorder_byorder_by_fieldr' page_fieldpageper_pageper_page_fieldprefix show_header show_footersequence orderabler+ template_namer5r6) r7__init__ _check_typesgetattrrr;rRrSrTrUr,r#dictfromkeysrr2strrrVrWrXrZr\r]r_r`rarbr+rcr5r6)selfoptions class_namerPrQrrVrIrrrdusD        zTableOptions.__init__c Cs|durdStfgdtfdgtttfgdttttfdgtgdtfgdtttfdgttj fd gi}| D]5\}}|D].}t ||d}|durmt ||smd |||}td |t|jd d d|Dq?q9dS)zI Check class Meta attributes to prevent common mistakes. N)r_r`rbrZ)r,rar2r5r6r)rcr]rWrXr\)r;rRrSrVr+z {}.{} = {}z*{} (type {}), but type must be one of ({})z, cSsg|]}|jqSr)rK).0trrr sz-TableOptions._check_types..)boolinttupler*setrgrityperModelr"rfr#format__repr__ TypeErrorrKjoin) rjrkrlcheckstypesr4rvalue expressionrrrres0     zTableOptions._check_types)rKrLrMrNrdrerOrrrIrr ks 'r cseZdZdZ                   d:fdd ZddZdd Zd d Zd d Zd;ddZ ddZ e ddZ e j ddZ e ddZej ddZe ddZej ddZe ddZej ddZeddfdd Ze d!d"Zej d#d"Ze d$d%Zej d&d%Ze d'd(Ze d)d*Ze d+d,Ze d-d.Zej d/d.Ze d0d1Zej d2d1Ze d3d4Zej d5d4Ze d6d7Zd8d9ZZS)<Tablea A representation of a table. Arguments: data (QuerySet, list of dicts): The data to display. This is a required variable, a `TypeError` will be raised if it's not passed. order_by: (tuple or str): The default ordering tuple or comma separated str. A hyphen `-` can be used to prefix a column name to indicate *descending* order, for example: `("name", "-age")` or `name,-age`. orderable (bool): Enable/disable column ordering on this table empty_text (str): Empty text to render when the table has no data. (default `.Table.Meta.empty_text`) exclude (iterable or str): The names of columns that should not be included in the table. attrs (dict): HTML attributes to add to the ```` tag. When accessing the attribute, the value is always returned as an `.AttributeDict` to allow easily conversion to HTML. row_attrs (dict): Add custom html attributes to the table rows. Allows custom HTML attributes to be specified which will be added to the ```` tag of the rendered table. pinned_row_attrs (dict): Same as row_attrs but for pinned rows. sequence (iterable): The sequence/order of columns the columns (from left to right). Items in the sequence must be :term:`column names `, or `"..."` (string containing three periods). `'...'` can be used as a catch-all for columns that are not specified. prefix (str): A prefix for query string fields. To avoid name-clashes when using multiple tables on single page. order_by_field (str): If not `None`, defines the name of the *order by* query string field in the URL. page_field (str): If not `None`, defines the name of the *current page* query string field. per_page_field (str): If not `None`, defines the name of the *per page* query string field. template_name (str): The template to render when using ``{% render_table %}`` (defaults to DJANGO_TABLES2_TEMPLATE, which is ``"django_tables2/table.html"`` by default). default (str): Text to render in empty cells (determined by `.Column.empty_values`, default `.Table.Meta.default`) request: Django's request to avoid using `RequestConfig` show_header (bool): If `False`, the table will not have a header (``), defaults to `True` show_footer (bool): If `False`, the table footer will not be rendered, even if some columns have a footer, defaults to `True`. extra_columns (str, `.Column`): list of `(name, column)`-tuples containing extra columns to add to the instance. If `column` is `None`, the column with `name` will be removed from the table. NTcslt|durtdt|j|p|jj|_| |_t j |d|_ |j ||dur2|jj }||_ t|p;|jj|_||d|_t|j ||jd|_t|durY|n|jj|_dD]}t|j|i|j|<qat|pv|jj|_|dur|n|jj|_||_| |_| |_| |_| |_||_||_t !t|j"|dur|D]\}}|dur|vr|=q||<q| dur| } n|jjr|jj} n|jj#durt$|jj#d} nd} t%| } | &'|_(t)fdd| Dt*+||_*|dur |jj,dur |jj,}|dur d|_-|j j.}|dur||_,n||_,||_/|r0t0|1|t2|_3dS) NzArgument data to {} is required)data)topbottom)rtable pinned_data)theadtbodytfoot)z...c3s$|] }|vr||fVqdSNr)rmrrrr ]s"z!Table.__init__..)4r7rdrxrvrtrKrr2rar from_datar set_tablerTrrSget_top_pinned_dataget_bottom_pinned_datarr rowsr;r!rRrUrbr]rWrXr\r_r`copydeepcopyrr,rrrexpandr4 _sequencerr BoundColumnsrV _order_byorderingrcr configurer_counter)rjrrVrbrUr2r;rRrSrar]rWrXr\rcrTrequestr_r` extra_columnstagr0rErIrrrdsr         zTable.__init__cCdS)a& Return data for top pinned rows containing data for each row. Iterable type like: QuerySet, list of dicts, list of objects. Having a non-zero number of pinned rows will not result in an empty result set message being rendered, even if there are no regular data rows Returns: `None` (default) no pinned rows at the top, iterable, data for pinned rows at the top. Note: To show pinned row this method should be overridden. Example: >>> class TableWithTopPinnedRows(Table): ... def get_top_pinned_data(self): ... return [{ ... "column_a" : "some value", ... "column_c" : "other value", ... }] NrrjrrrruzTable.get_top_pinned_datacCr)a5 Return data for bottom pinned rows containing data for each row. Iterable type like: QuerySet, list of dicts, list of objects. Having a non-zero number of pinned rows will not result in an empty result set message being rendered, even if there are no regular data rows Returns: `None` (default) no pinned rows at the bottom, iterable, data for pinned rows at the bottom. Note: To show pinned row this method should be overridden. Example: >>> class TableWithBottomPinnedRows(Table): ... def get_bottom_pinned_data(self): ... return [{ ... "column_a" : "some value", ... "column_c" : "other value", ... }] NrrrrrrrzTable.get_bottom_pinned_datacCr)a  A way to hook into the moment just before rendering the template. Can be used to hide a column. Arguments: request: contains the `WGSIRequest` instance, containing a `user` attribute if `.django.contrib.auth.middleware.AuthenticationMiddleware` is added to your `MIDDLEWARE_CLASSES`. Example:: class Table(tables.Table): name = tables.Column(orderable=False) country = tables.Column(orderable=False) def before_render(self, request): if request.user.has_perm('foo.delete_bar'): self.columns.hide('country') else: self.columns.show('country') Nr)rjrrrr before_renderszTable.before_rendercCs0t|_t|j}||d}||||S)zU Render the table to an HTML table, adding `request` to the context. )rr)rrrrcrrender)rjrtemplatecontextrrras_htmls     z Table.as_htmlc#sZdurdfdd|jD}dd|DV|jD] fdd|DVqdS)a- Return a row iterator of the data which would be shown in the table where the first row is the table headers. arguments: exclude_columns (iterable): columns to exclude in the data iterator. This can be used to output the table data as CSV, excel, for example using the `~.export.ExportMixin`. If a column is defined using a :ref:`table.render_FOO`, the returned value from that method is used. If you want to differentiate between the rendered cell and a value, use a `value_Foo`-method:: class Table(tables.Table): name = tables.Column() def render_name(self, value): return format_html('{}', value) def value_name(self, value): return value will have a value wrapped in `` in the rendered HTML, and just returns the value when `as_values()` is called. Note that any invisible columns will be part of the row iterator. Nrcs"g|] }|jjs|jvs|qSr)rEexclude_from_exportr0rmrE)exclude_columnsrrros z#Table.as_values..cSsg|] }t|jddqST) strings_only)rheaderrrrrroscs g|] }t|jddqSr)rget_cell_valuer0r)rowrrros)r iterallr)rjrr r)rrr as_valuess    zTable.as_valuescCs|jo tdd|jDS)z{ Returns True if any of the columns define a ``_footer`` attribute or a ``render_footer()`` method css|]}|VqdSr) has_footerrrrrrsz#Table.has_footer..)r`anyr rrrrrszTable.has_footercC|jdur|jS|jjSr) _show_headerrr_rrrrr_zTable.show_headercC ||_dSr)rrjr|rrrr_ cC|jSr)rrrrrrVzTable.order_bycCsx|sdn|}t|tr|dn|}g}|D]}t|j}||jvr-|j|jr-||qt||_ |j |j dS)z Order the rows of the table based on columns. Arguments: value: iterable or comma separated string of order by aliases. r,N) r#risplitrbarer rbr&rrrrV)rjr|rVvalidaliasr0rrrrV s    cCrr)_order_by_fieldrrWrrrrrW!zTable.order_by_fieldcCrr)rrrrrrW'rcCrr) _page_fieldrrXrrrrrX+rzTable.page_fieldcCrr)rrrrrrX/rr cOs:|p|jj}||j|g|Ri||_|j||_|S)a Paginates the table using a paginator and creates a ``page`` property containing information for the current page. Arguments: paginator_class (`~django.core.paginator.Paginator`): A paginator class to paginate the results. per_page (int): Number of records to display on each page. page (int): Page to display. Extra arguments are passed to the paginator. Pagination exceptions (`~django.core.paginator.EmptyPage` and `~django.core.paginator.PageNotAnInteger`) may be raised from this method and should be handled by the caller. )rrZr paginatorrY)rjpaginator_classrZrYargskwargsrrrpaginate3s zTable.paginatecCrr)_per_page_fieldrr\rrrrr\LrzTable.per_page_fieldcCrr)rrrrrr\RrcCrr)_prefixrr]rrrrr]Vrz Table.prefixcCrr)rrrrrr]ZrcCd|j|jfSNz%s%s)r]rWrrrrprefixed_order_by_field^zTable.prefixed_order_by_fieldcCrr)r]rXrrrrprefixed_page_fieldbrzTable.prefixed_page_fieldcCrr)r]r\rrrrprefixed_per_page_fieldfrzTable.prefixed_per_page_fieldcCrr)rrrrrrajrzTable.sequencecCs&|rt|}||j||_dSr)rrrr4rrrrrrans cCrr) _orderablerrbrrrrrbu zTable.orderablecCrr)rrrrrrb|rcCrr) _templaterrcrrrrrcrzTable.template_namecCrr)rrrrrrcrcCst|dr |jjS|jS)z` Return the rows for the current page if the table is paginated, else all rows. rY)r)rY object_listrrrrrpaginated_rowss zTable.paginated_rowscCs|S)a Returns a set of HTML class names for cells (both ``td`` and ``th``) of a **bound column** in this table. By default this returns the column class names defined in the table's attributes. This method can be overridden to change the default behavior, for example to simply `return classes_set`. Arguments: classes_set(set of string): a set of class names to be added to the cell, retrieved from the column's attributes. In the case of a header cell (th), this also includes ordering classes. To set the classes for a column, see `.Column`. To configure ordering classes, see :ref:`ordering-class-name` bound_column(`.BoundColumn`): the bound column the class names are determined for. Useful for accessing `bound_column.name`. Returns: A set of class names to be added to cells of this column If you want to add the column names to the list of classes for a column, override this method in your custom table:: class MyTable(tables.Table): ... def get_column_class_names(self, classes_set, bound_column): classes_set = super().get_column_class_names(classes_set, bound_column) classes_set.add(bound_column.name) return classes_set r)rj classes_set bound_columnrrrget_column_class_namess"zTable.get_column_class_names)NNNNNNNNNNNNNNNNNTNr)rKrLrMrNrdrrrrrrpropertyr_setterrVrWrXrrr\r]rrrrarbrcrrrOrrrIrr~sFu -                      r~) metaclassc Csd|i}|dur ||d<|dur||d<|dur||d<t|dr&|jtfntf}td||}|jd}d|i} t|||f| S)a Return Table class for given `model`, equivalent to defining a custom table class:: class MyTable(tables.Table): class Meta: model = model Arguments: model (`~django.db.models.Model`): Model associated with the new table table (`.Table`): Base Table class used to create the new one fields (list of str): Fields displayed in tables exclude (list of str): Fields exclude in tables localize (list of str): Fields to localize r+Nr,r2r5rAutogeneratedTable)r)robjectrtrK) r+rr,r2r5r;parentrrltable_class_attrsrrr table_factorys  r)"r collectionsr itertoolsr django.confrdjango.core.paginatorr django.dbrdjango.template.loaderrdjango.utils.encodingrr^r configr rr rr utilsrrrrrrtrr r~rrrrrs*           YP