Metadata-Version: 1.1
Name: bda.calendar.base
Version: 1.2.2
Summary: Base common calendaring features: Convinience or not coverd yet.
Home-page: http://svn.plone.org/svn/collective/bda.calendar.base
Author: Jens Klein, Robert Niedereiter
Author-email: dev@bluedynamics.com
License: General Public Licence
Description: ==========================================================
        Convinience for Datetime handling in combination with Zope
        ==========================================================
        
        ``bda.calendar.base`` contains functions adressing programmers all-day tasks
        not (or only partly) covered by pythons datetime or zopes DateTime.
        
        Major part of these function is timezone aware. Also ist easy to deal with 
        timezones. An TimezoneFactory can be provided in the specific application
        to i.e. be aware of the users timezone (i.e. in case of webapps).
        
        
        calculators
        -----------
        
        CWof(date)
            the calendar week number of a date.
            
        firstDayOfCW(year, cw, tzinfo=None)
            first day of a numbered calendar week
            
        daysOfWeek(year, cw, tzinfo=None)
            yields 7 datetimes of the given calendar week
            
        numberOfDaysInYear(dt)
            calculate number of day of the year of the given datetime year
                   
        numberOfDaysInMonth(dt)           
            calculates number of days of the given datetimes month 
        
        daysOfMonth    
            yields all days as datetimes of the given month
            
        hoursOfDay(year, month, day, tzinfo=None)
            yields all hours of a day as datetimes    
            
        isSameDay(first, second)    
            detects if two dates are the same day. bool.
            
        
        converter
        ---------
        
        dt2DT(dt)
            Convert Python's datetime to Zope's DateTime. Acts timezone-aware.
            
        DT2dt(DT)
            Convert Zope's DateTime to Pythons's datetime. Acts timezone-neutral, 
            outcome is on UTC.
            
        dt2UTCString(dt)
            build a '-' separated string from the datetime timetuple as UTC.
            
        dtFromUTCString(utcstr)
            build datetime from timetuple UTC string.
            
        dt2epochday(dt)
           Number of days since epoch.  
           timezone gets a problem here, we need to normalize all to GMT to make it 
           recognize the same day even if it a different timezone:
           i.e. 2008-05-01T00:00:00+02:00 (CEST) 
        
        
        inspector
        ---------
        
        All functions are using the timezoneAdjuster (see below). therefore a context is 
        passed
         
        dtYear(dt, context=None):
            year of datetime.
            
        dtMonth(dt, context=None)
            month of datetime.
        
        dtDay(dt, context=None)
            day of datetime.
        
        dtHour(dt, context=None)
            hour of datetime.
        
        dtMinute(dt, context=None)
            minute of datetime.
            
        dtWeekday(dt, context=None)
            Weekday of datetime.
            
        pyDt
            Detect wether dt is instance of datetime object.
        
          
        recurring
        ---------
        
        Simple recurring features. for more sophisticated recurring feature refer to
        dateutils.rrule
        
        recueDays(start, until, recuemode, offset)
            Generates list of recue days.    
        
        
        timezone
        --------
        
        Dealing with timezones is always pain. With these common features it get less 
        pain. Using ZCA where registering a common ``TimezoneFactory`` using the computers 
        system timezone. It is used by the ``timezoneAdjuster``. If you register a more 
        specific TimezoneFactory following its simple interface - its just a callable -
        , you can implement user configurated multi-timezone aware applications.
        This is all based on pytz, because pytz just works.
        
        ServerTimezoneFactory(context)
            The timezone of the server (current computer). You never need to use this 
            directly.
        
        timezoneAdjuster(context, dt)
            New datetime with given timezone. Given datetime cant be naive!
            
        tzawarenow()
            timezone aware ``now`` datetime using utc timezone. if you need 
            the current timezone adjust it.
        
        
        Credits, License
        ================
        
          * Copyright 2008-2010, BlueDynamics Alliance, Austria
          
          * Conception and Coding
            * Jens Klein <jens@bluedynamics.com>
            * Robert Niederreiter <rnix@squarewave.at>
            
          * under the GNU General Public License 2.0
        
        
        History
        =======
        
        1.2.2
        -----
        
        - conditional ZCML for pyramid and zope.
          [rnix, 2011-11-16]
        
Keywords: Calendaring
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Web Environment
Classifier: Framework :: Zope2
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Topic :: Internet :: WWW/HTTP :: Dynamic Content
