from datetime import datetime, timedelta import pytz from flask import url_for from sqlalchemy import func from notifications_utils.timezones import convert_utc_to_bst from notifications_utils.template import ( SMSMessageTemplate, HTMLEmailTemplate, LetterPrintTemplate, BroadcastMessageTemplate, ) from app import DATETIME_FORMAT local_timezone = pytz.timezone("Europe/London") def pagination_links(pagination, endpoint, **kwargs): if 'page' in kwargs: kwargs.pop('page', None) links = {} if pagination.has_prev: links['prev'] = url_for(endpoint, page=pagination.prev_num, **kwargs) if pagination.has_next: links['next'] = url_for(endpoint, page=pagination.next_num, **kwargs) links['last'] = url_for(endpoint, page=pagination.pages, **kwargs) return links def url_with_token(data, url, config, base_url=None): from notifications_utils.url_safe_token import generate_token token = generate_token(data, config['SECRET_KEY'], config['DANGEROUS_SALT']) base_url = (base_url or config['ADMIN_BASE_URL']) + url return base_url + token def get_template_instance(template, values): from app.models import SMS_TYPE, EMAIL_TYPE, LETTER_TYPE, BROADCAST_TYPE return { SMS_TYPE: SMSMessageTemplate, EMAIL_TYPE: HTMLEmailTemplate, LETTER_TYPE: LetterPrintTemplate, BROADCAST_TYPE: BroadcastMessageTemplate, }[template['template_type']](template, values) def get_london_midnight_in_utc(date): """ This function converts date to midnight as BST (British Standard Time) to UTC, the tzinfo is lastly removed from the datetime because the database stores the timestamps without timezone. :param date: the day to calculate the London midnight in UTC for :return: the datetime of London midnight in UTC, for example 2016-06-17 = 2016-06-16 23:00:00 """ return local_timezone.localize(datetime.combine(date, datetime.min.time())).astimezone( pytz.UTC).replace( tzinfo=None) def get_midnight_for_day_before(date): day_before = date - timedelta(1) return get_london_midnight_in_utc(day_before) def get_london_month_from_utc_column(column): """ Where queries need to count notifications by month it needs to be the month in BST (British Summer Time). The database stores all timestamps as UTC without the timezone. - First set the timezone on created_at to UTC - then convert the timezone to BST (or Europe/London) - lastly truncate the datetime to month with which we can group queries """ return func.date_trunc( "month", func.timezone("Europe/London", func.timezone("UTC", column)) ) def get_public_notify_type_text(notify_type, plural=False): from app.models import (SMS_TYPE, BROADCAST_TYPE, UPLOAD_DOCUMENT, PRECOMPILED_LETTER) notify_type_text = notify_type if notify_type == SMS_TYPE: notify_type_text = 'text message' elif notify_type == UPLOAD_DOCUMENT: notify_type_text = 'document' elif notify_type == PRECOMPILED_LETTER: notify_type_text = 'precompiled letter' elif notify_type == BROADCAST_TYPE: notify_type_text = 'broadcast message' return '{}{}'.format(notify_type_text, 's' if plural else '') def midnight_n_days_ago(number_of_days): """ Returns midnight a number of days ago. Takes care of daylight savings etc. """ return get_london_midnight_in_utc(datetime.utcnow() - timedelta(days=number_of_days)) def escape_special_characters(string): for special_character in ('\\', '_', '%', '/'): string = string.replace( special_character, r'\{}'.format(special_character) ) return string def email_address_is_nhs(email_address): return email_address.lower().endswith(( '@nhs.uk', '@nhs.net', '.nhs.uk', '.nhs.net', )) def get_notification_table_to_use(service, notification_type, process_day, has_delete_task_run): """ Work out what table will contain notification data for a service by looking up their data retention. Make sure that when you run this you think about whether the delete task has run for that day! If it's run, the notifications from that day will have moved to NotificationHistory. The delete tasks run between 4 and 5am every morning. """ from app.models import Notification, NotificationHistory data_retention = service.data_retention.get(notification_type) days_of_retention = data_retention.days_of_retention if data_retention else 7 todays_bst_date = convert_utc_to_bst(datetime.utcnow()).date() days_ago = todays_bst_date - process_day if not has_delete_task_run: # if the task hasn't run yet, we've got an extra day of data in the notification table so can go back an extra # day before looking at NotificationHistory days_of_retention += 1 return Notification if days_ago <= timedelta(days=days_of_retention) else NotificationHistory def get_archived_db_column_value(column): date = datetime.utcnow().strftime("%Y-%m-%d") return f'_archived_{date}_{column}' def get_dt_string_or_none(val): return val.strftime(DATETIME_FORMAT) if val else None