Apero

Pure utility library for Elixir — no shell execution. Provides file operations, cryptography, environment/config handling, retry, cache, and pure OS/Proc introspection.

Shell-based operations (Docker, Git, SSH, K8s, Compress, Network, OS arch/kernel/memory, Proc ps/kill/lsof, File watch) moved to Trebejo v1.0.0.

Quick Start

def deps do
  [
    {:apero, "~> 4.0"}
  ]
end

Modules

File & Path

Apero.File.dir?("lib")                                    # => true
Apero.File.file?("mix.exs")                               # => true
Apero.File.read("config.json")                            # => {:ok, content}
Apero.File.write("out.txt", "hello")                      # => :ok
Apero.File.atomic_write("out.txt", "atomic!")             # => :ok
Apero.File.checksum("mix.exs", :sha256)                   # => {:ok, digest}
Apero.File.copy("a.txt", "b.txt")                         # => {:ok, bytes}
Apero.File.generate_tree(["lib/", "test/"])               # => ASCII tree

Cryptography

Apero.Crypto.sha256("data")                               # => hex digest
Apero.Crypto.random_hex(16)                               # => random token
*`sha256/1`, `sha512/1`, and `md5/1` results are now cached in ETS for faster repeated calls.*
key = Apero.Crypto.generate_key()                          # 32-byte AES key
{:ok, ct} = Apero.Crypto.encrypt("secret", key)           # AES-256-GCM
{:ok, pt} = Apero.Crypto.decrypt(ct, key)

Environment & Config

Apero.Env.load(".env")                                    # load .env file
Apero.Conf.load("app.yaml")                               # {:ok, config}

Cache

Apero.Cache.put(:my_cache, :key, "value")
{:ok, value} = Apero.Cache.get(:my_cache, :key)

Retry

Apero.Retry.with(fn -> Api.call() end, max_retries: 3)

OS & Proc (pure subset)

Apero.OS.type()                                           # => :linux | :macos | :windows
Apero.OS.hostname()                                       # => "myhost"
Apero.Proc.command_exists?("git")                         # => true
Apero.Proc.vm_memory()                                    # => bytes

Architecture

apero (pure stdlib)
  ├── File        — path ops, atomic I/O, trees, watcher GenServer
  ├── Crypto      — hashing (SHA-256/512, MD5), AES encryption, keys
  ├── Env / Conf  — environment variables, config files (JSON, YAML, TOML)
  ├── Cache       — in-memory ETS with TTL
  ├── Retry       — configurable retry with backoff
  ├── OS          — type detection, hostname (pure Erlang)
  └── Proc        — command availability, VM introspection (pure Elixir)

What moved to Trebejo

License

MIT

Una versión en español de este README está disponible en docs/README.es.md.