.. SPDX-FileCopyrightText: 2026 calendaring-sync contributors
.. SPDX-License-Identifier: AGPL-3.0-or-later

==================
Record local edits
==================

.. meta::
   :description: Record each change your application makes, so the next sync sends it to the server.

Record each change your application makes as you make it, and the next sync sends it.

Create and change
=================

.. literalinclude:: ../examples/local_edits.py
   :language: python
   :start-after: # start: record
   :end-before: # end: record

:meth:`~calendaring_sync.adapters.base.SyncAdapter.create` returns the new :term:`record`'s :term:`local key`, which stays the same once the server gives the object an id. Edits go through the adapter, which reads their fingerprint the same way it reads the server's copy.

Undo an edit
============

.. literalinclude:: ../examples/local_edits.py
   :language: python
   :start-after: # start: undo
   :end-before: # end: undo

:meth:`~calendaring_sync.replica.Replica.discard` drops an edit the server hasn't received.

Delete
======

.. literalinclude:: ../examples/local_edits.py
   :language: python
   :start-after: # start: delete
   :end-before: # end: delete

An event with an open :term:`conflict` takes no edit until you resolve it, as :doc:`conflicts` shows.