use crate::fs::asyncify;

use std::{io, path::Path};

/// Creates a future that will open a file for writing and write the entire

/// contents of `contents` to it.

///

/// This is the async equivalent of [`std::fs::write`][std].

///

/// This operation is implemented by running the equivalent blocking operation

/// on a separate thread pool using [`spawn_blocking`].

///

/// [`spawn_blocking`]: crate::task::spawn_blocking

/// [std]: fn@std::fs::write

///

/// # Examples

///

/// ```no_run

/// use tokio::fs;

///

/// # async fn dox() -> std::io::Result<()> {

/// fs::write("foo.txt", b"Hello world!").await?;

/// # Ok(())

/// # }

/// ```

pub async fn write(path: impl AsRef<Path>, contents: impl AsRef<[u8]>) -> io::Result<()> {

    let path = path.as_ref().to_owned();

    let contents = crate::util::as_ref::upgrade(contents);

    asyncify(move || std::fs::write(path, contents)).await

}