Class: Parse::ACL::Permission

Inherits:
Object
  • Object
show all
Includes:
ActiveModel::Model, ActiveModel::Serializers::JSON
Defined in:
lib/parse/model/acl.rb

Overview

The Permission class tracks the read and write permissions for a specific ACL entry. The value of an Parse-ACL hash only contains two keys: "read" and "write".

# Example of the ACL format { "": { "read": true }, "3KmCvT7Zsb": { "read": true, "write": true }, "role:Admins": { "write": true } } This would be managed as: { "": ACL::Permission.new(true), "3KmCvT7Zsb": ACL::Permission.new(true, true) "role:Amdins": ACL::Permission.new(false,true) }

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#new(read = nil, write = nil) ⇒ Permission #new(hash) ⇒ Permission

Create a new permission with the given read and write privileges.

Overloads:

  • #new(read = nil, write = nil) ⇒ Permission

    Examples:

    ACL::Permission.new(true, false)

    Parameters:

    • read (Boolean) (defaults to: nil) —

      whether reading is allowed.

    • write (Boolean) (defaults to: nil) —

      whether writing is allowed.

  • #new(hash) ⇒ Permission

    Examples:

    ACL::Permission.new({read: true, write: false})

    Parameters:

    • hash (Hash) —

      a key value pair for read/write permissions.



899
900
901
902
903
904
905
906
907
908
 
# File 'lib/parse/model/acl.rb', line 899

def initialize(r_perm = nil, w_perm = nil)
  if r_perm.is_a?(Hash)
    r_perm = r_perm.symbolize_keys
    @read = r_perm[:read].present?
    @write = r_perm[:write].present?
  else
    @read = r_perm.present?
    @write = w_perm.present?
  end
end

Instance Attribute Details

#read ⇒ Boolean (readonly)

The read permission state.

Returns:

  • (Boolean) —

    whether this permission is allowed.



882
883
884
 
# File 'lib/parse/model/acl.rb', line 882

def read
  @read
end

#write ⇒ Boolean (readonly)

The write permission state.

Returns:

  • (Boolean) —

    whether this permission is allowed.



886
887
888
 
# File 'lib/parse/model/acl.rb', line 886

def write
  @write
end

Instance Method Details

#==(per) ⇒ Boolean

Returns whether two permission instances have the same permissions.

Returns:

  • (Boolean) —

    whether two permission instances have the same permissions.



911
912
913
914
 
# File 'lib/parse/model/acl.rb', line 911

def ==(per)
  return false unless per.is_a?(self.class)
  @read == per.read && @write == per.write
end

#as_json(*args) ⇒ Hash

Returns A Parse-compatible ACL-hash. Omission or false on a priviledge means don't include it.

Returns:

  • (Hash) —

    A Parse-compatible ACL-hash. Omission or false on a priviledge means don't include it



918
919
920
921
922
923
 
# File 'lib/parse/model/acl.rb', line 918

def as_json(*args)
  h = {}
  h[:read] = true if @read
  h[:write] = true if @write
  h.empty? ? nil : h.as_json
end

#attributes ⇒ Hash

Returns:



926
927
928
929
930
931
 
# File 'lib/parse/model/acl.rb', line 926

def attributes
  h = {}
  h.merge!(read: :boolean) if @read
  h.merge!(write: :boolean) if @write
  h
end

#no_read!

This method returns an undefined value.

Sets the read value of the permission to false.

Version:

  • 1.7.2



962
963
964
 
# File 'lib/parse/model/acl.rb', line 962

def no_read!
  @read = false
end

#no_write!

This method returns an undefined value.

Sets the write value of the permission to false.

Version:

  • 1.7.2



969
970
971
 
# File 'lib/parse/model/acl.rb', line 969

def no_write!
  @write = false
end

#present? ⇒ Boolean

Returns whether there is at least one permission set to true.

Returns:

  • (Boolean) —

    whether there is at least one permission set to true.



939
940
941
 
# File 'lib/parse/model/acl.rb', line 939

def present?
  @read.present? || @write.present?
end

#read!(value = true)

Note:

Setting the value in this manner is not dirty tracked.

This method returns an undefined value.

Sets the read value of the permission. Defaults to true.

Version:

  • 1.7.2



947
948
949
 
# File 'lib/parse/model/acl.rb', line 947

def read!(value = true)
  @read = value
end

#write!(value = true)

Note:

Setting the value in this manner is not dirty tracked.

This method returns an undefined value.

Sets the write value of the permission. Defaults to true.

Version:

  • 1.7.2



955
956
957
 
# File 'lib/parse/model/acl.rb', line 955

def write!(value = true)
  @write = value
end