yaml2ics


Nameyaml2ics JSON
Version 0.2 PyPI version JSON
download
home_pageNone
Summaryyaml2ics
upload_time2023-04-14 05:57:30
maintainerNone
docs_urlNone
authorScientific Python Developers
requires_python>=3.8
licenseNone
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            [![PyPI](https://img.shields.io/pypi/v/yaml2ics)](https://pypi.org/project/yaml2ics/)
[![Test status](https://github.com/scientific-python/yaml2ics/workflows/test/badge.svg?branch=main)](https://github.com/scientific-python/yaml2ics/actions?query=workflow%3A%22test%22)
[![Test coverage](https://codecov.io/gh/scientific-python/yaml2ics/branch/main/graph/badge.svg)](https://app.codecov.io/gh/scientific-python/yaml2ics/branch/main)

# YAML to iCalendar (ics)

| WARNING: this project is still in beta. Beware of breaking changes! |
| ------------------------------------------------------------------- |

Convert YAML files to .ics files which can be imported into other
calendar applications.

Features include:

- Converting single .yaml files, or combining multiple into one .ics
  file.
- ics fields: name, summary, description, location, timezone, repeat
- Specify event start+end or start+duration
- Recurring events (basic support)
- All-day events
- Timezone specification (default or per-event)

## Installation

```
pip install yaml2ics
```

## Usage

To produce a calendar from a list of events:

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

To combine lists of events in to a calendar:

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

## Syntax

Please see `example/test_calendar.yaml` for a full demo including
explanations. Below is a minimal template that shows the basic idea:

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

## Contributing

Contributions are welcomed! This project is still in active development
and should be considered beta.

To install the development version, fork the source of the project and make an
editable install:

```
pip install -e ".[test]"
```

To test:

```
pytest
```

Generate a coverage report with:

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

[black](https://github.com/psf/black) and other linters are used to auto-format
files (and enforced by CI). To install the git hooks, use `pre-commit install`.
To run the tests/auto-formatting manually, use `pre-commit run --all-files`.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "yaml2ics",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": null,
    "author": "Scientific Python Developers",
    "author_email": null,
    "download_url": "https://files.pythonhosted.org/packages/3e/fe/ea7f92a7a0d9f6b9e76fb494de8813f94528db82379d0e7610bd2c3f5c5c/yaml2ics-0.2.tar.gz",
    "platform": null,
    "description": "[![PyPI](https://img.shields.io/pypi/v/yaml2ics)](https://pypi.org/project/yaml2ics/)\n[![Test status](https://github.com/scientific-python/yaml2ics/workflows/test/badge.svg?branch=main)](https://github.com/scientific-python/yaml2ics/actions?query=workflow%3A%22test%22)\n[![Test coverage](https://codecov.io/gh/scientific-python/yaml2ics/branch/main/graph/badge.svg)](https://app.codecov.io/gh/scientific-python/yaml2ics/branch/main)\n\n# YAML to iCalendar (ics)\n\n| WARNING: this project is still in beta. Beware of breaking changes! |\n| ------------------------------------------------------------------- |\n\nConvert YAML files to .ics files which can be imported into other\ncalendar applications.\n\nFeatures include:\n\n- Converting single .yaml files, or combining multiple into one .ics\n  file.\n- ics fields: name, summary, description, location, timezone, repeat\n- Specify event start+end or start+duration\n- Recurring events (basic support)\n- All-day events\n- Timezone specification (default or per-event)\n\n## Installation\n\n```\npip install yaml2ics\n```\n\n## Usage\n\nTo produce a calendar from a list of events:\n\n```\npython yaml2ics.py example/test_calendar.yaml\n```\n\nTo combine lists of events in to a calendar:\n\n```\npython yaml2ics.py example/test_calendar.yaml example/another_calendar.yaml\n```\n\n## Syntax\n\nPlease see `example/test_calendar.yaml` for a full demo including\nexplanations. Below is a minimal template that shows the basic idea:\n\n```yaml\nname: Calendar Name\ntimezone: Europe/Helsinki # default timezone for events, optional\n\nevents:\n  - summary: The event title\n    begin: 2021-09-21 15:00:00\n    duration:\n      minutes: 30\n    location: |\n      https://meet.jit.si/example\n    description: |\n      In this meeting we will ...\n```\n\n## Contributing\n\nContributions are welcomed! This project is still in active development\nand should be considered beta.\n\nTo install the development version, fork the source of the project and make an\neditable install:\n\n```\npip install -e \".[test]\"\n```\n\nTo test:\n\n```\npytest\n```\n\nGenerate a coverage report with:\n\n```\npytest --cov-report term-missing --cov yaml2ics\n```\n\n[black](https://github.com/psf/black) and other linters are used to auto-format\nfiles (and enforced by CI). To install the git hooks, use `pre-commit install`.\nTo run the tests/auto-formatting manually, use `pre-commit run --all-files`.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "yaml2ics",
    "version": "0.2",
    "split_keywords": [],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "b93b9f08a240f3def0079dd1e4d96db1dc65d115be023a9523a27a2e66e9099b",
                "md5": "96d4be38af7b2ae0605ad13cbb8a6695",
                "sha256": "980b13fa7fa1d5007cc077d8b81aca18b6f6110a31154a44a406b7063484c018"
            },
            "downloads": -1,
            "filename": "yaml2ics-0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "96d4be38af7b2ae0605ad13cbb8a6695",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 5695,
            "upload_time": "2023-04-14T05:57:25",
            "upload_time_iso_8601": "2023-04-14T05:57:25.257008Z",
            "url": "https://files.pythonhosted.org/packages/b9/3b/9f08a240f3def0079dd1e4d96db1dc65d115be023a9523a27a2e66e9099b/yaml2ics-0.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "3efeea7f92a7a0d9f6b9e76fb494de8813f94528db82379d0e7610bd2c3f5c5c",
                "md5": "765ab91818b701149e94c46693e81e1a",
                "sha256": "6811af98878b479de58846ce68be7da4b20eeafea438181e8592a859bb78ed94"
            },
            "downloads": -1,
            "filename": "yaml2ics-0.2.tar.gz",
            "has_sig": false,
            "md5_digest": "765ab91818b701149e94c46693e81e1a",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 8986,
            "upload_time": "2023-04-14T05:57:30",
            "upload_time_iso_8601": "2023-04-14T05:57:30.018846Z",
            "url": "https://files.pythonhosted.org/packages/3e/fe/ea7f92a7a0d9f6b9e76fb494de8813f94528db82379d0e7610bd2c3f5c5c/yaml2ics-0.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2023-04-14 05:57:30",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "yaml2ics"
}
        
Elapsed time: 0.08169s