redis-init-zero 2025.9.13174

a function that recieve the key and redis connection string and then: 1. check if key doesnt exist then to create this key with value 0 2. …

redis_init_zero

A Python package to initialize a Redis key with a value of 0 if the key does not already exist.

Installation

To install redis_init_zero, use pip:

pip install redis_init_zero

Usage

Using redis_init_zero is straightforward. You need to provide the Redis connection string and the key you want to initialize.

from redis_init_zero import initialize_key_if_not_exists

# Replace with your actual Redis connection string
REDIS_CONNECTION_STRING = "redis://localhost:6379/0"
KEY_TO_INITIALIZE = "my_counter"

# Initialize the key if it doesn't exist
was_initialized = initialize_key_if_not_exists(REDIS_CONNECTION_STRING, KEY_TO_INITIALIZE)

if was_initialized:
    print(f"Key '{KEY_TO_INITIALIZE}' was initialized to 0.")
else:
    print(f"Key '{KEY_TO_INITIALIZE}' already exists.")

# Example demonstrating it only initializes once
was_initialized_again = initialize_key_if_not_exists(REDIS_CONNECTION_STRING, KEY_TO_INITIALIZE)
if not was_initialized_again:
    print(f"Key '{KEY_TO_INITIALIZE}' was not re-initialized.")

Functionality

• initialize_key_if_not_exists(redis_connection_string: str, key: str) -> bool:
  • Connects to the Redis server using the provided connection string.
  • Checks if the specified key exists.
  • If the key does not exist, it sets the key's value to 0 and returns True.
  • If the key already exists, it does nothing and returns False.

Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page.

License

redis_init_zero is licensed under the MIT License.

Author

Eugene Evstafev [e-mail]