[Catalyst-dev] RFC: new helper api

[Zbigniew Lukasiak]

T24gU2F0LCBKdW4gNiwgMjAwOSBhdCA1OjIyIEFNLCBEZXZpbiBBdXN0aW4gPGRldmluLmF1c3Rp
bkBnbWFpbC5jb20+IHdyb3RlOgoKPgo+Cj4gT24gRnJpLCBKdW4gNSwgMjAwOSBhdCAyOjI4IFBN
LCBaYmlnbmlldyBMdWthc2lhayA8enpiYnl5QGdtYWlsLmNvbT53cm90ZToKPgo+PiBPbiBUaHUs
IEp1biA0LCAyMDA5IGF0IDQ6NTEgQU0sIERldmluIEF1c3RpbjxkZXZpbi5hdXN0aW5AZ21haWwu
Y29tPgo+PiB3cm90ZToKPj4gPiBIb3dkeSBhbGwsCj4+ID4KPj4gPiBJJ3ZlIHB1dCB0b2dldGhl
ciBhbiBSRkMgZm9yIHRoZSBuZXcgQ2F0YWx5c3Q6OkhlbHBlciBBUEkuCj4+ID4gVGhlIGJvZHkg
dGV4dCBpcyBsb2NhdGVkIGJlbG93LCBidXQgaXQgaXMgYWxzbyBhdmFpbGFibGUgaGVyZSBpbiBh
Cj4+IHByZXR0eQo+PiA+IGZvcm1hdHRlZAo+PiA+IHZlcnNpb246aHR0cDovL3d3dy5jb2RlZHJp
Z2h0Lm5ldC8yMDA5LzA2L3JmYy1jYXRhbHlzdGhlbHBlci1hcGkuaHRtbAo+PiA+Cj4+ID4gRm9y
IHRoZSBpbXByb3ZlbWVudCBvZiB0aGUgQ2F0YWx5c3Q6OkhlbHBlciBBUEkgYW5kIENhdGFseXN0
IGRldmVsb3BtZW50Cj4+IGluCj4+ID4gZ2VuZXJhbCwgY29tbWVudHMgYXJlIG9mIHRoZSB1dG1v
c3QgaW1wb3J0YW5jZS4gIFRoZSBtb3JlIGZlZWRiYWNrCj4+ID4gSSBjYW4gZ2V0LCB0aGUgYmV0
dGVyIGFuZCBxdWlja2VyIHRoZSBBUEkgd2lsbCBiZSBjb21wbGV0ZWQuCj4+ID4KPj4gPiBUaGFu
ayB5b3Uga2luZGx5IQo+PiA+Cj4+ID4gLWRob3NzCj4+ID4KPj4gPiBJbnRybzoKPj4gPiBUaGlz
IGRvY3VtZW50IGlzIHRvIGdldCBvcGluaW9ucyBvbiBhIG5ldywgdXAgdG8gZGF0ZSBzZXQgdXAg
IGFuZAo+PiA+IHJlZmFjdG9yaW5nIG9mIHRoZSBDYXRhbHlzdDo6SGVscGVyIEFQSS4KPj4gPgo+
PiA+IFdoYXQgV2UgSGF2ZQo+PiA+IEN1cnJlbnRseSwgYWxsIHRlbXBsYXRlL2ltYWdlIGRhdGEg
aXMgaGlkZW91c2x5IHN0b3JlIGlubGluZSB3aXRoIGNvZGUKPj4gaW4KPj4gPiB0aGUgX19EQVRB
X18gc2VjdGlvbiBvZiBDYXRhbHlzdDo6SGVscGVyLnBtLiAgVGhlIEFQSSBpcyBkZXNpZ25lZCB0
bwo+PiBoYW5kbGUKPj4gPiBkYXRhIHRoaXMgd2F5LCB3aGljaCBpcyB3cm9uZyB3cm9uZyB3cm9u
ZyBmb3IgYSBudW1iZXIgb2YgcmVhc29uczoKPj4gPgo+PiA+ICBZb3UgaGF2ZSB0byBhY3R1YWxs
eSBkZWx2ZSBpbnRvIENhdGFseXN0IGludGVybmFscyB0byBlZGl0IGFueSBvZiB0aGVzZQo+PiA+
IGZpbGVzCj4+ID4gIElmIHlvdSBjcmVhdGUgYSBoZWxwZXIsIHlvdXIgZGF0YSBtdXN0IGJlIGlu
bGluZSBhcyB3ZWxsLgo+PiA+ICBJdHMgY3VycmVudCBsYXlvdXQgZG9lcyBub3QgcmVmbGVjdCB0
aGUgZGlyZWN0b3J5IGhpZXJhcmNoeSBvZiBhCj4+IENhdGFseXN0Cj4+ID4gYXBwbGljYXRpb24s
IHRodXMgbWFraW5nIGl0IHByZXR0eSBkYW5nIGhhcmQgdG8gZXhwYW5kIHVwb24vdXBncmFkZS4K
Pj4gPgo+PiA+IFRoZXJlIGFyZSBubyBtZXRob2RzIHRvIGFsbG93IHlvdSB0byBlZGl0IHByZXZp
b3VzbHkgY3JlYXRlZCBmaWxlcywKPj4gdW5sZXNzCj4+ID4geW91IHdhbnQgdG8gY3JlYXRlIHlv
dXIgb3duIGhlbHBlciBhbmQgZmV2ZXJpc2hseSBjcmVhdGUgeW91ciBvd24gZmlsZQo+PiA+IG1v
ZGlmaWNhdGlvbiBtZXRob2QocykuCj4+ID4gSSBjYW4gYXR0ZXN0IHRvIHRoZSBzdHJlc3MgdGhp
cyBjYXVzZXMsIGFzIEkndmUgYmVlbiBkb2luZyBhIGdvb2QgZGVhbAo+PiBvZgo+PiA+IHlhayBz
aGF2aW5nIGNsZWFuaW5nIHRoaXMgY29kZSB1cCBhbmQgY3JlYXRpbmcgdGhlIHByb3BlciB0ZXN0
cyBmb3IgaXQuCj4+ID4gSXQncyBub3QgYSB2ZXJ5IGZ1biBvcmRlYWwgYXQgdGhpcyBwb2ludC4K
Pj4gPgo+PiA+IFdoYXQgd2Ugd2FudAo+PiA+IEZyb20gdGhlIGZlZWRiYWNrIEkndmUgZ2F0aGVy
ZWQgdGh1cyBmYXI6Cj4+ID4KPj4gPiBXZSBkbyB3YW50IHByZXZpb3VzbHkgY3JlYXRlZCBoZWxw
ZXIgZmlsZXMgdG8gYmUgbW9kaWZpYWJsZSB2aWEKPj4gPiBDYXRhbHlzdDo6SGVscGVycy4gIEZv
ciBpbnN0YW5jZSwgdXBkYXRpbmcgTWFrZWZpbGUuUEwsIHVwZGF0aW5nCj4+IG15YXBwLmNvbmYK
Pj4gPiB0byByZWZsZWN0IGNoYW5nZXMsIHVwZGF0aW5nIERCSUMgc2NoZW1hIGZpbGVzIHRvIHJl
ZmxlY3QgZGF0YWJhc2UKPj4gY2hhbmdlcwo+PiA+ICh3aXRoIG1pbmltYWwgcGFpbikuIEFsc28s
IGFkZCBhbiBpbmZyYXN0cnVjdHVyZSBmb3IgbW9kaWZ5aW5nIGV4aXN0aW5nCj4+ID4gY2F0YWx5
c3QgY29kZSwgZS5nLiBtb3ZpbmcgQ2F0YWx5c3Q6OkhlbHBlcjo6QXV0aERCSUMgZnJvbSBhbgo+
PiBleHBlcmltZW50YWwKPj4gPiBwcm9vZiBvZiBjb25jZXB0IHRvIHNvbWV0aGluZyB0aGF0IHBl
b3BsZSBtaWdodCBhY3R1YWxseSB3YW50IHRvIHVzZSBmb3IKPj4gPiB0aGVpciBvd24gc3R1ZmYu
Cj4+ID4KPj4gPiBXZSBkbyB3YW50IHRvIGJlIGFibGUgdG8gcmVtb3ZlIGEgZ29vZCBkZWFsIG9m
IHRoZSBib2lsZXJwbGF0ZSBjb2RlIHRoYXQKPj4gPiBzdGlsbCBzZWVtcyB0byBuZWVkIHRvIGJl
IGNyZWF0ZWQgbWFudWFsbHksIGZvciBlYWNoIGFwcCwgZXZlbiB0aG91Z2gKPj4gaXQncwo+PiA+
IHRoZSBleGFjdCBzYW1lIGNvZGUgZm9yIGVhY2ggaW5zdGFuY2UuCj4+ID4KPj4gPiBXZSBkbyB3
YW50IHRvIHNldCB1cCB0aGUgaGVscGVyIGZpbGVzIGluIHRoZSBoaWVyYXJjaHkgdGhhdCBhIENh
dGFseXN0Cj4+ID4gYXBwbGljYXRpb24gaXMgY3JlYXRlZCBpbiwgdGh1cyBjdXR0aW5nIHF1aWNr
bHkgdG8gdGhlIGNoYXNlIGluIHRoZSB3YXkKPj4gb2YKPj4gPiBjcmVhdGluZyBhbiBhcHAuICBJ
dCdzIGEgc2ltcGxlIG5hbWUgYW5kIFRlbXBsYXRlOjpUb29sa2l0IHZhcmlhYmxlCj4+ID4gdHJh
bnNsYXRpb24sIHRoZW4gd3JpdGluZyB0aGUgZmlsZSB0byB0aGUgZmlsZXN5c3RlbSBwcm9jZXNz
IHRoZW4uICBUaGlzCj4+ID4gZ2V0cyBvdXIgYmluYXJ5IGRhdGEgb3V0IG9mIHRoZSBBUEkgY29k
ZSwgdGhlIHRlbXBsYXRlIGRhdGEgb3V0IG9mIHRoZQo+PiBBUEkKPj4gPiBjb2RlLCBhbmQgZ2Vu
ZXJhbGx5IG1ha2VzIGV2ZXJ5IG9uZSBtb3JlIGhhcHB5Lgo+PiA+Cj4+ID4gV2l0aCB0aGlzIHNh
aWQsIGhlcmUgYXJlIHNvbWUgbW9yZSBzcGVjaWZpYyBpZGVhcyB0aGF0IGhhdmUgYmVlbiBwYXNz
ZWQKPj4gbXkKPj4gPiB3YXkgdGhhdCBJIHRoaW5rIHdvdWxkIHJlYWxseSBoZWxwIGZ1cnRoZXIg
YWR2YW5jZSBvdXIgcHJlY2lvdXMgSGVscGVyCj4+IEFQSToKPj4gPgo+PiA+ICBCZWF0IHVwIE1v
b3NlWDo6R2V0b3B0IHRvIGRlYWwgd2l0aCBwYXNzLXRocm91Z2ggb3B0aW9ucywgc28geW91IGNh
bgo+PiBkZWFsCj4+ID4gd2l0aCBwYXNzaW5nIGRhdGEgc3RydWN0dXJlcyBhcyBhcmd1bWVudHMg
ZWFzaWVyLiBOb3QgdG8gbWVudGlvbgo+PiBhY3R1YWxseQo+PiA+IHN0YXJ0IFVTSU5HIGl0IGlu
IHRoZSBIZWxwZXIgQVBJLgo+PiA+IEFkZCBhIGZlYXR1cmUgdG8gd3JpdGUgb3V0IERCSUMgc2No
ZW1hIGZpbGVzIGZvciBkZXBsb3ltZW50LiAgWWVzLAo+PiA+IG1ha2Vfc2NoZW1hX2F0IGRvZXMg
dGhpcywgYnV0IHlvdSBoYXZlIHRvIHdyaXRlIHlvdXIgb3duIGxpdHRsZSBzY3JpcHQKPj4gdG8K
Pj4gPiBlbmpveSB0aGlzIG1vcnNlbCBvZiBmdW5jdGlvbmFsaXR5LiAgSXQgd291bGQgYmUgbmlj
ZSB0byBoYXZlIGl0Cj4+IHBhY2thZ2VkIHVwCj4+ID4gYW5kIHJlYWR5IHRvIGdvIGZvciB5b3Uu
Cj4+ID4gSGF2ZSBzb21ldGhpbmcgbGlrZSBUVFNpdGUsIGJ1dCBsZXNzIHN1Y2t5LiAgUGVyaGFw
cyB0aGVyZSBjb3VsZCBiZSBhCj4+ID4gZGVmYXVsdCBsYXlvdXQgdGhhdCBjYW4gYmUgY3JlYXRl
ZCwgb3IgeW91IGNhbiBjcmVhdGUgeW91ciBvd24gc29ydCBvZgo+PiBza2luCj4+ID4gYW5kIGhh
dmUgdGhhdCB0aGUgZGVmYXVsdCBnZW5lcmF0aW9uLiAgT3IsIGJldHRlciB5ZXQsIHBhY2thZ2Vk
IHNraW5zCj4+IHRoYXQKPj4gPiB1c2VycyBjYW4gc3VibWl0IHRvICRzb21ld2hlcmUgYW5kIGhh
dmUgdGhlIGF1dGhvciBjaG9vc2UgYSAidGhlbWUiIGZvcgo+PiA+IHRoZWlyIGFwcC4gRm9yIGlu
c3RhbmNlLCB1c2luZyAkamF2YXNjcmlwdCBmcmFtZXdvcmsgYW5kICRjc3MgZnJhbWV3b3JrCj4+
IHRvCj4+ID4gZG8gc28sIGxpa2UgaW4gY2hhcHQgMTEgb2YgdGhlIHVwY29taW5nIGJvb2sgKEV4
YW1wbGUgdXNhZ2U6Cj4+ID4gaHR0cDovL3d3dy51b3cuZWR1LmF1L35rZDIxLyA8aHR0cDovL3d3
dy51b3cuZWR1LmF1LyU3RWtkMjEvPikKPj4gPgo+PiA+IFRoZXNlIGFyZSB0aGUgY3VycmVudCBp
ZGVhcyBJIGhhdmUsIGFuZCB0aGF0IG90aGVycyBoYXZlIHN1Ym1pdHRlZC4KPj4gU3VyZQo+PiA+
IHRoaXMgUkZDIGlzIGEgYml0IGJhcmUsIGJ1dCB3ZSBkb24ndCBoYXZlIGEgd2hvbGUgdG9uIHRv
IHdvcmsgd2l0aCBhdAo+PiB0aGUKPj4gPiBtb21lbnQgd2l0aCBDYXRhbHlzdDo6SGVscGVyLCBz
byB3ZSBuZWVkIG1vcmUgZmVlZGJhY2sgdG8gYmVlZiB0aGluZ3MKPj4gdXAuCj4+Cj4+IEhpLAo+
Pgo+PiBBbGwgdGhhdCB5b3UgbWVudGlvbiBhYm92ZSBhcmUgZ3JlYXQgc3RlcHMgYWhlYWQgLSBh
bmQgaXQnbGwgYmUKPj4gd29uZGVyZnVsIGlmIHRoZXkgYXJlIGltcGxlbWVudGVkLiAgSWYgSSBt
YXkgYWRkIHNvbWV0aGluZyB0byB0aGF0Cj4+IGxpc3QgLSBpdCBpcyBhIHBvc3NpYmlsaXR5IHRv
IHJ1biB0aGUgaGVscGVycyBpbiBhZ2dyZWdhdGlvbiAtIHNvIHRoYXQKPj4geW91IGNvdWxkIGRl
ZmluZSB0aGUgY29uZmlndXJhdGlvbiBvbmNlIGZvciBhbGwgdGhlIHBhcnRzIGFuZCB0aGVuIHJ1
bgo+PiBjYXRhbHlzdC5wbCB0byBnZW5lcmF0ZSB0aGUgd2hvbGUgYXBwbGljYXRpb24gaW4gb25l
IHN0ZXAuICAgQ3VycmVudGx5Cj4+IHlvdSBydW4gY2F0YWx5c3QucGwgZnJvbSB0aGUgb3V0c2lk
ZSAtIGFuZCB0aGVuIHlvdSBnbyBpbnRvIHRoZQo+PiBnZW5lcmF0ZWQgZGlyZWN0b3J5IGFuZCB1
c2Ugb25lIG9mIHRoZSBnZW5lcmF0ZWQgc2NyaXB0cyB0byBnZW5lcmF0ZQo+PiB0aGUgZnVydGhl
ciBjb21wb25lbnRzLiAgSW4gdGhlb3J5IGl0IHNob3VsZCBiZSBwb3NzaWJsZSB0aGF0IGFsbCB0
aGF0Cj4+IGdlbmVyYXRpb24gaXMgZG9uZSBieSBjYXRhbHlzdC5wbC4KPj4KPj4gQ2hlZXJzLAo+
PiBaYmlnbmlldwo+PiBodHRwOi8vYnJ1ZG5vcGlzLmJsb2dzcG90LmNvbS8KPj4gaHR0cDovL3Bl
cmxhbGNoZW15LmJsb2dzcG90LmNvbS8KPj4KPj4gX19fX19fX19fX19fX19fX19fX19fX19fX19f
X19fX19fX19fX19fX19fX19fX18KPj4gQ2F0YWx5c3QtZGV2IG1haWxpbmcgbGlzdAo+PiBDYXRh
bHlzdC1kZXZAbGlzdHMuc2NzeXMuY28udWsKPj4gaHR0cDovL2xpc3RzLnNjc3lzLmNvLnVrL2Nn
aS1iaW4vbWFpbG1hbi9saXN0aW5mby9jYXRhbHlzdC1kZXYKPj4KPgo+IEhpIFpiaWduaWV3LAo+
Cj4gVGhhbmtzIGZvciB0aGUgaW5wdXQhICAoVGhhbmtzIHRvIEZyYW5jZXNjIGFzIHdlbGwsIEkg
ZGlkbid0IHRoYW5rIHlvdSBpbgo+IG15IGxhc3QgZW1haWwpLgo+Cj4gUGVyaGFwcyB5b3UgY291
bGQgZmxlc2ggb3V0IHlvdXIgaWRlYSBzb21lPyBHaXZlIG1lIGFuIGV4YW1wbGUgb2YgaG93IGl0
Cj4gd291bGQgbG9vayBpbiB1c2FnZSwgSSB0aGluayBJJ20gdmlzdWFsaXppbmcgaXQgcHJvcGVy
bHksIGJ1dCBzb21lIGNvbmNyZXRlCj4gZXhhbXBsZXMgd291bGQgYmUgc3VwZXJiLgo+CgoKSSB0
aGluayB0aGUgYmVnaW5uaW5nIHdvdWxkIGJlIHRvIGp1c3QgbGV0IGNhdGFseXN0LnBsIHJ1biBh
bGwgdGhlIG90aGVyCmhlbHBlcnMuCkxpa2U6CgpjYXRhbHlzdC5wbCBNeUFwcCBtb2RlbCBDYXRh
bHlzdE1vZGVsTmFtZSBEQklDOjpTY2hlbWEgTXlBcHA6OlNjaGVtYUNsYXNzCgpTbyB5b3UganVz
dCBhZGQgdGhlIE15QXBwIGF0IHRoZSBzdGFydCAtIGFuZCB0aGUgcmVzdCBnb2VzIGp1c3QgbGlr
ZSBpdCB3YXMKbXlfYXBwX2NyZWF0ZS5wbC4KCklmIHRoYXQgaXMgZG9uZSAtIHRoaXMgc2hvdWxk
IG9wZW4gdGhlIHBvc3NpYmlsaXRpZXMgZm9yIGFsbCB0aGUgb3RoZXIKbW9kaWZpY2F0aW9ucy4K
CkNoZWVycywKWmJpZ25pZXcKCgo+IFRoYW5rcyBhZ2FpbiEKPgo+IC1EZXZpbgo+Cj4KPiAtLQo+
IERldmluIEF1c3Rpbgo+IGh0dHA6Ly93d3cuY29kZWRyaWdodC5uZXQKPiBodHRwOi8vd3d3LmRy
ZWFtaG9zdC5jb20vci5jZ2k/MzI2NTY4L2hvc3RpbmcuaHRtbCAtIEhvc3Qgd2l0aCBEcmVhbUhv
c3QhCj4KPiBfX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fX19fXwo+
IENhdGFseXN0LWRldiBtYWlsaW5nIGxpc3QKPiBDYXRhbHlzdC1kZXZAbGlzdHMuc2NzeXMuY28u
dWsKPiBodHRwOi8vbGlzdHMuc2NzeXMuY28udWsvY2dpLWJpbi9tYWlsbWFuL2xpc3RpbmZvL2Nh
dGFseXN0LWRldgo+Cj4KCgotLSAKWmJpZ25pZXcgTHVrYXNpYWsKaHR0cDovL2JydWRub3Bpcy5i
bG9nc3BvdC5jb20vCmh0dHA6Ly9wZXJsYWxjaGVteS5ibG9nc3BvdC5jb20vCi0tLS0tLS0tLS0t
LS0tIG5leHQgcGFydCAtLS0tLS0tLS0tLS0tLQpBbiBIVE1MIGF0dGFjaG1lbnQgd2FzIHNjcnVi
YmVkLi4uClVSTDogaHR0cDovL2xpc3RzLnNjc3lzLmNvLnVrL3BpcGVybWFpbC9jYXRhbHlzdC1k
ZXYvYXR0YWNobWVudHMvMjAwOTA2MTcvYjc1M2EzNjcvYXR0YWNobWVudC5odG0K