KnockKnock/utilities.h

//
//  utilities.h
//  KnockKnock
//
//  Created by Patrick Wardle on 2/7/15.
//  Copyright (c) 2015 Objective-See. All rights reserved.
//

#ifndef KnockKnock_Utilities_h
#define KnockKnock_Utilities_h

/* FUNCTIONS */

//get OS's major or minor version
SInt32 getVersion(OSType selector);

//disable std err
void disableSTDERR(void);

//get name of logged in user
NSString* getConsoleUser(void);

//get all users
NSMutableDictionary* allUsers(void);

//give a list of paths
// convert any `~` to all or current user
NSMutableArray* expandPaths(const __strong NSString* const paths[], int count);

//given a path to binary
// parse it back up to find app's bundle
NSBundle* findAppBundle(NSString* binaryPath);

//get an icon for a process
// ->for apps, this will be app's icon, otherwise just a standard system one
NSImage* getIconForBinary(NSString* binary, NSBundle* bundle);

//given a directory and a filter predicate
// ->return all matches
NSArray* directoryContents(NSString* directory, NSString* predicate);

//hash a file
NSDictionary* hashFile(NSString* filePath);

//get app's version
// ->extracted from Info.plist
NSString* getAppVersion(void);

//convert a textview to a clickable hyperlink
void makeTextViewHyperlink(NSTextField* textField, NSURL* url);

//set the color of an attributed string
NSMutableAttributedString* setStringColor(NSAttributedString* string, NSColor* color);

//exec a process and grab it's output
NSData* execTask(NSString* binaryPath, NSArray* arguments, int* exitCode);

//check if computer has network connection
BOOL isNetworkConnected(void);

//find a constraint (by name) of a view
NSLayoutConstraint* findConstraint(NSView* view, NSString* constraintName);

//given a 'short' path or process name
// ->find the full path by scanning $PATH
NSString* which(NSString* processName);

//get array of running procs
// ->returns an array of process paths
NSMutableArray* runningProcesses(void);

//check if a file is a binary
BOOL isBinary(NSString* file);

//lookup object in dictionary
// note: key can be case-insensitive
id extractFromDictionary(NSDictionary* dictionary, NSString* sensitiveKey);

//check if (full) dark mode
// meaning, Mojave+ and dark mode enabled
BOOL isDarkMode(void);

//bring an app to foreground (to get an icon in the dock) or background
void transformProcess(ProcessApplicationTransformState location);

//set line space
void setLineSpacing(NSTextField* textField, CGFloat lineSpacing);

//check for full disk access
BOOL hasFDA(void);

//save (user's) VT API key to keyhain
BOOL saveAPIKeyToKeychain(NSString* apiKey);

//(re)load key from
NSString* loadAPIKeyFromKeychain(void);

//file protected by SIP?
BOOL isRestricted(const char *path);

//toggle login item
// either add (install) or remove (uninstall)
void toggleLoginItem(NSURL* loginItem, NSControlStateValue state);

#endif