|
| 1 | +/** |
| 2 | + * Provides modeling for the `ActionMailer` library. |
| 3 | + */ |
| 4 | + |
| 5 | +private import codeql.ruby.AST |
| 6 | +private import codeql.ruby.ApiGraphs |
| 7 | +private import codeql.ruby.frameworks.internal.Rails |
| 8 | + |
| 9 | +/** |
| 10 | + * Provides modeling for the `ActionMailer` library. |
| 11 | + */ |
| 12 | +module ActionMailer { |
| 13 | + /** |
| 14 | + * A `ClassDeclaration` for a class that extends `ActionMailer::Base`. |
| 15 | + * For example, |
| 16 | + * |
| 17 | + * ```rb |
| 18 | + * class FooMailer < ActionMailer::Base |
| 19 | + * ... |
| 20 | + * end |
| 21 | + * ``` |
| 22 | + */ |
| 23 | + class MailerClass extends ClassDeclaration { |
| 24 | + MailerClass() { |
| 25 | + this.getSuperclassExpr() = |
| 26 | + [ |
| 27 | + API::getTopLevelMember("ActionMailer").getMember("Base"), |
| 28 | + // In Rails applications `ApplicationMailer` typically extends |
| 29 | + // `ActionMailer::Base`, but we treat it separately in case the |
| 30 | + // `ApplicationMailer` definition is not in the database. |
| 31 | + API::getTopLevelMember("ApplicationMailer") |
| 32 | + ].getASubclass().getAValueReachableFromSource().asExpr().getExpr() |
| 33 | + } |
| 34 | + } |
| 35 | + |
| 36 | + /** A method call with a `self` receiver from within a mailer class */ |
| 37 | + private class ContextCall extends MethodCall { |
| 38 | + private MailerClass mailerClass; |
| 39 | + |
| 40 | + ContextCall() { |
| 41 | + this.getReceiver() instanceof SelfVariableAccess and |
| 42 | + this.getEnclosingModule() = mailerClass |
| 43 | + } |
| 44 | + |
| 45 | + /** Gets the mailer class containing this method. */ |
| 46 | + MailerClass getMailerClass() { result = mailerClass } |
| 47 | + } |
| 48 | + |
| 49 | + /** A call to `params` from within a mailer. */ |
| 50 | + class ParamsCall extends ContextCall, ParamsCallImpl { |
| 51 | + ParamsCall() { this.getMethodName() = "params" } |
| 52 | + } |
| 53 | +} |
0 commit comments