Acquire.ObjectStore._encoding module

bytes_to_string(b)

Return the passed binary bytes safely encoded to a base64 utf-8 string

string_to_bytes(s)

Return the passed base64 utf-8 encoded binary data back converted from a string back to bytes. Note that this can only convert strings that were encoded using bytes_to_string - you cannot use this to convert arbitrary strings to bytes

string_to_encoded(s)

Return the passed unicode string encoded to a safely encoded base64 utf-8 string

encoded_to_string(b)

Return the passed encoded base64 utf-8 string converted back into a unicode string

url_to_encoded(url)

Return an encoding of the passed url that is safe to use as a name, filename or key in an object store

encoded_to_url(e)

Decode the passed encoded data back to the URL. This will only produce valid output for inputs created using url_to_encoded

decimal_to_string(d)

Return the passed decimal number encoded as a string that can be safely serialised via json

string_to_decimal(s)

Return the decimal that had been encoded via ‘decimal_to_string’. This string must have been created via ‘decimal_to_string’

datetime_to_string(d)

Return the passed datetime encoded to a string. This will be a standard iso-formatted time in the UTC timezone (converting to UTC if the passed datetime is for another timezone)

string_to_datetime(s)

Return the datetime that had been encoded to the passed string via datetime_to_string. This string must have been created via ‘datetime_to_string’

date_to_string(d)

Return the date that has been encoded to a string. This will write the date as a standard iso-formatted date. IF a datetime is passed then this will be in the UTC timezone (converting to UTC if the passed datetime is for another timezone)

string_to_date(s)

Return a date from the string that has been encoded using ‘date_to_string’. This is only guaranteed to work for strings that were created using that function

time_to_string(t)

Return the time that has been encoded to a string. This will write the time as a standard iso-formatted time. If a datetime is passed then this will be in the UTC timezone (converting to UTC if the passed datetime is for another timezone)

string_to_time(s)

Return a time from the string that was encoded by ‘time_to_string’. This will only be guaranteed to produce valid output for strings produced using that function

get_datetime_now()

Return the current time in the UTC timezone. This creates an object that will be properly stored using datetime_to_string and string_to_datetime

datetime_to_datetime(d)

Return the passed datetime as a datetime that is clean and usable by Acquire. This will move the datetime to UTC, adding the timezone if this is missing

string_to_safestring(s)

Return a safe (base64) encoded version of ‘s’. This string has no special characters or spaces, thereby making it safe for use, e.g. as a filename or to save in a database

safestring_to_string(s)

Return the original string encoded by string_to_safestring

string_to_list(s, C)

Convert the string encoded using list_to_string back to a list of objects of type C. Note that all objects must have the same type

list_to_string(l)

Return the passed list of items converted to a json string. All items should have the same type

string_to_dict(s, C)

Convert the string encoded using dict_to_string back to a dict of objects of type C. Note that all objects must have the same type

dict_to_string(d)

Return the passed dict of items converted to a json string. All items should have the same type

string_to_filepath(path)

This function cleans the passed path so that doesn’t contain redundant slashes or ‘..’ etc., so that all backslashes are forwards slashes, and that the trailing slash is removed

string_to_filepath_parts(path)

Break the passed path into a list of the individual parts, e.g. /home/user/test/../something/./new.txt will return

[‘home’, ‘user’, ‘something’, ‘new.txt’]

get_datetime_future(weeks=0, days=0, hours=0, minutes=0, seconds=0, timedelta=None)

Return the datetime that is the supplied time in the future. This will raise an exception if the time is not in the future!

get_datetime_now_to_string()

Convenience function that returns the result of get_datetime_now as a string converted via datetime_to_string

date_and_time_to_datetime(date, time=datetime.time(0, 0))

Return the passed date and time as a UTC datetime. By default the time is midnight (first second of the day)

create_uuid()

Return a newly created random uuid. This is highly likely to be globally unique