KSCrashReportSinkEMail.h 2.8 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768
  1. //
  2. // KSCrashReportSinkEMail.h
  3. //
  4. // Created by Karl Stenerud on 2012-05-06.
  5. //
  6. // Copyright (c) 2012 Karl Stenerud. All rights reserved.
  7. //
  8. // Permission is hereby granted, free of charge, to any person obtaining a copy
  9. // of this software and associated documentation files (the "Software"), to deal
  10. // in the Software without restriction, including without limitation the rights
  11. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  12. // copies of the Software, and to permit persons to whom the Software is
  13. // furnished to do so, subject to the following conditions:
  14. //
  15. // The above copyright notice and this permission notice shall remain in place
  16. // in this source code.
  17. //
  18. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  19. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  20. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  21. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  22. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  23. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  24. // THE SOFTWARE.
  25. //
  26. #import <Foundation/Foundation.h>
  27. #import "KSCrashReportFilter.h"
  28. /** Sends reports via email.
  29. *
  30. * Input: NSData
  31. * Output: Same as input (passthrough)
  32. */
  33. @interface KSCrashReportSinkEMail : NSObject <KSCrashReportFilter>
  34. /**
  35. * @param recipients List of email addresses to send to.
  36. * @param subject What to put in the subject field.
  37. * @param message A message to accompany the reports (optional - nil = ignore).
  38. * @param filenameFmt How to name the attachments. You may use "%d" to differentiate
  39. * when multiple reports are sent at once.
  40. * Note: With the default filter set, files are gzipped text.
  41. */
  42. + (KSCrashReportSinkEMail*) sinkWithRecipients:(NSArray*) recipients
  43. subject:(NSString*) subject
  44. message:(NSString*) message
  45. filenameFmt:(NSString*) filenameFmt;
  46. /**
  47. * @param recipients List of email addresses to send to.
  48. * @param subject What to put in the subject field.
  49. * @param message A message to accompany the reports (optional - nil = ignore).
  50. * @param filenameFmt How to name the attachments. You may use "%d" to differentiate
  51. * when multiple reports are sent at once.
  52. * Note: With the default filter set, files are gzipped text.
  53. */
  54. - (id) initWithRecipients:(NSArray*) recipients
  55. subject:(NSString*) subject
  56. message:(NSString*) message
  57. filenameFmt:(NSString*) filenameFmt;
  58. - (id <KSCrashReportFilter>) defaultCrashReportFilterSet;
  59. - (id <KSCrashReportFilter>) defaultCrashReportFilterSetAppleFmt;
  60. @end