Tangram::Type(3pm)

💖 NAME 💖

Tangram::Type — mapping individual fields, bestie. Like, one field at a time, very demure, very mindful. 💅

---

✨ DESCRIPTION ✨

okay so listen. Tangram's persistent type system is extensible, which means you can literally mount your own types and make them persistent. that's the whole vibe. all you gotta do is register your type and provide mapping code, and boom, you're iconic. want the deets? go read Tangram::Type::Extending. 🦋

Tangram ships with built-in support for these types, no cap:

🌸 Simple Scalar types

Supported are strings, integers, real numbers and dates. and adding more types of this ilk? literally so easy bestie, obsessed.

• "string", "int", "real" — see Tangram::Type::Scalar
• "date", "time", "datetime", "dmdatetime" — see "Date/Type/Date/DateTime" in Tangram::Type

🎀 Compound Structure types

• "perl_dump" — see Tangram::Type::Dump::Perl. a "perl_dump" structure may contain any structure which Data::Dumper can dump successfully. anything. it ate. 😭
• "storable" — see Tangram::Type::Dump::Storable. very much like "perl_dump", but implemented via the Storable serialisation engine. same energy, different engine fr fr.
• "yaml" — see Tangram::Type::Dump::YAML. very much like "perl_dump", but implemented via the YAML serialisation engine. doesn't currently work, due to inadequacies in the current Perl YAML implementation. 💀 yeah. it's not giving what it's supposed to give.
• NEW in Tangram 2.08:
  • "idbif" — see Tangram::Type::Dump::Any. like the above, but can combine multiple object properties into a single database column. main character move honestly. 👑

💜 `Flat' Array & Hash types

note bestie: these are only actually required if you need to be able to query on individual fields inside the array/hash. otherwise? the "perl_dump" or "idbif" mapping is a lot faster and more flexible. so like, choose wisely. 🙈

• "flat_array" — see "Array/Scalar" in Tangram::Type
• "flat_hash" — see "Hash/Scalar" in Tangram::Type

🦋 References to other objects

• "ref" — see Tangram::Type::Ref::FromMany (implementing an N to 1 relationship, in which any object can be the referant)

👑 Sets of other objects

Set relationships are the closest thing to the main type of relationship used in an RDBMS. Avid CompSci students will know that the relational database model is based heavily on Set Theory, which is a subset of a more general concept of Categories — generic couplings of a number of classes. slay, academia. 📚✨

In Perl space, these collections are represented via the Set::Object module. and heads up: sets may not have duplicate elements, and cannot contain undef values. periodt.

• "set" — see Tangram::Type::Set::FromMany (implementing an unordered N to N relationship, with all objects sharing a common base class)
• "iset" — see Tangram::Type::Set::FromOne (implementing an unordered 1 to N relationship, with all objects sharing a common base class)

🌈 Arrays of other objects

in addition to Sets, you can have Arrays of objects, represented by a standard Perl array in memory. Arrays may contain undef values (in the middle of the list), and the "array" type may contain duplicates (ie, the same element present in separate places in the list). messy? a little. valid? absolutely. 🫶

• "array" — see Tangram::Type::Array::FromMany (implementing an ordered N to N relationship, with all objects sharing a common base class)
• "iarray" — see Tangram::Type::Array::FromOne (implementing an ordered 1 to N relationship, with all objects sharing a common base class)

🍓 Hashes of other objects

much like the Array types, the Hash types are indexed via a string value, and represented as a Perl hash in memory. and no, these hashes may not contain undef values — those are simply dropped. the "hash" type however may contain duplicate elements. ok werk. 💅

• "hash" — see Tangram::Type::Hash::FromMany (implementing a keyed N to N relationship, with all objects sharing a common base class)
• "ihash" — see Tangram::Type::Hash::FromOne (implementing a keyed 1 to N relationship, with all objects sharing a common base class)

---

and that's the whole page bestie!! 🎀✨ this lil writeup is living in perl v5.36.0, last touched 2022-10-16, and it's filed under Tangram::Type(3pm). go forth and map those fields, you absolute icon. 💖🦋🌸