PlaceOS::Model::Shortener

#short_id derives the id from the creation second plus rand(63), i.e. only 63 possible ids per wall-clock second, so two same-second creates collide on the primary key with probability ~1/63. The compact format is deliberate (the id is the public short URL), so instead of widening it we retry the insert: each attempt re-runs the before_create callback, rolling a fresh random component, and a failed attempt is just a cheap single-row insert.

macro level key => type

Deserializes the given JSON in string_or_io into an instance of self, assuming the JSON consists of an JSON object with key root, and whose value is the value to deserialize. Will not deserialise from fields with mass_assign: false

class User < ActiveModel::Model
  attribute name : String
  attribute google_id : UUID, mass_assign: false
end

User.from_json(%({"main": {"name": "Jason", "google_id": "f6f70bfb-c882-446d-8758-7ce47db39620"}}), root: "main") # => #<User:0x103131b20 @name="Jason">

Serialize from a trusted JSON source

Serialize from a trusted YAML source

Initialize PlaceOS::Model::Shortener from HTTP::Params.

Returns all attribute keys.

Look up instances of this model dependent on the foreign key

Changefeed at row (if id passed) or whole table level. Returns a ChangeFeed instance which can be used to invoke async callbacks via on or use blocking Iterator via each method.

Base class for all Engine models

Base class for all Engine models

Base class for all Engine models

Base class for all Engine models

Base class for all Engine models

Generate code to apply default values

Assign to multiple attributes.

Assign to multiple attributes via HTTP::Params.

Assign to multiple attributes from a model object

Assign each field from JSON if field exists in JSON and has changed in model

Uses the YAML parser as JSON is valid YAML

Returns a Hash of all attribute values

Returns a NamedTuple of all attribute values.

Retrieves the parent relationship

Sets the parent relationship

authority_id getter

authority_id setter

Returns a Tuple of the previous and the current value of an instance variable if it has changed

authority_id's default value

Include authority_id in the set of changed attributes, whether it has changed or not.

Base class for all Engine models

Base class for all Engine models

Base class for all Engine models

Base class for all Engine models

Check if any attributes have changed.

Returns a Hash with all changed attributes.

Serialize the set of changed attributes to JSON.

Serialize the set of changed attributes to JSON.

Serialize the set of changed attributes to YAML.

Serialize the set of changed attributes to YAML.

Reset changes for all attributes.

created_at getter

Setters created_at setter

NOTE: use getter / getter! (not property / property!) so that the setter defined later in __create_initializer__ is the only setter on the field. Crystal's overload resolution silently fails to replace a property-defined setter with one of identical signature for generic types (e.g. Set(String)?, Array(String)?, String | Array(String)), although it does work for non-generic ones like String?. Defining the setter only once via __create_initializer__ ensures change tracking, sanitization, and custom setter blocks run uniformly across all types.

Returns a Tuple of the previous and the current value of an instance variable if it has changed

created_at's default value

Include created_at in the set of changed attributes, whether it has changed or not.

description getter

description setter

NOTE: use getter / getter! (not property / property!) so that the setter defined later in __create_initializer__ is the only setter on the field. Crystal's overload resolution silently fails to replace a property-defined setter with one of identical signature for generic types (e.g. Set(String)?, Array(String)?, String | Array(String)), although it does work for non-generic ones like String?. Defining the setter only once via __create_initializer__ ensures change tracking, sanitization, and custom setter blocks run uniformly across all types.

Returns a Tuple of the previous and the current value of an instance variable if it has changed

description's default value

Include description in the set of changed attributes, whether it has changed or not.

enabled getter

enabled setter

NOTE: use getter / getter! (not property / property!) so that the setter defined later in __create_initializer__ is the only setter on the field. Crystal's overload resolution silently fails to replace a property-defined setter with one of identical signature for generic types (e.g. Set(String)?, Array(String)?, String | Array(String)), although it does work for non-generic ones like String?. Defining the setter only once via __create_initializer__ ensures change tracking, sanitization, and custom setter blocks run uniformly across all types.

Returns a Tuple of the previous and the current value of an instance variable if it has changed

enabled's default value

Include enabled in the set of changed attributes, whether it has changed or not.

id getter

id setter

Returns a Tuple of the previous and the current value of an instance variable if it has changed

id's default value

Include id in the set of changed attributes, whether it has changed or not.

Base class for all Engine models

name getter

name setter

NOTE: use getter / getter! (not property / property!) so that the setter defined later in __create_initializer__ is the only setter on the field. Crystal's overload resolution silently fails to replace a property-defined setter with one of identical signature for generic types (e.g. Set(String)?, Array(String)?, String | Array(String)), although it does work for non-generic ones like String?. Defining the setter only once via __create_initializer__ ensures change tracking, sanitization, and custom setter blocks run uniformly across all types.

Returns a Tuple of the previous and the current value of an instance variable if it has changed

name's default value

Include name in the set of changed attributes, whether it has changed or not.

Returns a Hash of all attributes that can be persisted.

Base class for all Engine models

redirect_count getter

redirect_count setter

NOTE: use getter / getter! (not property / property!) so that the setter defined later in __create_initializer__ is the only setter on the field. Crystal's overload resolution silently fails to replace a property-defined setter with one of identical signature for generic types (e.g. Set(String)?, Array(String)?, String | Array(String)), although it does work for non-generic ones like String?. Defining the setter only once via __create_initializer__ ensures change tracking, sanitization, and custom setter blocks run uniformly across all types.

Returns a Tuple of the previous and the current value of an instance variable if it has changed

redirect_count's default value

Include redirect_count in the set of changed attributes, whether it has changed or not.

Reset each attribute to their previous values and clears all changes.

Saves the record to the database, raising an exception on failure.

For new records, performs an INSERT. For existing records, performs an UPDATE. Only updates changed attributes (dirty tracking).

Example

user = User.new(name: "John")
user.save! # => #<User id: 1, name: "John">

user.name = "Jane"
user.save! # Only updates 'name' column

Raises

• PgORM::Error::RecordNotSaved if record was destroyed
• PgORM::Error::RecordInvalid if validation fails
• PgORM::Error::RecordNotSaved if database operation fails

updated_at getter

updated_at setter

NOTE: use getter / getter! (not property / property!) so that the setter defined later in __create_initializer__ is the only setter on the field. Crystal's overload resolution silently fails to replace a property-defined setter with one of identical signature for generic types (e.g. Set(String)?, Array(String)?, String | Array(String)), although it does work for non-generic ones like String?. Defining the setter only once via __create_initializer__ ensures change tracking, sanitization, and custom setter blocks run uniformly across all types.

Returns a Tuple of the previous and the current value of an instance variable if it has changed

updated_at's default value

Include updated_at in the set of changed attributes, whether it has changed or not.

uri getter

uri setter

NOTE: use getter / getter! (not property / property!) so that the setter defined later in __create_initializer__ is the only setter on the field. Crystal's overload resolution silently fails to replace a property-defined setter with one of identical signature for generic types (e.g. Set(String)?, Array(String)?, String | Array(String)), although it does work for non-generic ones like String?. Defining the setter only once via __create_initializer__ ensures change tracking, sanitization, and custom setter blocks run uniformly across all types.

Returns a Tuple of the previous and the current value of an instance variable if it has changed

uri's default value

Include uri in the set of changed attributes, whether it has changed or not.

user_email getter

user_email setter

NOTE: use getter / getter! (not property / property!) so that the setter defined later in __create_initializer__ is the only setter on the field. Crystal's overload resolution silently fails to replace a property-defined setter with one of identical signature for generic types (e.g. Set(String)?, Array(String)?, String | Array(String)), although it does work for non-generic ones like String?. Defining the setter only once via __create_initializer__ ensures change tracking, sanitization, and custom setter blocks run uniformly across all types.

Returns a Tuple of the previous and the current value of an instance variable if it has changed

user_email's default value

Include user_email in the set of changed attributes, whether it has changed or not.

user_id getter

user_id setter

NOTE: use getter / getter! (not property / property!) so that the setter defined later in __create_initializer__ is the only setter on the field. Crystal's overload resolution silently fails to replace a property-defined setter with one of identical signature for generic types (e.g. Set(String)?, Array(String)?, String | Array(String)), although it does work for non-generic ones like String?. Defining the setter only once via __create_initializer__ ensures change tracking, sanitization, and custom setter blocks run uniformly across all types.

Returns a Tuple of the previous and the current value of an instance variable if it has changed

user_id's default value

Include user_id in the set of changed attributes, whether it has changed or not.

user_name getter

user_name setter

NOTE: use getter / getter! (not property / property!) so that the setter defined later in __create_initializer__ is the only setter on the field. Crystal's overload resolution silently fails to replace a property-defined setter with one of identical signature for generic types (e.g. Set(String)?, Array(String)?, String | Array(String)), although it does work for non-generic ones like String?. Defining the setter only once via __create_initializer__ ensures change tracking, sanitization, and custom setter blocks run uniformly across all types.

Returns a Tuple of the previous and the current value of an instance variable if it has changed

user_name's default value

Include user_name in the set of changed attributes, whether it has changed or not.

valid_from getter

valid_from setter

Returns a Tuple of the previous and the current value of an instance variable if it has changed

valid_from's default value

Include valid_from in the set of changed attributes, whether it has changed or not.

valid_until getter

valid_until setter

Returns a Tuple of the previous and the current value of an instance variable if it has changed

valid_until's default value

Include valid_until in the set of changed attributes, whether it has changed or not.

Validate that all non-nillable fields have values.