Metadata-Version: 1.1
Name: ics
Version: 0.1.2
Summary: Python icalendar (rfc5545) parser
Home-page: http://github.com/C4ptainCrunch/ics.py
Author: Nikita Marchant
Author-email: nikita.marchant@gmail.com
License: Apache License, Version 2.0
Description: Ics.py : iCalendar for Humans
        =============================
        
        (Release 0.1.1)
        
        Ics.py is a pythonic and easy iCalendar (rfc5545) library. It's goals are to read and write ics data in a developper-friendly way.
        
        It is written in Python (>=2.7 and >=3.3) and is Apache2 Licensed .
        
        iCalendar is complicated, you don't like RFCs but you want/have to use the ics format and you love pythonic APIs ? ics.py is for you !
        
        Quickstart
        ----------
        
        
        Install using `pip <http://www.pip-installer.org/>`_.
        ::
        
            $ pip install ics
        
        
        Import a calendar from a file
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        .. code-block:: python
        
            from ics import Calendar
            from urllib2 import urlopen # import requests
            url = "http://hackeragenda.urlab.be/events/events.ics"
            c = Calendar(urlopen(url).read().decode('iso-8859-1'))
            # could also use 'requests' here
            # c = Calendar(requests.get(url).text)
            c
            >>> <Calendar with 42 events>
        
            c.events
            >>> [<Event 'SmartMonday #1' begin:2013-12-13 20:00:00 end:2013-12-13 23:00:00>,
            >>> <Event 'RFID workshop' begin:2013-12-06 12:00:00 end:2013-12-06 19:00:00>,
            >>> ...]
        
            e = c.events[10]
        
            "Event '{}' started {}".format(e.name, e.begin.humanize())
            >>> "Event 'Mitch Altman soldering workshop' started 6 days ago"
        
        
        Create a new calendar and add events
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        .. code-block:: python
        
            c = Calendar()
            e = Event()
            e.name = "My cool event"
            e.begin = '20140101 00:00:00'
            c.events.append(e)
        
            c.events
            >>> [<Event 'My cool event' begin:2014-01-01 00:00:00 end:2014-01-01 00:00:01>]
        
        Export a Calendar to a file
        ^^^^^^^^^^^^^^^^^^^^^^^^^^^
        
        .. code-block:: python
        
            with open('my.ics', 'w') as f:
                f.writelines(c)
            # And it's done !
        
        iCalendar-formatted data is also available in a string
        
        .. code-block:: python
        
            str(c)
            >>> 'BEGIN:VCALENDAR\nPRODID:...
        
        
        License
        -------
        ics.py is under the Apache 2 software license because... bah ! Why not ?
        
        	Copyright 2013 Nikita Marchant
        
        	Licensed under the Apache License, Version 2.0 (the "License");
        	you may not use this file except in compliance with the License.
        	You may obtain a copy of the License at
        
        	http://www.apache.org/licenses/LICENSE-2.0
        
        	Unless required by applicable law or agreed to in writing, software
        	distributed under the License is distributed on an "AS IS" BASIS,
        	WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        	See the License for the specific language governing permissions and
        	limitations under the License.
        
        ics.py uses heavily arrow (Apache license) and python-dateutil (GPL licensed).
        
        ics.py includes also something like 10 lines of arrow's code (in utils.iso_precision) which are ©Chris Smith. Thanks to him!
Keywords: ics icalendar calendar event todo rfc5545 parser pythonic
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Topic :: Software Development :: Libraries
Classifier: Intended Audience :: Developers
Classifier: Topic :: Office/Business :: Scheduling
