ics.py

Pythonic and easy iCalendar library (rfc5545)

Github星跟踪图

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://travis-ci.org/C4ptainCrunch/ics.py.png?branch=master
:target: https://travis-ci.org/C4ptainCrunch/ics.py

.. 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
  • 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

主要指标

概览
名称与所有者ics-py/ics-py
主编程语言Python
编程语言Python (语言数: 1)
平台
许可证Other
所有者活动
创建于2013-10-25 11:51:40
推送于2024-12-06 12:51:23
最后一次提交
发布数14
最新版本名称v0.8.0-dev0 (发布于 2022-08-18 23:46:51)
第一版名称v0.1 (发布于 2013-12-26 22:25:24)
用户参与
星数697
关注者数14
派生数129
提交数661
已启用问题?
问题数231
打开的问题数45
拉请求数129
打开的拉请求数5
关闭的拉请求数45
项目设置
已启用Wiki?
已存档?
是复刻?
已锁定?
是镜像?
是私有?