Convenience properties API (#6066)

#6049

components/properties/src/code_point_map.rs

@@ -358,4 +358,12 @@ pub trait EnumeratedProperty: crate::private::Sealed + TrieValue {
     const NAME: &'static [u8];
     /// The abbreviated name of this property, if it exists, otherwise the name
     const SHORT_NAME: &'static [u8];
+
+    /// Convenience method for `CodePointMapData::new().get(ch)`
+    ///
+    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
+    #[cfg(feature = "compiled_data")]
+    fn for_char(ch: char) -> Self {
+        CodePointMapData::new().get(ch)
+    }
 }

components/properties/src/code_point_set.rs

@@ -212,7 +212,7 @@ impl<'a> CodePointSetDataBorrowed<'a> {
 /// [`CodePointSetData`]: crate::sets::CodePointSetData
 /// [`TR44`]: https://www.unicode.org/reports/tr44
 /// [`TR18`]: https://www.unicode.org/reports/tr18
-pub trait BinaryProperty: crate::private::Sealed {
+pub trait BinaryProperty: crate::private::Sealed + Sized {
     #[doc(hidden)]
     type DataMarker: DataMarker<DataStruct = PropertyCodePointSet<'static>>;
     #[doc(hidden)]
@@ -222,6 +222,14 @@ pub trait BinaryProperty: crate::private::Sealed {
     const NAME: &'static [u8];
     /// The abbreviated name of this property, if it exists, otherwise the name
     const SHORT_NAME: &'static [u8];
+
+    /// Convenience method for `CodePointSetData::new().contains(ch)`
+    ///
+    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
+    #[cfg(feature = "compiled_data")]
+    fn for_char(ch: char) -> bool {
+        CodePointSetData::new::<Self>().contains(ch)
+    }
 }
 
 #[cfg(test)]

components/properties/src/names.rs

@@ -719,6 +719,30 @@ pub trait NamedEnumeratedProperty: ParseableEnumeratedProperty {
     fn nep_short_identity_static(
         stat: &'static Self::DataStructShortBorrowed<'static>,
     ) -> &'static Self::DataStructShort;
+
+    /// Convenience method for `PropertyParser::new().get_loose(s)`
+    ///
+    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
+    #[cfg(feature = "compiled_data")]
+    fn try_from_str(s: &str) -> Option<Self> {
+        PropertyParser::new().get_loose(s)
+    }
+    /// Convenience method for `PropertyNamesLong::new().get(*self).unwrap()`
+    ///
+    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
+    #[cfg(feature = "compiled_data")]
+    fn long_name(&self) -> &'static str {
+        PropertyNamesLong::new().get(*self).unwrap_or("unreachable")
+    }
+    /// Convenience method for `PropertyNamesShort::new().get(*self).unwrap()`
+    ///
+    /// ✨ *Enabled with the `compiled_data` Cargo feature.*
+    #[cfg(feature = "compiled_data")]
+    fn short_name(&self) -> &'static str {
+        PropertyNamesShort::new()
+            .get(*self)
+            .unwrap_or("unreachable")
+    }
 }
 
 macro_rules! impl_value_getter {

ffi/capi/tests/missing_apis.txt

@@ -327,6 +327,11 @@ icu::properties::PropertyNamesShortBorrowed::get_locale_script#FnInStruct
 icu::properties::PropertyNamesShortBorrowed::new#FnInStruct
 icu::properties::props::BidiMirroringGlyph#Struct
 icu::properties::props::BidiPairedBracketType#Enum
+icu::properties::props::BinaryProperty::for_char#FnInTrait
+icu::properties::props::EnumeratedProperty::for_char#FnInTrait
+icu::properties::props::NamedEnumeratedProperty::long_name#FnInTrait
+icu::properties::props::NamedEnumeratedProperty::short_name#FnInTrait
+icu::properties::props::NamedEnumeratedProperty::try_from_str#FnInTrait
 icu::timezone::TimeZoneBcp47Iter#Struct
 icu::timezone::TimeZoneBcp47Iter::next#FnInStruct
 icu::timezone::TimeZoneCanonicalIanaIter#Struct