intranet.utils package

Submodules

intranet.utils.admin_helpers module

intranet.utils.admin_helpers.export_csv_action(description='Export selected objects as CSV file', fields=None, exclude=None, header=True)

This function returns an export csv action.

‘fields’ and ‘exclude’ work like in django

ModelForm ‘header’ is whether or not to output the column names as the first row.

https://djangosnippets.org/snippets/2369/

intranet.utils.cache module

class intranet.utils.cache.DummyCache(host, *args, **kwargs)

Bases: django.core.cache.backends.dummy.DummyCache

delete_pattern(key, version=None)

intranet.utils.date module

intranet.utils.date.get_date_range_this_year(now=None)

Return the starting and ending date of the current school year.

intranet.utils.date.is_current_year(date)

intranet.utils.deletion module

intranet.utils.deletion.handle_eighth_sponsor_deletion(in_obj, eighth_sponsor)

intranet.utils.deletion.set_historical_user(collector, field, sub_objs, using)

intranet.utils.helpers module

class intranet.utils.helpers.GlobList

Bases: list

A list of glob-style strings.

__contains__(key)

Check if a string matches a glob in the list.

class intranet.utils.helpers.InvalidString

Bases: str

An error for undefined context variables in templates.

class intranet.utils.helpers.MigrationMock

Bases: object

seen = {}

intranet.utils.helpers.dark_mode_enabled(request)

intranet.utils.helpers.debug_toolbar_callback(request)

Show the debug toolbar to those with the Django staff permission, excluding the Eighth Period office.

intranet.utils.helpers.get_ap_week_warning(request)

intranet.utils.helpers.get_current_commit_date()

intranet.utils.helpers.get_current_commit_github_url(workdir)

intranet.utils.helpers.get_current_commit_info()

intranet.utils.helpers.get_current_commit_long_hash(workdir)

intranet.utils.helpers.get_current_commit_short_hash(workdir)

intranet.utils.helpers.get_fcps_emerg(request)

Return FCPS emergency information.

intranet.utils.helpers.get_id(obj)

intranet.utils.helpers.is_entirely_digit(digit_str)

intranet.utils.helpers.join_nicely(items: Collection) → str

Joins together a list of items in a human-readable format. Examples: >>> join_nicely([]) ‘’ >>> join_nicely([‘a’]) ‘a’ >>> join_nicely([‘a’, ‘b’]) ‘a and b’ >>> join_nicely([‘a’, ‘b’, ‘c’]) ‘a, b, and c’

Parameters

items – The items to join together.

Returns

The resulting joined-together string.

intranet.utils.helpers.parse_db_url(db_url)

intranet.utils.helpers.single_css_map(name)

intranet.utils.html module

intranet.utils.html.link_removal_callback(attrs: Mapping[Union[str, Tuple[Optional[str]]], str], new: bool = False) → Optional[Mapping[Union[str, Tuple[Optional[str]]], str]]

Internal callback for nullify_links().

intranet.utils.html.nullify_links(text: str) → str

Given a string containing HTML, changes the href attribute of any links to “javascript:void(0)” to render the link useless.

Parameters

text – The HTML string in which links should be nullified.

Returns

The HTML string with all links nullified.

intranet.utils.html.safe_fcps_emerg_html(text: str, base_url: str) → str

intranet.utils.html.safe_html(txt)

intranet.utils.locking module

intranet.utils.locking.lock_on(items: Iterable[Union[django.db.models.base.Model, django.db.models.manager.Manager, django.db.models.query.QuerySet]]) → None

Given an iterable of Model instances, ``Manager``s, and/or ``QuerySet``s, locks the corresponding database rows.

More specifically, this uses the Django ORM’s select_for_update() method, which translates to a SELECT FOR UPDATE SQL query. For more information on what this actually does in PostgreSQL (used as the database backend in all environments) see PostgreSQL’s documentation on locking at https://www.postgresql.org/docs/current/explicit-locking.html#LOCKING-ROWS.

As described in Django’s documentation at https://docs.djangoproject.com/en/stable/ref/models/queryset/#django.db.models.query.QuerySet.select_for_update, the select_for_update locks prevent other transactions from acquiring locks until this transaction is complete.

This MUST by run in a transaction. A straightforward way to do this is to use the django.db.transaction.atomic wrapper.

Parameters

items – An iterable of Model instances, ``Manager``s, and/or ``QuerySet``s representing the database rows to lock.

intranet.utils.serialization module

intranet.utils.serialization.safe_json(obj)

intranet.utils.session module

class intranet.utils.session.SessionStore(session_key=None)

Bases: redis_sessions.session.SessionStore

load()

Module contents