other_headers Property

Other headers as determined by the user (optional).

Syntax

def get_other_headers() -> str: ...
def set_other_headers(value: str) -> None: ...

other_headers = property(get_other_headers, set_other_headers)

Default Value

""

Remarks

This property can be set to a string of headers to be appended to the HTTP request headers created from other properties like content_type, from_, etc.

The headers must be of the format "header: value" as described in the HTTP specifications. Header lines should be separated by CRLF ("\r\n") .

Use this property with caution. If this property contains invalid headers, HTTP requests may fail.

This property is useful for extending the functionality of the class beyond what is provided.

For CalDAV, the "If-Match" header is extremely useful. After adding a an event with put_calendar_event or retrieving an event with get_calendar_event, the e_tag property will contain a value indicating the current state of the event. If you wish to update the event, you may pass this returned e_tag in an "If-Match" header. If the event on the server has been modified since you retrieved it (and the ETag on the server has changed), then the put_calendar_event will fail with an HTTP Protocol Error: "409 Conflict", which indicates there is a conflict between the version you're trying to update and the current version on the sever. For instance:

  calDAV.OtherHeaders = "If-Match: 1900-1900\r\ n";