This release is a pre-release and may not be stable for production use.
Nautobot Calendars App
Overview
A calendaring/scheduling app for Nautobot. It can be used (but not limited to) to define and assign maintenance or blackout schedules to an object (ex: Device). It uses a subset of RFC 5545 for specifying recurring date/times.
Nautobot Calendars relies on these libraries:
- The
rrulemodule of dateutil as the implementation of the recurrence rules. - FullCalendar to display event calendars in the Nautobot UI.
Concepts
Calendars (or schedules) are rules that include or exclude time for various actions or tasks. They can be used to specify maintenance or blackout windows, service level agreements or inactivity monitors, or on-call rotations.
Calendar type
A calendar type describes the purpose of the schedule. There are two pre-built types:
- Maintenance Window: A pre-scheduled, time-boxed period during which technical staff perform system updates, hardware repairs, or infrastructure maintenance.
- Blackout Window: A defined period where system changes, updates, or maintenance are strictly prohibited.
Calendar
A calendar is a collection of related events, along with additional metadata such as name and description.
Events
An event is an object associated with a specific date or time range. Besides a start and end date-time, events contain other data such as title, description, organizer, etc. Nautobot Calendar supports single and recurring events:
- A single event represents a unique occurrence.
- A recurring event defines multiple occurrences.
Recurrence rule
A recurrence rule contains fields representing one or several RRULE properties as defined in RFC 5545.
The RRULE property is the most important as it defines a regular rule for repeating the event. It is composed of the following components:
FREQ: The frequency with which the event should be repeated (such asDAILYorWEEKLY). Required.UNTIL: The date or date-time until which the event should be repeated (inclusive).COUNT: Number of times this event should be repeated. You can use eitherCOUNTorUNTILto specify the end of the event recurrence. Don't use both in the same rule.INTERVAL: Works together withFREQto specify how often the event should be repeated. For example,FREQ=DAILY;INTERVAL=2means once every two days.BYDAY: Days of the week on which the event should be repeated (SU,MO,TU, etc.). Other similar components includeBYSECOND,BYMINUTE,BYHOUR,BYMONTHDAY,BYYEARDAY,BYWEEKNO,BYMONTHandBYSETPOS.WKST: The day on which the workweek starts. Valid values areMO,TU,WE,TH,FR,SA, andSU.
Screenshots
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file nautobot_calendars-1.0.0rc0.tar.gz.
File metadata
- Download URL: nautobot_calendars-1.0.0rc0.tar.gz
- Upload date:
- Size: 13.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
a615ffd7d4394070a12e3290c3f77fe375d16a8d1b880d657cef39b1ab15e3df
|
|
| MD5 |
63dbb1ccb16a2e46947a7e16c5f964bf
|
|
| BLAKE2b-256 |
2a398e5cb6b8c8aa494c9e2f4345ff2a8bbcdc85a6cc36df0eb137cb98d633ef
|
Provenance
The following attestation bundles were made for nautobot_calendars-1.0.0rc0.tar.gz:
Publisher:
release.yml on erjac77/nautobot-apps
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
nautobot_calendars-1.0.0rc0.tar.gz -
Subject digest:
a615ffd7d4394070a12e3290c3f77fe375d16a8d1b880d657cef39b1ab15e3df - Sigstore transparency entry: 2446838108
- Sigstore integration time:
-
Permalink:
erjac77/nautobot-apps@56ff2d468a8237e025a74372aabfda521b2ea26f -
Branch / Tag:
refs/heads/main - Owner: https://github.com/erjac77
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@56ff2d468a8237e025a74372aabfda521b2ea26f -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file nautobot_calendars-1.0.0rc0-py3-none-any.whl.
File metadata
- Download URL: nautobot_calendars-1.0.0rc0-py3-none-any.whl
- Upload date:
- Size: 20.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
899b8180efd57d60397188a2b18e438f32c1b83894904689b10e479baa2f81c1
|
|
| MD5 |
5ca3fcfbf476d49901481f67f89c1973
|
|
| BLAKE2b-256 |
609eb5be90027767c26e2532988c4fca54aa315eace3ed593657016a9ecec9cf
|
Provenance
The following attestation bundles were made for nautobot_calendars-1.0.0rc0-py3-none-any.whl:
Publisher:
release.yml on erjac77/nautobot-apps
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
nautobot_calendars-1.0.0rc0-py3-none-any.whl -
Subject digest:
899b8180efd57d60397188a2b18e438f32c1b83894904689b10e479baa2f81c1 - Sigstore transparency entry: 2446838753
- Sigstore integration time:
-
Permalink:
erjac77/nautobot-apps@56ff2d468a8237e025a74372aabfda521b2ea26f -
Branch / Tag:
refs/heads/main - Owner: https://github.com/erjac77
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@56ff2d468a8237e025a74372aabfda521b2ea26f -
Trigger Event:
workflow_dispatch
-
Statement type: