icalendar/README.rst

==========================================================
Internet Calendaring and Scheduling (iCalendar) for Python
==========================================================

The `icalendar`_ package is a `RFC 5545`_ compatible parser/generator for iCalendar
files.

----

:Homepage: https://icalendar.readthedocs.io
:Code: https://github.com/collective/icalendar
:Mailing list: https://github.com/collective/icalendar/issues
:Dependencies: `python-dateutil`_ and `pytz`_.
:Compatible with: Python 2.7 and 3.4+
:License: `BSD`_

----


.. image:: https://travis-ci.org/collective/icalendar.svg?branch=master
    :target: https://travis-ci.org/collective/icalendar


.. _`icalendar`: https://pypi.org/project/icalendar/
.. _`RFC 5545`: https://www.ietf.org/rfc/rfc5545.txt
.. _`python-dateutil`: https://github.com/dateutil/dateutil/
.. _`pytz`: https://pypi.org/project/pytz/
.. _`BSD`: https://github.com/collective/icalendar/issues/2


Related projects
================

* `icalevents <https://github.com/irgangla/icalevents>`_. It is built on top of icalendar and allows you to query iCal files and get the events happening on specific dates. It manages recurrent events as well.
* `recurring-ical-events <https://pypi.org/project/recurring-ical-events/>`_. Library to query an ``ICalendar`` object for events happening at a certain date or within a certain time.
* `x-wr-timezone <https://pypi.org/project/x-wr-timezone/>`_. Library to make ``ICalendar`` objects and files using the non-standard ``X-WR-TIMEZONE`` comlpliant with the standard (RFC 5545).
adding description about this fork 2011-08-17 21:40:23 +00:00			`==========================================================`
			`Internet Calendaring and Scheduling (iCalendar) for Python`
			`==========================================================`

prepare release 2017-11-08 13:00:36 +00:00			The `icalendar`_ package is a `RFC 5545`_ compatible parser/generator for iCalendar
			`files.`
adding description about this fork 2011-08-17 21:40:23 +00:00
adding final touches for the first version of docs ... more needed ofcourse 2011-08-18 01:57:17 +00:00			`----`

readme: Touch up 2017-06-25 02:54:04 +00:00			`:Homepage: https://icalendar.readthedocs.io`
			`:Code: https://github.com/collective/icalendar`
			`:Mailing list: https://github.com/collective/icalendar/issues`
readme: Remove unnecessary indentation (#225) 2017-06-19 17:46:34 +00:00			:Dependencies: `python-dateutil`_ and `pytz`_.
Drop support for Python 2.6 and 3.3 I would humbly like to suggest icalendar drop support for Python 2.6. The last release of Python 2.6 was 2013-10-29. It is no longer receiving security or bug fixes. https://www.python.org/dev/peps/pep-0361/ The pip project itself has decided to drop support for 2.6. At the beginning of the year, their numbers estimated that Python 2.6 accounts for ~2% of their downloads. https://github.com/pypa/pip/pull/4343 For projects that still use Python 2.6, they can continue to pip install an older version. I've tried my best to remove as much 2.6 specific code as I can, including the 'Programming Language :: Python :: 2.6' trove classifier from setup.py. I've also removed Travis CI testing, which should result in slightly faster testing and fewer wasted resources. Changed: * Update documented Python support and trove classifiers * Update Travis test matrix and tox test matrix * Use set literals (and more literals in general) * Use dict comprehension * Remove dependencies on ordereddict and unittest2 * Remove u string prefix, use more modern unicode literals instead 2017-10-22 21:07:19 +00:00			`:Compatible with: Python 2.7 and 3.4+`
readme: Remove unnecessary indentation (#225) 2017-06-19 17:46:34 +00:00			:License: `BSD`_
adding final touches for the first version of docs ... more needed ofcourse 2011-08-18 01:57:17 +00:00
			`----`
adding description about this fork 2011-08-17 21:40:23 +00:00
endure correct datatype at instance creation time in ``prop.vCalAddress`` and ``prop.vText``. Re-include doctests. 2012-08-23 11:45:16 +00:00
More fixes for Travis Also add 3.4 for testing and a badge to the README 2014-06-03 15:49:09 +00:00			`.. image:: https://travis-ci.org/collective/icalendar.svg?branch=master`
			`:target: https://travis-ci.org/collective/icalendar`


Update all pypi.python.org URLs to pypi.org For details on the new PyPI, see the blog post: https://pythoninsider.blogspot.ca/2018/04/new-pypi-launched-legacy-pypi-shutting.html 2018-04-26 13:16:27 +00:00			.. _`icalendar`: https://pypi.org/project/icalendar/
prepare release 2017-11-08 13:00:36 +00:00			.. _`RFC 5545`: https://www.ietf.org/rfc/rfc5545.txt
Drop requirement for setuptools package from setup.py setuptools is shipped with Python, no need to include it as a requirement. Further, it is not used by the icalendar package, but only by setup.py. setuptools is imported by setup.py _before_ dependencies have been installed. 2017-01-24 01:59:01 +00:00			.. _`python-dateutil`: https://github.com/dateutil/dateutil/
Update all pypi.python.org URLs to pypi.org For details on the new PyPI, see the blog post: https://pythoninsider.blogspot.ca/2018/04/new-pypi-launched-legacy-pypi-shutting.html 2018-04-26 13:16:27 +00:00			.. _`pytz`: https://pypi.org/project/pytz/
relicensing which was discussed and fixes #2 2012-02-27 09:22:43 +00:00			.. _`BSD`: https://github.com/collective/icalendar/issues/2
Update README.rst Added icalevents as related project. Fixes #257 2018-01-29 19:09:22 +00:00

			`Related projects`
			`================`

			* `icalevents <https://github.com/irgangla/icalevents>`_. It is built on top of icalendar and allows you to query iCal files and get the events happening on specific dates. It manages recurrent events as well.
add links to two libraries that build on top of icalendar 2022-06-23 10:19:55 +00:00			* `recurring-ical-events <https://pypi.org/project/recurring-ical-events/>`_. Library to query an ``ICalendar`` object for events happening at a certain date or within a certain time.
			* `x-wr-timezone <https://pypi.org/project/x-wr-timezone/>`_. Library to make ``ICalendar`` objects and files using the non-standard ``X-WR-TIMEZONE`` comlpliant with the standard (RFC 5545).