{
"id": "fn-test-unique_filename",
"dataComponent": "test",
"heading": {
"title": "unique_filename",
"badges": [
"TestUtility"
]
},
"synopsis": "Generates a pseudo-random path string in the 'tmp/' directory, useful for creating unique test files without collisions.",
"codeBlocks": [
"extend(\"test\")\n\n# Basic usage:\n# test:unique_filename()\n\npath = test:unique_filename()\nsput(path)\n# => 'tmp/test_89ab2cd3' or similar\n\n# The function does not create or open the file; it just returns a unique path.\n"
],
"notes": [
"Accepts zero arguments, returns a single string in the form \"tmp/test_<8_hex>\" that is likely unique for this run.",
"Useful in tests to avoid name collisions when creating or overwriting files.",
"Does not actually create a file, only returns a path."
]
}