Metadata-Version: 2.1
Name: icalcli
Version: 0.9.8
Summary: Icalendar Calendar Command Line Interface
Home-page: https://github.com/jrvarma/icalcli
Maintainer: Jayanth R. Varma
Maintainer-email: jrvarma@gmail.com
License: UNKNOWN
Description: # icalcli
        
        ### An iCalendar Command Line Interface
        
        `icalcli` - a modification of [gcalcli](https://github.com/insanum/gcalcli) - is a Python command line front-end to your Calendar. It allows you to get your agenda, view weekly and monthly calendars (ascii text graphical calendar), search for events, add new events, delete events, and edit events. 
        
        Unlike [gcalcli](https://github.com/insanum/gcalcli) which is tied to Google Calendar, `icalcli` is agnostic to (abstracts away from) the actual backend calendar service. It relies on a backend interface which interacts with the backend calendar to perform all the CRUD (Create, Retrieve, Update and Delete) operations on the actual calendar. The package includes two backends:
        
        * The `etesync_backend` subpackage provides a backend interface to the [EteSync](https://www.etesync.com/) calendar. In fact, `icalcli` was created primarily to provide a command line interface to my self hosted `EteSync` calendar.
        
        * The `file_backend` subpackage provides a backend interface to a calendar contained in a local `ics` file. This is useful as a viewer/editor of `ics` files. It is also useful to try out `icalci` without having any other backend configured.
        
        The two included backends would also be useful to those who wish to write their own backend interfaces. `icalcli` requires the calendar to be presented to it as a list of [icalendar](https://github.com/collective/icalendar) events (`VEVENT`). It is the responsibility of the backend interface to read the actual calendar and create this list of events. It must also perform all the CRUD (Create, Retrieve, Update and Delete) operations on the actual calendar.
        
        
        ## Requirements
        
        * [Python](http://www.python.org) (3+)
        * [dateutil](http://www.labix.org/python-dateutil)
        * [parsedatetime](https://github.com/bear/parsedatetime)
        * [icalendar](https://github.com/collective/icalendar)
        * A love for the command line!
        
        ### Optional packages
        
        * [pyetesync](https://github.com/etesync/pyetesync) the python client library for `EteSync` if you want to use the `EteSync` backend.
        
        ## Installation
        
        ### Install from PyPI
        
        ```sh
        pip install icalcli
        ```
        
        ### Install from source
        
        ```sh
        git clone https://github.com/jrvarma/icalcli.git
        cd icalcli
        python setup.py install
        ```
        ## Usage
        
        ### Command line arguments
        
        `icalcli` provides a series of subcommands with the following functionality:
        
            edit (e)               edit calendar events
            agenda (g)             get an agenda for a time period
            calw (w)               get a week-based agenda in calendar format
            calm (m)               get a month agenda in calendar format
            add (a)                add a detailed event to the calendar
            search (s)             (regex) search for events 
            sync (y)               sync the backend calendar
            quit (q)               quit icalcli
        
        By default, `icalcli` runs interactively as an REPL (Read Evaluate Print Loop). Run `icalcli --help` for more details. `icalcli <subcommand> --help` gives help on each subcommand.
        
        ### Configuration Script
        
        In the beginning, `icalcli` executes a configuration script which is expected to create the object `backend_interface` representing the backend interface initialized with the right authentication credentials to access the backend calendar. The configuration script is located, by default, at `~/.icalcli.py`, but this can be changed with the `-c` option.
        
        #### Example configuration for file_backend
        
        ```
        from icalcli import ICSInterface
        
        backend_interface = ICSInterface("/path/to/ics-file")
        
        ```
        
        #### Example configuration for etesync_backend
        
        This configuration assumes that all the credentials are stored in a plain text (`json`) file. In practice, you would use a more secure storage (perhaps, the `Gnome keyring`) or just read it from the terminal.
        
        ```
        from icalcli import EtesyncInterface
        import base64
        import json
        
        conf_file = '/path/to/json-file'
        with open(conf_file, 'r') as fp:
            c = json.load(fp)
        backend_interface = EtesyncInterface(
            c['email'], c['userPassword'], c['remoteUrl'],
            c['uid'], c['authToken'],
            base64.decodebytes(c['cipher_key'].encode('ascii')))
        ```
        
        ## Screenshots
        
        Some screenshots are available at Github:
        
        #### Agenda and Week Views
        
        ![Agenda and Week Views]( https://github.com/jrvarma/icalcli/raw/master/screenshots/icalci-0-agenda-week-views.png)
        
        #### Adding an event
        
        ![Adding an event](https://github.com/jrvarma/icalcli/raw/master/screenshots/icalci-1-add-event.png) 
        
        #### Searching and editing events
        
        ![Searching and editing events](https://github.com/jrvarma/icalcli/raw/master/screenshots/icalci-2-search-edit-event.png)
        
        #### Multi-day events
        
        ![Multi-day events](https://github.com/jrvarma/icalcli/raw/master/screenshots/icalci-3-multi-day-event.png)
        
        #### Month View
        
        ![Month View](https://github.com/jrvarma/icalcli/raw/master/screenshots/icalci-4-month-view.png)
        
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Provides-Extra: parsedatetime
