upstream/ipython Files · IPython/utils/tz.py

docs/autogen_shortcuts.py: support Python 3.8...

docs/autogen_shortcuts.py: support Python 3.8 In 64e72a955 (Restore shortcuts in documentation, define identifiers, 2023-01-08), some typing annotations were added to docs/autogen_shortcuts.py using the builtin container type 'list'. This feature is only available starting in Python 3.9 [1], but setup.cfg lists Python 3.8 as the earliest supported Python version. This leads to a failing documentation build in a Python 3.8 virtual environment. Fix this by using the capitalized name 'List' from the 'typing' module to keep Python 3.8 compatibility. [1] https://docs.python.org/3/whatsnew/3.9.html#type-hinting-generics-in-standard-collections

Matthias Bussonnier - - Load All Authors

File last commit:

r28167:008777fa


                r28181:2c9a826a

Download file

             tz.py
        
                    48 lines
            
             | 1.3 KiB
            
                | text/x-python
            
             |
                PythonLexer
            
             / IPython / utils / tz.py
          
                    History
                
                 |
                  Annotation
                 | Raw
                 |Copy content
                 |Copy permalink

      # encoding: utf-8

      """

      Timezone utilities

      Just UTC-awareness right now

      """

      #-----------------------------------------------------------------------------

      #  Copyright (C) 2013 The IPython Development Team

      #

      #  Distributed under the terms of the BSD License.  The full license is in

      #  the file COPYING, distributed as part of this software.

      #-----------------------------------------------------------------------------

      #-----------------------------------------------------------------------------

      # Imports

      #-----------------------------------------------------------------------------

      from datetime import tzinfo, timedelta, datetime

      #-----------------------------------------------------------------------------

      # Code

      #-----------------------------------------------------------------------------

      # constant for zero offset

      ZERO = timedelta(0)

      class tzUTC(tzinfo):

          """tzinfo object for UTC (zero offset)"""

          def utcoffset(self, d):

              return ZERO

          def dst(self, d):

              return ZERO

      UTC = tzUTC()  # type: ignore[abstract]

      def utc_aware(unaware):

          """decorator for adding UTC tzinfo to datetime's utcfoo methods"""

          def utc_method(*args, **kwargs):

              dt = unaware(*args, **kwargs)

              return dt.replace(tzinfo=UTC)

          return utc_method

      utcfromtimestamp = utc_aware(datetime.utcfromtimestamp)

      utcnow = utc_aware(datetime.utcnow)

	Site-wide shortcuts
/	Use quick search box
g h	Goto home page
g g	Goto my private gists page
g G	Goto my public gists page
g 0-9	Goto bookmarked items from 0-9
n r	New repository page
n g	New gist page

	Repositories
g s	Goto summary page
g c	Goto changelog page
g f	Goto files page
g F	Goto files page with file search activated
g p	Goto pull requests page
g o	Goto repository settings
g O	Goto repository access permissions settings
t s	Toggle sidebar on some pages

				# encoding: utf-8
				"""
				Timezone utilities

				Just UTC-awareness right now
				"""

				#-----------------------------------------------------------------------------
				# Copyright (C) 2013 The IPython Development Team
				#
				# Distributed under the terms of the BSD License. The full license is in
				# the file COPYING, distributed as part of this software.
				#-----------------------------------------------------------------------------

				#-----------------------------------------------------------------------------
				# Imports
				#-----------------------------------------------------------------------------

				from datetime import tzinfo, timedelta, datetime

				#-----------------------------------------------------------------------------
				# Code
				#-----------------------------------------------------------------------------
				# constant for zero offset
				ZERO = timedelta(0)

				class tzUTC(tzinfo):
				"""tzinfo object for UTC (zero offset)"""

				def utcoffset(self, d):
				return ZERO

				def dst(self, d):
				return ZERO


				UTC = tzUTC() # type: ignore[abstract]


				def utc_aware(unaware):
				"""decorator for adding UTC tzinfo to datetime's utcfoo methods"""
				def utc_method(args, *kwargs):
				dt = unaware(args, *kwargs)
				return dt.replace(tzinfo=UTC)
				return utc_method

				utcfromtimestamp = utc_aware(datetime.utcfromtimestamp)
				utcnow = utc_aware(datetime.utcnow)