RememberMe

RememberMe is a robust but simple state memory machine organizer. It operates similar to Redis, but with the added capability to schedule and define the number of times a function will be executed, and of course, save any values associated with an assimilated key.

Introduction
Examples
Installation
Usage
Contributing
License

Introduction

RememberMe is a utility module that provides an efficient and user-friendly way to manage state memory. It allows you to store and retrieve data using keys, schedule functions for execution, and more. It's particularly useful for scenarios where you need to handle state persistence and time-based function execution.

Examples

Storing Values

# Store a value in memory with a key
RememberMe.guard("text_deleted", %{"user" => "Foo", "text" => "A any message"}, min: 2)
# Result: :ok

Retrieving Values

# Retrieve a previously stored value using the key
value = RememberMe.find_value("text_deleted")
# Result: %{"user" => "Foo", "text" => "A any message"}

Scheduling Function Execution

Schedule a function for execution after a certain time

RememberMe.exec_func(fn -> IO.puts "Hello World!" end, [sec: 10, repeat: 3])
# Result: :ok
# Output:
# Hello World!
# Hello World!
# ... (repeated three times)

Installation

RememberMe can be installed by adding it as a dependency in your mix.exs file:

defp deps do
  [
    {:remember_me, "~> 0.0.2"}
  ]
end

After adding the dependency, run `mix deps.get`` to fetch and install it.

Usage

RememberMe provides the following functions for managing memory and function execution:

guard/3

This function stores a value in memory using a key and optional options for time duration.

RememberMe.guard(name_state, value, opts \\ [])

name_state: The key used to identify the stored value.
value: The data you want to store.
opts: Additional options (e.g., min, sec, hour) to define the time duration the value should be stored.

find_value/1

This function retrieves a previously stored value from memory using a key.

RememberMe.find_value(name_state)

name_state: The key used to identify the stored value.

exec_func/2

This function schedules a function for execution after a specified time and optionally defines the number of times the function should be repeated.

RememberMe.exec_func(fun, opts \\ [])

fun: The function you want to schedule for execution.
opts: Additional options (e.g., min, sec, hour, repeat) to define the execution time and repetition count of the function.

For more information on available options and usage examples, refer to the Examples section above.

Contributing

Contributions are welcome! If you encounter any issues or have suggestions for improvements, please feel free to open an issue or submit a pull request on the GitHub repository.

License

This project is licensed under the MIT License.

AlefMach/remember_me