airflow-calendar 0.5.0

A sleek, Google Calendar-inspired global view for Apache Airflow DAGs.

📅 Airflow Calendar

A sleek, intuitive, and modern calendar interface for visualizing your global DAG schedule in Apache Airflow. Stop guessing when your DAGs will run; see them all in a high-fidelity time grid inspired by the Google Calendar experience.

---

✨ Key Features

• Global Timeline View: Visualize all your DAG schedules in clear weekly or daily grids, making it easy to spot execution windows and potential load spikes.
• Smart Info-Popup: Instant access to critical DAG run details upon clicking an event.
  • Displays Execution Time, Cron Expression, Estimated Duration, and Last Status.
• Intelligent Viewport Positioning: The popup automatically detects screen edges and flips its position (up/down/left/right) to prevent being cut off by the browser window or taskbar.
• Dynamic Precision: Maintains close proximity to the mouse cursor for a better UX while ensuring no empty gaps between the event and the info card.
• Color-Coded Status: Immediate visual identification of success, failure, or "no-run" states through dynamic colors and borders.
• Native Deep Linking: Directly jump to the native Airflow Grid View for any specific DAG with a single click.

---

🚀 Installation

The recommended way to install Airflow Calendar is via pip to ensure all templates and metadata are correctly registered.

# Clone the repository
git clone [https://github.com/your-user/airflow-calendar.git](https://github.com/your-user/airflow-calendar.git)
cd airflow-calendar

# Install the package
pip install .

Roadmap

This project is still in its early stages, and there are many improvements planned for the future. Some of the features we're considering include:

• Change event colors based on Dag Tags.
• Search page to filter specific events and DAGs.
• Add a visual DAG execution history.

If you’d like to suggest a feature or report a bug, please open a new issue!

Contributing

This project is open to contributions! If you want to collaborate to improve the tool, please follow these steps:

1. Open a new issue to discuss the feature or bug you want to address.
2. Once approved, fork the repository and create a new branch.
3. Implement the changes.
4. Create a pull request with a detailed description of the changes.