YAML到iCalendar (ics)

将YAML文件转换为可以导入到其他日历应用程序的.ics文件。

功能包括

• 转换单个.yaml文件，或将多个文件合并为一个.ics文件。
• ics字段：名称、摘要、描述、位置、时区、重复
• 指定事件开始+结束或开始+持续时间
• 重复事件（基本支持）
• 全天事件
• 时区指定（默认或按事件指定）

安装

pip install yaml2ics

使用方法

从事件列表生成日历

python yaml2ics.py example/test_calendar.yaml

将事件列表组合成日历

python yaml2ics.py example/test_calendar.yaml example/another_calendar.yaml

语法

请参阅example/test_calendar.yaml以获取完整演示，包括说明。以下是展示基本概念的简化模板：

name: Calendar Name
timezone: Europe/Helsinki # default timezone for events, optional

events:
  - summary: The event title
    begin: 2021-09-21 15:00:00
    duration:
      minutes: 30
    location: |
      https://meet.jit.si/example
    description: |
      In this meeting we will ...

贡献

欢迎贡献！此项目仍在积极开发中，应被视为测试版。

要安装开发版本，请分支项目源并创建可编辑安装

pip install -e ".[test]"

测试

pytest

使用以下工具生成覆盖率报告

pytest --cov-report term-missing --cov yaml2ics

black和其他代码格式化工具用于自动格式化文件（并由CI强制执行）。要安装git钩子，使用pre-commit install。要手动运行测试/自动格式化，使用pre-commit run --all-files。