Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

ics.py 0.8.0-dev0 : iCalendar for Humans

Original repository (GitHub) - Bugtracker and issues (GitHub) - PyPi package (ics) - Documentation (Read The Docs).

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

Quickstart

$ pip install ics
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-dev0 - 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") as f:
    f.write(c.serialize())

More examples are available in the documentation.

Documentation

All the documentation is hosted on readthedocs.org and is updated automatically at every commit.

Contribute

Contribution are welcome of course! For more information and how to setup, see contributing.

Metadata

Release files for ics 0.8.0.dev0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for ics 0.8.0.dev0
File Size Uploaded
ics-0.8.0.dev0.tar.gz 297.8 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for ics 0.8.0.dev0
File Interpreter ABI Platform
ics-0.8.0.dev0-py3-none-any.whl Python 3 none any Details

Total release size: 358.6 kB

Release files / ics-0.8.0.dev0.tar.gz

Download URL ics-0.8.0.dev0.tar.gz
Size 297.8 kB
Tags Source
SHA-256 checksum
How to use checksums
51169026b9368e88abf167e7a86cb39c576299d7c36a871f1a39e36beabcfcae
BLAKE2b-256 checksum
How to use checksums
d49ed551e7429876a59ca0ae66f41664e09f2a403d6eb18047388741c68486c0
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.13

Release files / ics-0.8.0.dev0-py3-none-any.whl

Download URL ics-0.8.0.dev0-py3-none-any.whl
Size 60.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7b78a02d3aa7e7143f27ff9072390cbda5795839f59fd09bd2f404932b49eaf6
BLAKE2b-256 checksum
How to use checksums
4b7a510a6aa44638923bc1b46ad4f529169875fe744da92ad44cf274c80c1779
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/4.0.1 CPython/3.9.13

Release history Release notifications | RSS feed

This release

0.8.0.dev0 This release

2 release files

0.7.3

2 release files

0.7.2

3 release files

0.7.1

3 release files

0.7

3 release files

0.6

2 release files

0.5

2 release files

0.4

4 release files

0.3.1

4 release files

0.3

3 release files

0.2

4 release files

0.1.3

1 release file

0.1.2

1 release file

0.1.1

1 release file

0.1

indev

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page