Skip to content

Latest commit

 

History

History
37 lines (25 loc) · 1.78 KB

Logging.md

File metadata and controls

37 lines (25 loc) · 1.78 KB
Raw

Logging

MagicalRecord has logging built in to most of its interactions with Core Data. When errors occur during fetching or saving data, these errors are captured and (if you've enabled them) logged to the console.

Logging can be enabled by placing the following preprocessor statement before your first import of CoreData+MagicalRecord.h, like so:

#define MR_LOGGING_ENABLED 1
#import <MagicalRecord/CoreData+MagicalRecord.h>

Logging can also be enabled by passing -DMR_LOGGING_ENABLED=1 to OTHER_CFLAGS (shown as "Other C Flags" in Xcode's Build Settings). If you have trouble with with the first approach, adding this build setting should work.

Logging can be configured by calling [MagicalRecord setLoggingLevel:…]; using one of the predefined logging levels:

  • MagicalRecordLogLevelOff: Don't log anything
  • MagicalRecordLoggingLevelFatal: Log all fatal messages
  • MagicalRecordLoggingLevelError: Log all errors and fatal messages
  • MagicalRecordLoggingLevelWarn: Log warnings, errors and fatal messages
  • MagicalRecordLoggingLevelInfo: Log informative, warning and error messages
  • MagicalRecordLoggingLevelVerbose: Log verbose diagnostic, informative, warning and error messages

The logging level defaults to MagicalRecordLoggingLevelWarn.

Disabling Logs

Setting the logging level to MagicalRecordLogLevelOff completely disables MagicalRecord's logging.

CocoaLumberjack

If it's available, MagicalRecord will direct its logs to CocoaLumberjack. All you need to do is make sure you've imported CocoaLumberjack before you import MagicalRecord, like so:

#import <CocoaLumberjack/DDLog.h>
#define MR_LOGGING_ENABLED 1
#import <MagicalRecord/CoreData+MagicalRecord.h>