Metadata-Version: 1.1
Name: ics
Version: 0.7
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
        =============================
        
        `Original repository <https://github.com/C4ptainCrunch/ics.py>`_ (GitHub) -
        `Bugtracker and issues <https://github.com/C4ptainCrunch/ics.py/issues>`_ (GitHub) -
        `PyPi package <https://pypi.python.org/pypi/ics/>`_ (ics) -
        `Documentation <http://icspy.readthedocs.org/>`_ (Read The Docs).
        
        
        .. image:: https://img.shields.io/github/license/c4ptaincrunch/ics.py.svg
            :target: https://pypi.python.org/pypi/ics/
            :alt: Apache 2 License
        
        
        Ics.py is a pythonic and easy iCalendar library.
        Its goals are to read and write ics data in a developer friendly way.
        
        iCalendar is a widely-used and useful format but not user friendly.
        Ics.py is there to give you the ability of creating and reading this
        format without any knowledge of it.
        
        It should be able to parse every calendar that respects the
        `rfc5545 <http://tools.ietf.org/html/rfc5545>`_ and maybe some more…
        It also outputs rfc compliant calendars.
        
        iCalendar (file extension `.ics`) is used by Google Calendar,
        Apple Calendar, Android and many more.
        
        
        Ics.py is available for Python>=3.6 and is Apache2 Licensed.
        
        
        
        Quickstart
        ----------
        
        .. code-block:: bash
        
            $ pip install ics
        
        
        
        .. code-block:: python
        
            from ics import Calendar, Event
            c = Calendar()
            e = Event()
            e.name = "My cool event"
            e.begin = '2014-01-01 00:00:00'
            c.events.add(e)
            c.events
            # [<Event 'My cool event' begin:2014-01-01 00:00:00 end:2014-01-01 00:00:01>]
            with open('my.ics', 'w') as my_file:
                my_file.writelines(c)
            # and it's done !
        
        More examples are available in the
        `documentation <http://icspy.readthedocs.org/>`_.
        
        Documentation
        -------------
        
        All the `documentation <http://icspy.readthedocs.org/>`_ is hosted on
        `readthedocs.org <http://readthedocs.org/>`_ and is updated automatically
        at every commit.
        
        * `Quickstart <http://icspy.readthedocs.org/>`_
        * `API <http://icspy.readthedocs.org/en/latest/api.html>`_
        * `About <http://icspy.readthedocs.org/en/latest/about.html>`_
        
        
        Contribute
        ----------
        
        Contribution are welcome of course! For more information, see
        `contributing <https://github.com/C4ptainCrunch/ics.py/blob/master/CONTRIBUTING.rst>`_.
        
        
        Testing & Docs
        --------------
        
        .. code-block:: bash
        
            # setup virtual environment
            $ sudo pip install virtualenv
            $ virtualenv ve
            $ source ve/bin/activate
        
            # tests
            $ pip install -r requirements.txt
            $ pip install -r dev/requirements-test.txt
            $ python setup.py test
        
            # tests coverage
            $ pip install -r requirements.txt
            $ pip install -r dev/requirements-test.txt
            $ python setup.py test
            $ coverage html
            $ firefox htmlcov/index.html
        
            # docs
            $ pip install -r requirements.txt
            $ pip install -r dev/requirements-doc.txt
            $ cd doc
            $ make html
        
        
        Links
        -----
        * `rfc5545 <http://tools.ietf.org/html/rfc5545>`_
        * `Vulgarised RFC <http://www.kanzaki.com/docs/ical/>`_
        
        .. image:: http://i.imgur.com/KnSQg48.jpg
            :target: https://github.com/C4ptainCrunch/ics.py
            :alt: Parse ALL the calendars!
            :align: center
        
Keywords: ics icalendar calendar event todo rfc5545 parser pythonic
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Intended Audience :: Developers
Classifier: Topic :: Office/Business :: Scheduling
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Typing :: Typed
