Custom PyAMS utilities¶
+PyAMS_utils provides a small set of utilities. You can create some of them as global utilities registered in +the global components registry; other ones can be created manually by a site administrator and +are then registered automatically.
+Server timezone¶
+To manage timezones correctly, and display datetimes based on current server timezone, all datetimes should +be defined and stored in UTC.
+PyAMS_utils provides a ServerTimezoneUtility which
+allows you to assign a default timezone to your server.
To display a datetime with correct timezone, you can use the tztime function,
+which assign server timezone to the given parameter:
from datetime import datetime
+from pyams_utils.timezone import tztime
+
+now = datetime.utcnow()
+my_date = tztime(now) # converts *now* to server timezone
+We could imagine that datetimes could be displayed with current user timezone. But it’s quite impossible to know +the user timazone from a server request. The only options are:
+-
+
- you ask an authenticated user to update a timezone setting in his profile +
- you can include Javascript libraries which will try to detect browser timezone from their computer configuration, and +do an AJAX request to update data in their session. +
That should require an update of tzinfo() adapter to get timezone info from session, request or user profile.
ZEO connection¶
+Several PyAMS utilities (like the tasks scheduler or the medias converter) are working with dedicated processes, +are connected to main PyAMS process through ØMQ, and use ZEO connections for their PyAMS database access.
+Clients of these processes have to send settings of the ZEO connections that they should use.
+The ZEOConnection utility can be created by the site manager through the web management interface (ZMI) from the +Control panel:
+
+ZEO connection creation form allows you to define all settings of a ZEO connection:
+
+