Package randoop

Interface Summary
Interface Description
Check A correctness check performed on some aspect of a unit test's execution.
ExecutionVisitor A visitor that is invoked as the execution of a sequence unfolds.
IEventListener Defines various event during Randoop's generation at which an implementing class can be notified and perform some action.
IStopper Used by Randoop to determine whether generation should stop.
ITestFilter Used by Randoop's test generator to determine if a given sequence should be output to the user.
ObjectContract An object contract provides the core functionality for the checking code of unit tests, i.e.
StateMatcher  
StatementKind Represents a kind of statement that can be part of a sequence, for example, a method call, constructor call, or primitive value declaration.
 

Class Summary
Class Description
AbstractGenerator Algorithm template for implementing a test generator.
ArrayDeclaration Immutable.
CheckRepContract Represents the contract that an object should conform to its representation invariant, as expressed in a user-supplied representation check method.A rep check method for a class must be declared as a public instance method with no parameters in the given class, annotated with a @CheckRep annotation, and have return type boolean or void.
ClassLiterals For a given class C, ClassLiterals maps C (if present) to a collection of literals (represented as single-element sequences) that can be used as inputs to members of the given class.
ComponentManager Stores and provides means to access the component sequences generated during a run of Randoop.
ContractCheckingVisitor An execution visitor that checks unary and binary object contracts on the values created by the sequence.
DefaultTestFilter Randoop's default test filter determines if a generated test should be output to the user.
DummyStatement  
DummyVisitor A visitor that does nothing and adds no checks.
EqualsHashcode The contract: o1.equals(o2) => o1.hashCode() == o2.hashCode().
EqualsMethodMatcher  
EqualsReflexive The contract: x0.equals(x0)==true.
EqualsSymmetric The contract: o1.equals(o2) => o2.equals(o1).
EqualsToNullRetFalse The contract: x0.equals(null)==false.
EverythingIsDifferentMatcher  
ExceptionalExecution Means that the execution of a statement threw an exception.
ExecutableSequence An ExecutableSequence wraps a Sequence with functionality for executing the sequence.
Execution Represents the unfolding execution of a sequence.
ExecutionOutcome Represents the outcome of executing one statement in a sequence, including the value returned by the statement, or the exception thrown.
ExpectedExceptionCheck A checker that checks for an expected exception from a method call.
FailureSet  
FailureSet.Failure  
ForwardGenerator Randoop's forward, component-based generator.
Globals Various general global variables used throughout Randoop.
Globals.ErrorStreamAssigner  
HashCodeReturnsNormally Checks that calling hashCode() on an object does not throw an exception.
HelperSequenceCreator  
IsNotNull The contract: x != null.
IsNull The contract: x == null.
JavaFileWriter Outputs a collection of sequences as Java files, with one method per sequence.
JunitFileWriter Outputs a collection of sequences as Java files, using the JUnit framework, with one method per sequence.
LiteralFileReader Reads a file specifying literal values to use during generation.
MappedSequences<T> A multimap from keys of type T to sequences.
MSequence A sequence that can be mutated (unlike a Sequence, which is immutable).
MStatement A statement that is part of a mutable sequence.
MultiVisitor An execution visitor that chains a list of visitors in sequence.
MVariable A variable that is part of a mutable sequence.
NoExceptionCheck Checks that no exception is thrown after a given statement in a sequence.
NormalExecution Means that the statement that this result represents completed normally.
NotExecuted Means that the statement that this outcome represents was not executed.
ObjectCache  
ObjectCheck A check that checks for expected properties of one or more objects generated during the execution of a Sequence, for example:
ObjectContractUtils Utility methods for safely executing and printing ObjectContract code.
ObserverEqValue A check recording the value that an observer method returned during execution, e.g.
PackageLiterals For a given package P, PackageLiterals maps P (if present) to a collection of literals (represented as single-element sequences) that can be used as inputs to classes in the given package.
PrimitiveOrStringOrNullDecl Represents a primitive value (including Strings).
PrimValue An check recording the value of a primitive value obtained during execution, (e.g.
RandoopListenerManager  
RConstructor Represents a constructor call.
RegressionCaptureVisitor An execution visitor that records regression checks on the values created by the sequence.
ReplayVisitor An execution visitor that evaluates the checks in the given executable sequence, and returns false if any of them fail.
RMethod Represents a method call.
SeedSequences Provides functionality for creating a set of sequences that create a set of primitive values.
Sequence Immutable.
Sequence.RelativeNegativeIndex  
SequenceCollection A collection of sequences that makes its efficient to ask for all the sequences that create a value of a given type.
SerializableArrayDeclaration  
SerializableCheckRepContract  
SerializableExpectedExceptionChecker  
SerializableObserverEqValue  
SerializablePrimitiveOrStringOrNullDecl  
SerializableRConstructor  
SerializableRMethod  
Statement The elements of a Sequence.
StatementKinds  
SubTypeSet A set of classes.
ToStringReturnsNormally Checks that calling toString() on an object does not throw an exception.
Variable Represents the result of a statement call in a sequence.
 

Enum Summary
Enum Description
PrimValue.PrintMode Specifies how the contract is to be printed.
 

Exception Summary
Exception Description
BugInRandoopException Thrown to indicate exceptional behavior that definitely indicates a bug in Randoop.
ReplayFailureException Thrown by a ContractFailureReplayVisitor or a RegressionReplayVisitor when a regression decoration fails to replay.
SequenceParseException  
StatementKindParseException  
TimeOutException  
 

Annotation Types Summary
Annotation Type Description
CheckRep An annotation that a user of Randoop can place next to a method to specify that that the method should be used as a representation invariant.
NotPartOfState  
Observer An observer method does not change the state of receiver or parameters.
Omit  
RandoopStat  
TestValue Signals to Randoop that the value of a primitive (or primitive array) field in a class under test should be used as an input value to methods under test.