Briefly (briefly v0.5.0)

View Source

Briefly

This is a fork of https://github.com/CargoSense/briefly

Simple, robust temporary file support for Elixir.

Highlighted Features

  • Create temporary files with prefix and extname options
  • Files are removed after the process that requested the file dies
  • File creation is based on Plug.Upload's robust retry logic
  • Configurable; built-in support for system environment variables and fallbacks

Installation

Add as a dependency to your mix.exs:

def deps do
  [
    briefly: "~> 0.3"
  ]
end

Install it with mix deps.get.

Example

Create a file:

{:ok, path} = Briefly.create
File.write!(path, "Some Text")
content = File.read!(path)
# When this process exits, the file at `path` is removed

Create a directory:

{:ok, path} = Briefly.create(directory: true)
File.write!(Path.join(path, "test.txt"), "Some Text")
# When this process exits, the directory and file are removed

See the documentation to see the options that available to Briefly.create/1 and Briefly.create!/1.

Configuration

The default, out-of-the-box settings for Briefly are equivalent to the following Mix config:

config :briefly,
  directory: [{:system, "TMPDIR"}, {:system, "TMP"}, {:system, "TEMP"}, "/tmp"],
  default_prefix: "briefly",
  default_extname: ""

directory here declares an ordered list of possible directory definitions that Briefly will check in order.

The {:system, env_var} tuples point to system environment variables to be checked. If none of these are defined, Briefly will use the final entry: /tmp.

You can override the settings with your own candidates in your application Mix config (and pass prefix and extname to Briefly.create to override default_prefix and default_extname on a case-by-case basis).

License

See LICENSE.

Summary

Functions

Removes the temporary files and directories created by the current process and return their paths.

Requests a temporary file to be created with the given options

Requests a temporary file to be created with the given options and raises on failure

Types

create_opts()

@type create_opts() :: [
  prefix: binary(),
  extname: binary(),
  directory: boolean(),
  monitor_pid: pid()
]

Functions

cleanup()

Removes the temporary files and directories created by the current process and return their paths.

cleanup(monitor_pid)

@spec cleanup(pid() | nil) :: [binary()]

create(opts \\ [])

@spec create(create_opts()) ::
  {:ok, binary()}
  | {:too_many_attempts, binary(), pos_integer()}
  | {:no_tmp, [binary()]}

Requests a temporary file to be created with the given options

create!(opts \\ [])

@spec create!(create_opts()) :: binary() | no_return()

Requests a temporary file to be created with the given options and raises on failure