FLEXRuntime+UIKitHelpers.m 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402
  1. //
  2. // FLEXRuntime+UIKitHelpers.m
  3. // FLEX
  4. //
  5. // Created by Tanner Bennett on 12/16/19.
  6. // Copyright © 2019 Flipboard. All rights reserved.
  7. //
  8. #import "FLEXRuntime+UIKitHelpers.h"
  9. #import "FLEXRuntimeUtility.h"
  10. #import "FLEXPropertyAttributes.h"
  11. #import "FLEXArgumentInputViewFactory.h"
  12. #import "FLEXObjectExplorerFactory.h"
  13. #import "FLEXFieldEditorViewController.h"
  14. #import "FLEXMethodCallingViewController.h"
  15. #import "FLEXTableView.h"
  16. #import "NSArray+Functional.h"
  17. #pragma mark FLEXProperty
  18. @implementation FLEXProperty (UIKitHelpers)
  19. /// Decide whether to use object or [object class] to get or set property
  20. - (id)targetForPropertyTypeGivenObject:(id)object {
  21. if (!object_isClass(object)) {
  22. if (self.isClassProperty) {
  23. return [object class];
  24. } else {
  25. return object;
  26. }
  27. } else {
  28. if (self.isClassProperty) {
  29. return object;
  30. } else {
  31. // Instance property with a class object
  32. return nil;
  33. }
  34. }
  35. }
  36. - (BOOL)isEditable {
  37. if (self.attributes.isReadOnly) {
  38. return self.likelySetterExists;
  39. }
  40. const FLEXTypeEncoding *typeEncoding = self.attributes.typeEncoding.UTF8String;
  41. return [FLEXArgumentInputViewFactory canEditFieldWithTypeEncoding:typeEncoding currentValue:nil];
  42. }
  43. - (BOOL)isCallable {
  44. return YES;
  45. }
  46. - (id)currentValueWithTarget:(id)object {
  47. return [self getPotentiallyUnboxedValue:
  48. [self targetForPropertyTypeGivenObject:object]
  49. ];
  50. }
  51. - (NSString *)previewWithTarget:(id)object {
  52. if (object_isClass(object) && !self.isClassProperty) {
  53. return self.attributes.fullDeclaration;
  54. } else {
  55. return [FLEXRuntimeUtility
  56. summaryForObject:[self currentValueWithTarget:object]
  57. ];
  58. }
  59. }
  60. - (UIViewController *)viewerWithTarget:(id)object {
  61. id value = [self currentValueWithTarget:object];
  62. return [FLEXObjectExplorerFactory explorerViewControllerForObject:value];
  63. }
  64. - (UIViewController *)editorWithTarget:(id)object {
  65. id target = [self targetForPropertyTypeGivenObject:object];
  66. return [FLEXFieldEditorViewController target:target property:self];
  67. }
  68. - (UITableViewCellAccessoryType)suggestedAccessoryTypeWithTarget:(id)object {
  69. id targetForValueCheck = [self targetForPropertyTypeGivenObject:object];
  70. if (!targetForValueCheck) {
  71. // Instance property with a class object
  72. return UITableViewCellAccessoryNone;
  73. }
  74. // We use .tag to store the cached value of .isEditable that is
  75. // initialized by FLEXObjectExplorer in -reloadMetada
  76. if ([self getPotentiallyUnboxedValue:targetForValueCheck]) {
  77. if (self.tag) {
  78. // Editable non-nil value, both
  79. return UITableViewCellAccessoryDetailDisclosureButton;
  80. } else {
  81. // Uneditable non-nil value, chevron only
  82. return UITableViewCellAccessoryDisclosureIndicator;
  83. }
  84. } else {
  85. if (self.tag) {
  86. // Editable nil value, just (i)
  87. return UITableViewCellAccessoryDetailButton;
  88. } else {
  89. // Non-editable nil value, neither
  90. return UITableViewCellAccessoryNone;
  91. }
  92. }
  93. }
  94. - (NSString *)reuseIdentifierWithTarget:(id)object { return nil; }
  95. @end
  96. #pragma mark FLEXIvar
  97. @implementation FLEXIvar (UIKitHelpers)
  98. - (BOOL)isEditable {
  99. const FLEXTypeEncoding *typeEncoding = self.typeEncoding.UTF8String;
  100. return [FLEXArgumentInputViewFactory canEditFieldWithTypeEncoding:typeEncoding currentValue:nil];
  101. }
  102. - (BOOL)isCallable {
  103. return NO;
  104. }
  105. - (id)currentValueWithTarget:(id)object {
  106. if (!object_isClass(object)) {
  107. return [self getPotentiallyUnboxedValue:object];
  108. }
  109. return nil;
  110. }
  111. - (NSString *)previewWithTarget:(id)object {
  112. if (object_isClass(object)) {
  113. return self.details;
  114. }
  115. return [FLEXRuntimeUtility
  116. summaryForObject:[self currentValueWithTarget:object]
  117. ];
  118. }
  119. - (UIViewController *)viewerWithTarget:(id)object {
  120. NSAssert(!object_isClass(object), @"Unreachable state: viewing ivar on class object");
  121. id value = [self currentValueWithTarget:object];
  122. return [FLEXObjectExplorerFactory explorerViewControllerForObject:value];
  123. }
  124. - (UIViewController *)editorWithTarget:(id)object {
  125. NSAssert(!object_isClass(object), @"Unreachable state: editing ivar on class object");
  126. return [FLEXFieldEditorViewController target:object ivar:self];
  127. }
  128. - (UITableViewCellAccessoryType)suggestedAccessoryTypeWithTarget:(id)object {
  129. if (object_isClass(object)) {
  130. return UITableViewCellAccessoryNone;
  131. }
  132. // Could use .isEditable here, but we use .tag for speed since it is cached
  133. if ([self getPotentiallyUnboxedValue:object]) {
  134. if (self.tag) {
  135. // Editable non-nil value, both
  136. return UITableViewCellAccessoryDetailDisclosureButton;
  137. } else {
  138. // Uneditable non-nil value, chevron only
  139. return UITableViewCellAccessoryDisclosureIndicator;
  140. }
  141. } else {
  142. if (self.tag) {
  143. // Editable nil value, just (i)
  144. return UITableViewCellAccessoryDetailButton;
  145. } else {
  146. // Non-editable nil value, neither
  147. return UITableViewCellAccessoryNone;
  148. }
  149. }
  150. }
  151. - (NSString *)reuseIdentifierWithTarget:(id)object { return nil; }
  152. @end
  153. #pragma mark FLEXMethod*
  154. @implementation FLEXMethodBase (UIKitHelpers)
  155. - (BOOL)isEditable {
  156. return NO;
  157. }
  158. - (BOOL)isCallable {
  159. return NO;
  160. }
  161. - (id)currentValueWithTarget:(id)object {
  162. // Methods can't be "edited" and have no "value"
  163. return nil;
  164. }
  165. - (NSString *)previewWithTarget:(id)object {
  166. return [self.selectorString stringByAppendingFormat:@" — %@", self.typeEncoding];
  167. }
  168. - (UIViewController *)viewerWithTarget:(id)object {
  169. // We disallow calling of FLEXMethodBase methods
  170. @throw NSInternalInconsistencyException;
  171. return nil;
  172. }
  173. - (UIViewController *)editorWithTarget:(id)object {
  174. // Methods cannot be edited
  175. @throw NSInternalInconsistencyException;
  176. return nil;
  177. }
  178. - (UITableViewCellAccessoryType)suggestedAccessoryTypeWithTarget:(id)object {
  179. // We shouldn't be using any FLEXMethodBase objects for this
  180. @throw NSInternalInconsistencyException;
  181. return UITableViewCellAccessoryNone;
  182. }
  183. - (NSString *)reuseIdentifierWithTarget:(id)object { return nil; }
  184. @end
  185. @implementation FLEXMethod (UIKitHelpers)
  186. - (BOOL)isCallable {
  187. return self.signature != nil;
  188. }
  189. - (UIViewController *)viewerWithTarget:(id)object {
  190. object = self.isInstanceMethod ? object : (object_isClass(object) ? object : [object class]);
  191. return [FLEXMethodCallingViewController target:object method:self];
  192. }
  193. - (UITableViewCellAccessoryType)suggestedAccessoryTypeWithTarget:(id)object {
  194. if (self.isInstanceMethod) {
  195. if (object_isClass(object)) {
  196. // Instance method from class, can't call
  197. return UITableViewCellAccessoryNone;
  198. } else {
  199. // Instance method from instance, can call
  200. return UITableViewCellAccessoryDisclosureIndicator;
  201. }
  202. } else {
  203. return UITableViewCellAccessoryDisclosureIndicator;
  204. }
  205. }
  206. @end
  207. #pragma mark FLEXProtocol
  208. @implementation FLEXProtocol (UIKitHelpers)
  209. - (BOOL)isEditable {
  210. return NO;
  211. }
  212. - (BOOL)isCallable {
  213. return NO;
  214. }
  215. - (id)currentValueWithTarget:(id)object {
  216. return nil;
  217. }
  218. - (NSString *)previewWithTarget:(id)object {
  219. return nil;
  220. }
  221. - (UIViewController *)viewerWithTarget:(id)object {
  222. return [FLEXObjectExplorerFactory explorerViewControllerForObject:self];
  223. }
  224. - (UIViewController *)editorWithTarget:(id)object {
  225. return nil;
  226. }
  227. - (UITableViewCellAccessoryType)suggestedAccessoryTypeWithTarget:(id)object {
  228. return UITableViewCellAccessoryDisclosureIndicator;
  229. }
  230. - (NSString *)reuseIdentifierWithTarget:(id)object { return nil; }
  231. @end
  232. #pragma mark FLEXStaticMetadata
  233. @interface FLEXStaticMetadata () {
  234. @protected
  235. NSString *_name;
  236. }
  237. @property (nonatomic) FLEXTableViewCellReuseIdentifier reuse;
  238. @property (nonatomic) NSString *subtitle;
  239. @property (nonatomic) id metadata;
  240. @end
  241. @interface FLEXStaticMetadata_Class : FLEXStaticMetadata
  242. + (instancetype)withClass:(Class)cls;
  243. @end
  244. @implementation FLEXStaticMetadata
  245. @synthesize name = _name;
  246. @synthesize tag = _tag;
  247. + (NSArray<FLEXStaticMetadata *> *)classHierarchy:(NSArray<Class> *)classes {
  248. return [classes flex_mapped:^id(Class cls, NSUInteger idx) {
  249. return [FLEXStaticMetadata_Class withClass:cls];
  250. }];
  251. }
  252. + (instancetype)style:(FLEXStaticMetadataRowStyle)style title:(NSString *)title string:(NSString *)string {
  253. return [[self alloc] initWithStyle:style title:title subtitle:string];
  254. }
  255. + (instancetype)style:(FLEXStaticMetadataRowStyle)style title:(NSString *)title number:(NSNumber *)number {
  256. return [[self alloc] initWithStyle:style title:title subtitle:number.stringValue];
  257. }
  258. - (id)initWithStyle:(FLEXStaticMetadataRowStyle)style title:(NSString *)title subtitle:(NSString *)subtitle {
  259. self = [super init];
  260. if (self) {
  261. if (style == FLEXStaticMetadataRowStyleKeyValue) {
  262. _reuse = kFLEXKeyValueCell;
  263. } else {
  264. _reuse = kFLEXMultilineDetailCell;
  265. }
  266. _name = title;
  267. _subtitle = subtitle;
  268. }
  269. return self;
  270. }
  271. - (NSString *)description {
  272. return self.name;
  273. }
  274. - (NSString *)reuseIdentifierWithTarget:(id)object {
  275. return self.reuse;
  276. }
  277. - (BOOL)isEditable {
  278. return NO;
  279. }
  280. - (BOOL)isCallable {
  281. return NO;
  282. }
  283. - (id)currentValueWithTarget:(id)object {
  284. return nil;
  285. }
  286. - (NSString *)previewWithTarget:(id)object {
  287. return self.subtitle;
  288. }
  289. - (UIViewController *)viewerWithTarget:(id)object {
  290. return nil;
  291. }
  292. - (UIViewController *)editorWithTarget:(id)object {
  293. return nil;
  294. }
  295. - (UITableViewCellAccessoryType)suggestedAccessoryTypeWithTarget:(id)object {
  296. return UITableViewCellAccessoryNone;
  297. }
  298. @end
  299. #pragma mark FLEXStaticMetadata_Class
  300. @implementation FLEXStaticMetadata_Class
  301. + (instancetype)withClass:(Class)cls {
  302. NSParameterAssert(cls);
  303. FLEXStaticMetadata_Class *metadata = [self new];
  304. metadata.metadata = cls;
  305. metadata->_name = NSStringFromClass(cls);
  306. metadata.reuse = kFLEXDefaultCell;
  307. return metadata;
  308. }
  309. - (id)initWithStyle:(FLEXStaticMetadataRowStyle)style title:(NSString *)title subtitle:(NSString *)subtitle {
  310. @throw NSInternalInconsistencyException;
  311. return nil;
  312. }
  313. - (UIViewController *)viewerWithTarget:(id)object {
  314. return [FLEXObjectExplorerFactory explorerViewControllerForObject:self.metadata];
  315. }
  316. - (UITableViewCellAccessoryType)suggestedAccessoryTypeWithTarget:(id)object {
  317. return UITableViewCellAccessoryDisclosureIndicator;
  318. }
  319. @end