Metadata-Version: 2.4
Name: ics
Version: 0.8.0.dev1
Summary: Pythonic iCalendar (RFC 5545) Parser
Project-URL: Homepage, https://pypi.org/project/ics/
Project-URL: Repository, https://github.com/ics-py/ics-py
Project-URL: Documentation, https://icspy.readthedocs.io/en/stable/
Author-email: Nikita Marchant <nikita.marchant@gmail.com>, Niko Fink <icspy@niko.fink.bayern>
License-Expression: Apache-2.0
License-File: AUTHORS.rst
License-File: LICENSE.rst
Keywords: calendar,event,icalendar,ics,rfc5545
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Office/Business :: Scheduling
Classifier: Topic :: Software Development :: Libraries
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: attrs>=20.3
Requires-Dist: ics-vtimezones>=2020.1
Requires-Dist: python-dateutil>=2.8
Provides-Extra: checks
Requires-Dist: flake8>=3.8.1; extra == 'checks'
Requires-Dist: mypy==0.960; extra == 'checks'
Provides-Extra: dev
Requires-Dist: bump2version>=1.0.0; extra == 'dev'
Requires-Dist: tox>=3.25; extra == 'dev'
Provides-Extra: docs
Requires-Dist: sphinx-autodoc-typehints; extra == 'docs'
Requires-Dist: sphinx>=5; extra == 'docs'
Provides-Extra: test
Requires-Dist: freezegun>=1.2.1; extra == 'test'
Requires-Dist: hypothesis>=6; extra == 'test'
Requires-Dist: importlib-resources>=1.4; extra == 'test'
Requires-Dist: pytest-cov>=3; extra == 'test'
Requires-Dist: pytest>=7; extra == 'test'
Requires-Dist: setuptools>=68.2.2; extra == 'test'
Requires-Dist: tatsu>4.2; extra == 'test'
Description-Content-Type: text/x-rst

ics.py `0.8.0.dev1` : iCalendar for Humans
==========================================

`Original repository <https://github.com/ics-py/ics-py>`_ (GitHub) -
`Bugtracker and issues <https://github.com/ics-py/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/pypi/l/ics
    :target: https://pypi.python.org/pypi/ics/
    :alt: Apache 2 License

.. pull-quote::
    You are viewing the README for the current development version on the `main` branch.
    To get the README for the current release, check out its `PyPi page <https://pypi.python.org/pypi/ics/>`_ and the `0.7 branch <https://github.com/ics-py/ics-py/tree/version-0.7>`_ of this repo.

    To install the current development version, you can either use the following pip command or use a (slightly older) `alpha release from PyPi <https://pypi.org/project/ics/0.8.0.dev1/>`_.

    .. code-block:: bash

        pip install git+https://github.com/ics-py/ics-py.git

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.8, 3.9, 3.10, 3.11, 3.12 and is Apache2 Licensed.



Quickstart
----------

.. code-block:: bash

    $ pip install ics

.. code-block:: python

 from datetime import datetime
 from ics import Calendar, Event

 c = Calendar()
 e = Event()
 e.summary = "My cool event"
 e.description = "A meaningful description"
 e.begin = datetime.fromisoformat("2022-06-06T12:05:23+02:00")
 e.end = datetime.fromisoformat("2022-06-06T13:05:23+02:00")
 c.events.append(e)
 c
 # Calendar(extra=Container('VCALENDAR', []), extra_params={}, version='2.0', prodid='ics.py 0.8.0.dev1 - http://git.io/lLljaA', scale=None, method=None, events=[Event(extra=Container('VEVENT', []), extra_params={}, timespan=EventTimespan(begin_time=datetime.datetime(2022, 6, 6, 12, 5, 23, tzinfo=datetime.timezone(datetime.timedelta(seconds=7200))), end_time=None, duration=None, precision='second'), summary=None, uid='ed7975c7-01f1-42eb-bfc4-435afd76b33d@ed79.org', description=None, location=None, url=None, status=None, created=None, last_modified=None, dtstamp=datetime.datetime(2022, 6, 6, 19, 28, 14, 575558, tzinfo=Timezone.from_tzid('UTC')), alarms=[], attach=[], classification=None, transparent=None, organizer=None, geo=None, attendees=[], categories=[])], todos=[])
 with open("my.ics", "w", newline="") as f:
     f.write(c.serialize())

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 <https://icspy.readthedocs.io/en/stable/api.html>`_
* `About <https://icspy.readthedocs.io/en/stable/about.html>`_


Contribute
----------

Contribution are welcome of course! For more information and how to setup, see
`contributing <https://github.com/ics-py/ics-py/blob/master/CONTRIBUTING.rst>`_.


Links
-----
* `rfc5545 <http://tools.ietf.org/html/rfc5545>`_
* `Vulgarised RFC <http://www.kanzaki.com/docs/ical/>`_
* Alternative Libraries: `icalendar <https://github.com/collective/icalendar>`_ and `ical <https://github.com/allenporter/ical>`_

.. image:: http://i.imgur.com/KnSQg48.jpg
    :target: https://github.com/ics-py/ics-py
    :alt: Parse ALL the calendars!
    :align: center
