Lock

Tooz provides distributed locks. A lock is identified by a name, and a lock can only be acquired by one coordinator at a time.

# Copyright (C) 2020 Red Hat, Inc.
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#    http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
# implied.
# See the License for the specific language governing permissions and
# limitations under the License.

from tooz import coordination

coordinator = coordination.get_coordinator('zake://', b'host-1')
coordinator.start()

# Create a lock
lock = coordinator.get_lock("foobar")
with lock:
    print("Do something that is distributed")

coordinator.stop()

The method tooz.coordination.CoordinationDriver.get_lock() allows to create a lock identified by a name. Once you retrieve this lock, you can use it as a context manager or use the tooz.locking.Lock.acquire() and tooz.locking.Lock.release() methods to acquire and release the lock.