« Changelog History


jennifer v0.10.0 Release Notes

Release Date: 2020-12-11 // over 3 years ago

  • 🔄 Changes

    General

    • ➕ add crystal 0.35.0 support and drop 0.34.0 support

    QueryBuilder

    • 👍 allow arbitrary Query instances as nested queries for CTEs
    • 🛠 fix failed nil assertion when eager load relations sequence with missing intermediate relation records
    • ➕ add IModelQuery#find(id) to retrieve record by primary key
    • ➕ add IModelQuery#find!(id) to retrieve record by primary key or raise Jennifer::RecordNotFound exception
    • ModelQuery(T)#to_a and ModelQuery(T)#find_by_sql ensure T has loaded actual table field count before making a request

    Model

    • 🔄 change model constructor hash argument type from Hash(String, Jennifer::DBany) to Hash(String, AttrType) (same for Symbol keys)
    • CommonMapping#attribute uses attribute getter
    • 👻 CommonMapping#attribute raises Jennifer::UnknownAttribute exception if model has no requested attribute and raise_exception = true
    • add CommonMapping#attribute_before_typecast which returns given attribute in database format using attribute converter
    • add Mapping#{{attribute}}_will_change! to mark {{attribute}} as changed one
    • #primary uses getter
    • any Mapping.mapping invocation creates AttrType alias to represent union of Jennifer::DBAny and any arbitrary type from fields definition
    • ⚡️ change Mapping#update_columns argument type to Hash(String | Symbol, AttrType)
    • ⚡️ Mapping#update_columns raises Jennifer::UnknownAttribute if key-value pairs include unknown attribute
    • Mapping#set_attribute to accept AttrType
    • 👻 Mapping#set_attribute raises Jennifer::UnknownAttribute exception if model has no requested attribute
    • ⚡️ Mapping#update_columns raises Jennifer::UnknownAttribute if key-value pairs include unknown field
    • Mapping#arguments_to_insert and Mapping#arguments_to_save use #attribute_before_typecast to collect attributes to store in a database
    • #add_{{relation}} accepts AttrType as a hash value type
    • 📇 rename EnumConverter to PgEnumConverter
    • ➕ add EnumConverter(T) to convert string to crystal enum
    • add JSONSerializableConverter(T) to convert JSON field to objects of T that support .from_json and #to_json methods
    • add TimeZoneConverter to convert time attributes from UTC to Jennife::Config.local_time_zone

    Adapter

    • ➕ add DBFormater as a proposed default logger formatter
    • 📇 change logging - emit Log::Metadata with query, args and time keys (as new crystal-db does)
    • 🛠 fix missing reconnect to database on connection lost

    SqlGenerator

    • 🛠 fix a potential compilation issue that appears in certain edge cases for postgres adapter (#329)
      Adapter::BaseSQLGenerator now produces valid SQL when using multiple recursive CTEs (.with(..., true)) in a single query

    Migration

    • 📇 rename TableBuilder::DB_OPTIONS to TableBuilder::DbOptions

    Exceptions

    • ➕ add Jennifer::UnknownAttribute to represent case when unknown attribute is tried to be read/written