async-std/src/fs/permissions.rs

use cfg_if::cfg_if;

cfg_if! {
    if #[cfg(feature = "docs")] {
        /// A set of permissions on a file or directory.
        ///
        /// This type is a re-export of [`std::fs::Permissions`].
        ///
        /// [`std::fs::Permissions`]: https://doc.rust-lang.org/std/fs/struct.Permissions.html
        #[derive(Clone, PartialEq, Eq, Debug)]
        pub struct Permissions {
            _private: (),
        }

        impl Permissions {
            /// Returns the read-only flag.
            ///
            /// # Examples
            ///
            /// ```no_run
            /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
            /// #
            /// use async_std::fs;
            ///
            /// let perm = fs::metadata("a.txt").await?.permissions();
            /// println!("{:?}", perm.readonly());
            /// #
            /// # Ok(()) }) }
            /// ```
            pub fn readonly(&self) -> bool {
                unimplemented!()
            }

            /// Configures the read-only flag.
            ///
            /// [`fs::set_permissions`]: fn.set_permissions.html
            ///
            /// # Examples
            ///
            /// ```no_run
            /// # fn main() -> std::io::Result<()> { async_std::task::block_on(async {
            /// #
            /// use async_std::fs;
            ///
            /// let mut perm = fs::metadata("a.txt").await?.permissions();
            /// perm.set_readonly(true);
            /// fs::set_permissions("a.txt", perm).await?;
            /// #
            /// # Ok(()) }) }
            /// ```
            pub fn set_readonly(&mut self, readonly: bool) {
                unimplemented!()
            }
        }
    } else {
        pub use std::fs::Permissions;
    }
}