soot.jimple.toolkits.annotation.purity.PurityAnalysis Maven / Gradle / Ivy

package soot.jimple.toolkits.annotation.purity;

/*-
 * #%L
 * Soot - a J*va Optimization Framework
 * %%
 * Copyright (C) 2005 Antoine Mine
 * %%
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as
 * published by the Free Software Foundation, either version 2.1 of the
 * License, or (at your option) any later version.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Lesser Public License for more details.
 * 
 * You should have received a copy of the GNU General Lesser Public
 * License along with this program.  If not, see
 * .
 * #L%
 */

import java.util.Map;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import soot.G;
import soot.Scene;
import soot.SceneTransformer;
import soot.Singletons;
import soot.jimple.toolkits.callgraph.CallGraph;
import soot.options.PurityOptions;

/**
 * Purity analysis phase.
 *
 * TODO: - test, test, and test (and correct the potentially infinite bugs) - optimise PurityGraph, especially methodCall) -
 * find a better abstraction for exceptions (throw & catch) - output nicer graphs (especially clusters!)
 */
public class PurityAnalysis extends SceneTransformer {
  private static final Logger logger = LoggerFactory.getLogger(PurityAnalysis.class);

  Singletons.Global g;

  public PurityAnalysis(Singletons.Global g) {
    this.g = g;
  }

  public static PurityAnalysis v() {
    return G.v().soot_jimple_toolkits_annotation_purity_PurityAnalysis();
  }

  @Override
  protected void internalTransform(String phaseName, Map options) {
    PurityOptions opts = new PurityOptions(options);

    logger.debug("[AM] Analysing purity");

    CallGraph cg = Scene.v().getCallGraph();

    // launch the analysis
    new PurityInterproceduralAnalysis(cg, Scene.v().getEntryPoints().iterator(), opts);
  }
}