Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Keep the server's raw bytes, and allow sending given bytes unchanged

オープン
#763 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

まだ誰も着手していません。

評価

難易度
5/5
見積もり時間
1週間以上
初心者へのやさしさ
35/100
issue の種類
機能追加
明瞭さ
おおむね明確
活発さ
活発
技術スタック
python
領域
backend

調査の方向性

Start with _set_data() around line 1760 in calendarobjectresource.py and trace the GET, calendar-query, calendar-multiget, and save paths that call it or normalize data with vcal.fix(). The issue leaves the API shape open, so first read the linked calendaring design and compare these paths. Done means preserving the received bytes and offering an opt-in to send supplied bytes unchanged while retaining conditional request handling.

索引モデルが issue の本文から書いたものです。

説明

enhancement

Disclaimer: AI-generated text below the line, generated by Claude Opus 5.5 (Claude Code), from the prompt:

Open the issue in the caldav library [comment made in a code-review document, on a finding that caldav's wire_data is not the bytes the server sent]


Low priority. Needed by the calendaring library's proposed Item.wire (https://github.com/pycalendar/calendaring, docs/design/API_DESIGN.md, "The stored form"), and by sync tools such as https://github.com/pycalendar/calendaring-sync, which compare and push the bytes a server stores.

Today a CalendarObjectResource cannot give back what the server sent:

  • _set_data() runs the incoming data through vcal.fix() before storing it in _data (calendarobjectresource.py, around line 1760), so the raw response body is gone right after parsing the response.
  • wire_data re-encodes _data (or serialises icalendar_instance / vobject_instance after an edit), so it is caldav's normalised copy, not the server's bytes, and not a snapshot of what was read.
  • When saving, the same path normalises bytes the caller passes in, so "store exactly these bytes" is not possible either.

Suggested shape (open for discussion):

  • Keep the unmodified response body of the last GET / calendar-query / calendar-multiget in a read-only attribute (e.g. raw_data), cleared by any write or local edit, next to the etag it belongs to.
  • An opt-in to send given bytes without vcal.fix() (e.g. save(raw=True), or setting raw_data before save()), still with If-Match / If-None-Match.

vcal.fix() stays the default; this is only about not throwing the original away.

主要言語
Python
スター
412
フォーク
113
平均マージ
1日 2時間
マージ済み PR(30日)
41

環境構築

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

python-caldav/caldav のほかの issue

python-caldav/caldav の issue をすべて見る

似ている issue

Python の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。