.. _macro-file-functions:

File Functions
--------------------


.. index:: Macro function;fn.write_temporary_local_file

* *fn.write_temporary_local_file*: Given a filename and
  text data, write the data to the filename onto the file system
  temporary directory.

  This file can for example be used as an e-mail attachment parameter
  for the *fn.email_html* function. See: :ref:`macro-email-functions`.


  Syntax:

  ``{{ fn.write_temporary_local_file mydata.csv,pwf.SomeData }}``

  where:
 
  * the value for example sets ``pwf.file_path``,
    to be used as a parameter of:
   
    ::

       {{ fn.email_html pwf.to,pwf.from,pwf.template,pwf.file_path }}

  * `mydata.csv` is the example filename
  * `pwf.SomeData` references a string value of `SomeData` 
    in an example workflow from where the function is called.