Metadata-Version: 2.1
Name: aircal
Version: 0.1.1
Summary: Export and visualize Airflow DAG runs as events in Google calendar.
Home-page: http://github.com/domenp/aircal
Author: Domen Pogacnik
License: MIT
Description: # Aircal
        
        Aircal is a library that exports future DAG runs as events to Google Calendar.
        
        ![DAG run visualization](https://user-images.githubusercontent.com/6691247/80535228-c28cc700-89a0-11ea-8cdc-0050a3c91298.png)
        
        Having DAG run as events in the calendar may help you:
        - visualize the utilization of your airflow workers to better spread your jobs
        - determine when a certain DAG should be finished to monitor the service.
        
        The library will also observe the changes to your DAGs and synchronize it with the calendar:
        - add runs for the freshly added DAGs
        - change start and/or end time when an existing DAG changes the schedule (or the execution time changes significantly)
        - delete run events when a DAG is removed (or paused)
        
        Tip: run the sync script regularly, perhaps, with you know, Airflow :)
        
        The library only support DAG schedules that use the standard cron syntax. The rest will be ignored (with a warning).
        
        **Warning: This is an beta stage software. Expect occassional bugs and rough edges (PR welcome).**
        
        ## Installation & setup
        
        ```
        pip install aircal
        ```
        
        Alternatively you can clone the repo and install it from there:
        
        ```
        pip install -e .
        ```
        
        Google API credentials are required to create events in the calendar. You can obtain them [here](https://console.developers.google.com/apis/credentials). Store `credentials.json` into a directory accessible by your code.
        
        **The library is modifying and deleting calendar events. I highly recommend creating a new calendar to be used by this software:** "add calendar" -> "create new calendar" in Google calendar settings.
        
        ## Usage
        
        See `example.py` for an example of the potential pipeline that can be run on the regular intervals.
        
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: Development Status :: 3 - Alpha
Description-Content-Type: text/markdown
