<commit_before>==========================================================
Internet Calendaring and Scheduling (iCalendar) for Python
==========================================================

The `icalendar`_ package is a parser/generator of iCalendar files for use
with Python.


About this fork
===============

.. warning::

    This part should be removed actual before release.

Aim of this fork is to bring this package up to date with latest RFC
specification as part of `plone.app.event`_ project which aims is to bring
recurrence evens to `Plone`_.

Current plan:

    1. Merge bugfixes from forks listed bellow.
    2. Contact all interested and try to get release 2.2 out.
    3. Start working on 3.0 to bring package up-to-date with newer iCalendar
       specification (`RFC 5545`_), while keeping 2.X series compatible with
       `RFC 2445`_.

Known forks:

 - https://codespeak.net/svn/iCalendar/trunk/
   The original codespeak repo, which this branch is based on (keeping it up to
   date in ``svn-trunk`` branch)

 - https://github.com/cozi/icalendar
   The icalendar fork of the Cozi group with many fixes and additions. 
   Especially ``master-future`` branch is interesting.

 - https://github.com/greut/iCalendar
   Another repository. All changes except the one from commit
   #5166fa914593d8366044 were integrated into the cozi fork.

 - https://github.com/ryba-xek/iCalendar
   Another repo which fixes an Unicode issue with folding. Integrated into
   cozi.

 - https://github.com/1calendar/icalendar
   Same as above.

 - https://bitbucket.org/psagers/icalendar
   Another repo which fixes something also integrated in greut's repo, but not
   in cozi's. Not sure if we need it.


.. _`icalendar`: http://pypi.python.org/pypi/icalendar
.. _`plone.app.event`: http://github.com/collective/plone.app.event
.. _`Plone`: http://plone.org
.. _`RFC 5545`: http://www.ietf.org/rfc/rfc5545.txt
.. _`RFC 2445`: http://www.ietf.org/rfc/rfc2445.txt



.. warning::

    Below is content of previous README.



Introduction
============

I (<NAME>) have often needed to parse and generate iCalendar
files. Finally I got tired of writing ad-hoc tools.

So this is my attempt at making an iCalendar package for Python. The
inspiration has come from the email package in the standard lib, which
I think is pretty simple, yet efficient and powerful.

The package can both generate and parse iCalendar files, and can
easily be used as is.
<commit_msg>some formatting of README<commit_after>==========================================================
Internet Calendaring and Scheduling (iCalendar) for Python
==========================================================

The `icalendar`_ package is a parser/generator of iCalendar files for use
with Python.


About this fork
===============

.. warning::

    This part should be removed actual before release.

Aim of this fork is to bring this package up to date with latest RFC
specification as part of `plone.app.event`_ project which aims is to bring
recurrence evens to `Plone`_.

Current plan
------------

    1. Merge bugfixes from forks listed bellow.
    2. Contact all interested and try to get release 2.2 out.
    3. Start working on 3.0 to bring package up-to-date with newer iCalendar
       specification (`RFC 5545`_), while keeping 2.X series compatible with
       `RFC 2445`_.

Known forks
-----------

 - https://codespeak.net/svn/iCalendar/trunk/
   The original codespeak repo, which this branch is based on (keeping it up to
   date in ``svn-trunk`` branch)

 - https://github.com/cozi/icalendar
   The icalendar fork of the Cozi group with many fixes and additions. 
   Especially ``master-future`` branch is interesting.

 - https://github.com/greut/iCalendar
   Another repository. All changes except the one from commit
   #5166fa914593d8366044 were integrated into the cozi fork.

 - https://github.com/ryba-xek/iCalendar
   Another repo which fixes an Unicode issue with folding. Integrated into
   cozi.

 - https://github.com/1calendar/icalendar
   Same as above.

 - https://bitbucket.org/psagers/icalendar
   Another repo which fixes something also integrated in greut's repo, but not
   in cozi's. Not sure if we need it.


.. _`icalendar`: http://pypi.python.org/pypi/icalendar
.. _`plone.app.event`: http://github.com/collective/plone.app.event
.. _`Plone`: http://plone.org
.. _`RFC 5545`: http://www.ietf.org/rfc/rfc5545.txt
.. _`RFC 2445`: http://www.ietf.org/rfc/rfc2445.txt








.. warning::

    Below is content of previous README.



Introduction
============

I (<NAME>) have often needed to parse and generate iCalendar
files. Finally I got tired of writing ad-hoc tools.

So this is my attempt at making an iCalendar package for Python. The
inspiration has come from the email package in the standard lib, which
I think is pretty simple, yet efficient and powerful.

The package can both generate and parse iCalendar files, and can
easily be used as is.

{'fraction_non_alphanumeric': 0.1391461941200161, 'fraction_numerical': 0.02013693113169553, 'mean_word_length': 3.5736648250460403, 'pattern_counts': {'":': 0, '<': 5, '<?xml version=': 0, '>': 5, 'https://': 12, 'lorem ipsum': 0, 'www.': 4, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '3766065', 'n_tokens_mistral': 1549, 'n_tokens_neox': 1388, 'n_words': 581}