Struct PermissionsContainer

pub struct PermissionsContainer { /* private fields */ }

Wrapper struct for Permissions that can be shared across threads.

We need a way to have internal mutability for permissions as they might get passed to a future that will prompt the user for permission (and in such case might need to be mutated). Also for the Web Worker API we need a way to send permissions to a new thread.

Implementations

impl PermissionsContainer

pub fn new( descriptor_parser: Arc<dyn PermissionDescriptorParser>, perms: Permissions, ) -> Self

pub fn allow_all(descriptor_parser: Arc<dyn PermissionDescriptorParser>) -> Self

pub fn create_child_permissions( &self, child_permissions_arg: ChildPermissionsArg, ) -> Result<PermissionsContainer, ChildPermissionError>

pub fn check_specifier( &self, specifier: &ModuleSpecifier, kind: CheckSpecifierKind, ) -> Result<(), PermissionCheckError>

pub fn check_read( &self, path: &str, api_name: &str, ) -> Result<PathBuf, PermissionCheckError>

pub fn check_read_with_api_name( &self, path: &str, api_name: Option<&str>, ) -> Result<PathBuf, PermissionCheckError>

pub fn check_read_path<'a>( &self, path: &'a Path, api_name: Option<&str>, ) -> Result<Cow<'a, Path>, PermissionCheckError>

pub fn check_read_blind( &mut self, path: &Path, display: &str, api_name: &str, ) -> Result<(), PermissionCheckError>

As check_read(), but permission error messages will anonymize the path by replacing it with the given display.

pub fn check_read_all(&self, api_name: &str) -> Result<(), PermissionCheckError>

pub fn query_read_all(&self) -> bool

pub fn check_write( &self, path: &str, api_name: &str, ) -> Result<PathBuf, PermissionCheckError>

pub fn check_write_with_api_name( &self, path: &str, api_name: Option<&str>, ) -> Result<PathBuf, PermissionCheckError>

pub fn check_write_path<'a>( &self, path: &'a Path, api_name: &str, ) -> Result<Cow<'a, Path>, PermissionCheckError>

pub fn check_write_all( &self, api_name: &str, ) -> Result<(), PermissionCheckError>

pub fn check_write_blind( &self, path: &Path, display: &str, api_name: &str, ) -> Result<(), PermissionCheckError>

As check_write(), but permission error messages will anonymize the path by replacing it with the given display.

pub fn check_write_partial( &mut self, path: &str, api_name: &str, ) -> Result<PathBuf, PermissionCheckError>

pub fn check_run( &mut self, cmd: &RunQueryDescriptor, api_name: &str, ) -> Result<(), PermissionCheckError>

pub fn check_run_all( &mut self, api_name: &str, ) -> Result<(), PermissionCheckError>

pub fn query_run_all(&mut self, api_name: &str) -> bool

pub fn check_sys( &self, kind: &str, api_name: &str, ) -> Result<(), PermissionCheckError>

pub fn check_env(&mut self, var: &str) -> Result<(), PermissionCheckError>

pub fn check_env_all(&mut self) -> Result<(), PermissionCheckError>

pub fn check_sys_all(&mut self) -> Result<(), PermissionCheckError>

pub fn check_ffi_all(&mut self) -> Result<(), PermissionCheckError>

pub fn check_was_allow_all_flag_passed( &mut self, ) -> Result<(), PermissionCheckError>

This checks to see if the allow-all flag was passed, not whether all permissions are enabled!

pub fn check_special_file( &mut self, path: &Path, _api_name: &str, ) -> Result<(), &'static str>

Checks special file access, returning the failed permission type if not successful.

pub fn check_net_url( &mut self, url: &Url, api_name: &str, ) -> Result<(), PermissionCheckError>

pub fn check_net<T: AsRef<str>>( &mut self, host: &(T, Option<u16>), api_name: &str, ) -> Result<(), PermissionCheckError>

pub fn check_ffi(&mut self, path: &str) -> Result<PathBuf, PermissionCheckError>

pub fn check_ffi_partial_no_path(&mut self) -> Result<(), PermissionCheckError>

pub fn check_ffi_partial_with_path( &mut self, path: &str, ) -> Result<PathBuf, PermissionCheckError>

pub fn query_read( &self, path: Option<&str>, ) -> Result<PermissionState, PathResolveError>

pub fn query_write( &self, path: Option<&str>, ) -> Result<PermissionState, PathResolveError>

pub fn query_net( &self, host: Option<&str>, ) -> Result<PermissionState, NetDescriptorParseError>

pub fn query_env(&self, var: Option<&str>) -> PermissionState

pub fn query_sys( &self, kind: Option<&str>, ) -> Result<PermissionState, SysDescriptorParseError>

pub fn query_run( &self, cmd: Option<&str>, ) -> Result<PermissionState, RunDescriptorParseError>

pub fn query_ffi( &self, path: Option<&str>, ) -> Result<PermissionState, PathResolveError>

pub fn revoke_read( &self, path: Option<&str>, ) -> Result<PermissionState, PathResolveError>

pub fn revoke_write( &self, path: Option<&str>, ) -> Result<PermissionState, PathResolveError>

pub fn revoke_net( &self, host: Option<&str>, ) -> Result<PermissionState, NetDescriptorParseError>

pub fn revoke_env(&self, var: Option<&str>) -> PermissionState

pub fn revoke_sys( &self, kind: Option<&str>, ) -> Result<PermissionState, SysDescriptorParseError>

pub fn revoke_run( &self, cmd: Option<&str>, ) -> Result<PermissionState, RunDescriptorParseError>

pub fn revoke_ffi( &self, path: Option<&str>, ) -> Result<PermissionState, PathResolveError>

pub fn request_read( &self, path: Option<&str>, ) -> Result<PermissionState, PathResolveError>

pub fn request_write( &self, path: Option<&str>, ) -> Result<PermissionState, PathResolveError>

pub fn request_net( &self, host: Option<&str>, ) -> Result<PermissionState, NetDescriptorParseError>

pub fn request_env(&self, var: Option<&str>) -> PermissionState

pub fn request_sys( &self, kind: Option<&str>, ) -> Result<PermissionState, SysDescriptorParseError>

pub fn request_run( &self, cmd: Option<&str>, ) -> Result<PermissionState, RunDescriptorParseError>

pub fn request_ffi( &self, path: Option<&str>, ) -> Result<PermissionState, PathResolveError>

Trait Implementations

impl Clone for PermissionsContainer

fn clone(&self) -> PermissionsContainer

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PermissionsContainer

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.