package aQute.service.reporter;

import java.util.*;

/**
 * A base interface to represent the state of a work in progress.
 */
public interface Report {
	/**
	 * Defines a record for the location of an error/warning
	 */
	class Location {
		public String	message;
		public int		line;
		public String	file;
		public String	header;
		public String	context;
		public String	reference;
		public String	methodName;
	}


	/**
	 * Return the warnings. This list must not be changed and may be immutable.
	 * 
	 * @return the warnings
	 */
	List<String> getWarnings();

	/**
	 * Return the errors. This list must not be changed and may be immutable.
	 * 
	 * @return the errors
	 */
	List<String> getErrors();

	/**
	 * Return the errors for the given error or warning. Can return null.
	 * 
	 * @param msg
	 *            The message
	 * @return null or the location of the message
	 */
	Location getLocation(String msg);

	/**
	 * Check if this report has any errors.
	 * 
	 * @return true if errors is empty
	 */
	
	boolean isOk();
}