1/*
2 * Copyright (c) 2007 Mockito contributors
3 * This program is made available under the terms of the MIT License.
4 */
5package org.mockito.invocation;
6
7import org.mockito.exceptions.PrintableInvocation;
8import org.mockito.Incubating;
9
10/**
11 * Provides information about the invocation, specifically a human readable description and the location.
12 */
13@Incubating
14public interface DescribedInvocation extends PrintableInvocation {
15
16    /**
17     * Describes the invocation in the human friendly way.
18     *
19     * @return the description of this invocation.
20     */
21    String toString();
22
23    /**
24     * The place in the code where the invocation happened.
25     *
26     * @return the location of the invocation.
27     */
28    Location getLocation();
29}
30