Giter VIP home page Giter VIP logo

icalendarparser's Introduction

iCalendarParser

A RFC 5545 compatible parser for iCalendar files in Swift.

Installation

To use iCalendarParser just add it as Swift Package Manager dependency:

via Xcode

Open your project, click on File โ†’ Add Packages, enter the repository URL (https://github.com/dmail-me/iCalendarParser.git), and add the package product to your app target.

via SPM Package.swift

dependencies: [
    .package(
      name: "iCalendarParser",
      url: "https://github.com/dmail-me/iCalendarParser",
      from: "0.1.0"
    )
]

Usage

To get started with iCalendarParser, all you have to do is to import it and use its ICParser type to convert any ICS file into iCalendar object:

import iCalendarParser

let rawICS: String = ...
let parser = ICParser()
let calendar: ICalendar? = parser.calendar(from: rawICS)

Is it production ready?

iCalendarParser is currently not feature complete yet. While it requires an additional implementation to be fully compatible with RFC5545, we appreciate contributions from the community to help us improve the library.

However, it's worth noting that the library is being used in production within the Dmail.me app, and we are committed to constantly improving it.

TODO

  • Parse To-Do, Journal, Free/Busy, and Alarm components
  • Add additional properties in ICEvent

Contributing

Contributions to iCalendarParser are welcomed and encouraged!

License

iCalendarParser is available under the MIT license. See LICENSE for more information.

Credits

icalendarparser's People

Contributors

hannojg avatar redryerye avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar

icalendarparser's Issues

if not 24-Hour Time, dates are nil

Thanks for this library! Saved me a ton of work.
The issue I found is:
If the on-device Date & Time setting 24-Hour Time is not on, it fails to parse dates.
The date fields (dstart, dend) in ICEvent, are all nil, except dtimestamp which gets a value by default if nil.
IMG_0013

Event is missing RRULE property

Hey, thanks for this awesome library!

The event is currently missing the rrule property. I see that code for parsing it is there but currently it's only used with timezones.

If I find time this week I'll spin up a PR and add it ๐Ÿ˜Š ๐Ÿ‘

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.