{
  "id": "fn-test-lorem_file",
  "dataComponent": "test",
  "heading": {
    "title": "lorem_file",
    "badges": [
      "TestUtility",
      "FileIO"
    ]
  },
  "synopsis": "Generates a file containing `n` characters of Lorem Ipsum text, returning the file path as a single string.",
  "codeBlocks": [
    "extend(\"test\")\n\n# Basic usage:\n# test:lorem_file(n)\n# => Creates a file in ./tmp/lorem_<shortHash>, with n chars of Lorem Ipsum.\n\npath = test:lorem_file(200)\nsput(path)\n# => prints something like 'tmp/lorem_19ab' or so.\n\n# The file is exactly 'n' characters of repeated Lorem text.\n# Use this for testing file operations (like reading, editing, etc.).\n"
  ],
  "notes": [
    "Accepts exactly one argument: an integer specifying how many characters of Lorem Ipsum to write.",
    "Creates a file in your project’s ./tmp subdirectory named 'lorem_<4-hex-hash>'. Returns that path as a single string.",
    "Fails if the file cannot be created or written. Use this for setting up test files of a certain size or content for file-based tests."
  ]
}
