diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/anyAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/anyAssertions.kt index 980bbdfd15..066a5d4964 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/anyAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/anyAssertions.kt @@ -11,7 +11,6 @@ import ch.tutteli.kbox.glue * Expects that the subject of the assertion is (equal to) [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.AnyAssertionSamples.toBe */ @@ -21,7 +20,6 @@ fun Expect.toBe(expected: T): Expect = _logicAppend { toBe(expected) } * Expects that the subject of the assertion is not (equal to) [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.AnyAssertionSamples.notToBe */ @@ -31,7 +29,6 @@ fun Expect.notToBe(expected: T): Expect = _logicAppend { notToBe(expec * Expects that the subject of the assertion is the same instance as [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.AnyAssertionSamples.isSameAs */ @@ -41,7 +38,6 @@ fun Expect.isSameAs(expected: T): Expect = _logicAppend { isSameAs(exp * Expects that the subject of the assertion is not the same instance as [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.AnyAssertionSamples.isNotSameAs */ @@ -67,7 +63,6 @@ fun Expect.because(reason: String, assertionCreator: Expect.() -> Unit * is `null` or is not `null` and holds all assertions [assertionCreatorOrNull] creates. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.AnyAssertionSamples.toBeNullIfNullGivenElse */ @@ -79,7 +74,6 @@ fun Expect.toBeNullIfNullGivenElse( * Expects that the subject of the assertion is not null and changes the subject to the non-nullable version. * * @return An [Expect] with the non-nullable type [T] (was `T?` before). - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.AnyAssertionSamples.notToBeNullFeature */ @@ -91,7 +85,6 @@ inline fun Expect.notToBeNull(): Expect = * that it holds all assertions the given [assertionCreator] creates. * * @return An [Expect] with the non-nullable type [T] (was `T?` before) - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.AnyAssertionSamples.notToBeNull */ @@ -115,7 +108,6 @@ inline fun Expect.notToBeNull(noinline assertionCreator: E * `assert(listOf(1, 2)).isA>{}` holds, even though `List` is clearly not a `List`. * * @return An [Expect] with the new type [TSub]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.AnyAssertionSamples.isAFeature */ @@ -161,7 +153,6 @@ inline fun Expect<*>.isA(): Expect = * `assert(listOf(1, 2)).isA>{}` holds, even though `List` is clearly not a `List`. * * @return An [Expect] with the new type [TSub]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.AnyAssertionSamples.isA */ @@ -200,7 +191,6 @@ infix fun Expect.and(assertionCreator: Expect.() -> Unit): Expect = * Expects that the subject of the assertion is not (equal to) [expected] and [otherValues]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 * @@ -216,7 +206,6 @@ fun Expect.isNoneOf(expected: T, vararg otherValues: T): Expect = * are passed. This function expects [IterableLike] (which is a typealias for [Any]) to avoid cluttering the API. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case the iterable is empty. * * @since 0.13.0 diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/arrayAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/arrayAssertions.kt index 478a474d05..c1c855dddf 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/arrayAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/arrayAssertions.kt @@ -283,7 +283,7 @@ fun Expect.asList(): Expect> = * @return The newly created [Expect] for the transformed subject. * * @since 0.9.0 - + * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.ArrayAssertionSamples.doubleArrAsList */ @JvmName("doubleArrAsList") diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceAssertions.kt index 673c117365..74808052f4 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceAssertions.kt @@ -58,7 +58,6 @@ val Expect.containsNot: NotCheckerStep Expect.contains( * so that you can mix [String] and [Int] for instance. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CharSequenceAssertionsSpec.containsNot */ @@ -110,7 +108,6 @@ fun Expect.containsNot( * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CharSequenceAssertionsSpec.containsRegexString */ @@ -138,7 +135,6 @@ fun Expect.containsRegex(pattern: String, vararg otherPatt * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 * @@ -151,7 +147,6 @@ fun Expect.containsRegex(pattern: Regex, vararg otherPatte * Expects that the subject of the assertion (a [CharSequence]) starts with [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CharSequenceAssertionsSpec.startsWith */ @@ -162,7 +157,6 @@ fun Expect.startsWith(expected: CharSequence): Expect = * Expects that the subject of the assertion (a [CharSequence]) starts with [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CharSequenceAssertionsSpec.startsWithChar * @@ -175,7 +169,6 @@ fun Expect.startsWith(expected: Char): Expect = * Expects that the subject of the assertion (a [CharSequence]) does not start with [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CharSequenceAssertionsSpec.startsNotWith */ @@ -186,7 +179,6 @@ fun Expect.startsNotWith(expected: CharSequence): Expect Expect.startsNotWith(expected: Char): Expect = * Expects that the subject of the assertion (a [CharSequence]) ends with [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CharSequenceAssertionsSpec.endsWith */ @@ -211,7 +202,6 @@ fun Expect.endsWith(expected: CharSequence): Expect = * Expects that the subject of the assertion (a [CharSequence]) ends with [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 * @@ -224,7 +214,6 @@ fun Expect.endsWith(expected: Char): Expect = * Expects that the subject of the assertion (a [CharSequence]) does not end with [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CharSequenceAssertionsSpec.endsNotWith */ @@ -235,7 +224,6 @@ fun Expect.endsNotWith(expected: CharSequence): Expect * Expects that the subject of the assertion (a [CharSequence]) does not end with [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CharSequenceAssertionsSpec.endsNotWithChar @@ -248,7 +236,6 @@ fun Expect.endsNotWith(expected: Char): Expect = * Expects that the subject of the assertion (a [CharSequence]) [CharSequence].[kotlin.text.isEmpty]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CharSequenceAssertionsSpec.isEmpty */ @@ -259,7 +246,6 @@ fun Expect.isEmpty(): Expect = * Expects that the subject of the assertion (a [CharSequence]) [CharSequence].[kotlin.text.isNotEmpty]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CharSequenceAssertionsSpec.isNotEmpty */ @@ -270,7 +256,6 @@ fun Expect.isNotEmpty(): Expect = * Expects that the subject of the assertion (a [CharSequence]) [CharSequence].[kotlin.text.isNotBlank]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CharSequenceAssertionsSpec.isNotBlank */ @@ -283,7 +268,6 @@ fun Expect.isNotBlank(): Expect = * In contrast to [containsRegex] it does not look for a partial match but for an entire match. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 * @@ -298,7 +282,6 @@ fun Expect.matches(expected: Regex): Expect = * In contrast to `containsNot.regex` it does not look for a partial match but for an entire match. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 * diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceContainsCreators.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceContainsCreators.kt index e8a34b76d0..7df74c2f74 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceContainsCreators.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceContainsCreators.kt @@ -37,7 +37,6 @@ import kotlin.jvm.JvmName * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ fun CheckerStep.value(expected: CharSequenceOrNumberOrChar): Expect = @@ -66,7 +65,6 @@ fun CheckerStep.value(expected: CharS * @param otherExpected Additional values which are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] or one of the [otherExpected] is not a * [CharSequence], [Number] or [Char]. */ @@ -91,7 +89,6 @@ fun CheckerStep.values( * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ @JvmName("valueIgnoringCase") @@ -122,7 +119,6 @@ fun CheckerStep.value( * @param otherExpected Additional values which are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] or one of the [otherExpected] is not a * [CharSequence], [Number] or [Char]. */ @@ -148,7 +144,6 @@ fun CheckerStep.values( * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ fun EntryPointStep.value(expected: CharSequenceOrNumberOrChar): Expect = @@ -174,7 +169,6 @@ fun EntryPointStep.value(expe * @param otherExpected Additional values which are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] or one of the [otherExpected] is not a * [CharSequence], [Number] or [Char]. */ @@ -202,7 +196,6 @@ fun EntryPointStep.values( * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun CheckerStep.regex( pattern: String, @@ -228,7 +221,6 @@ fun CheckerStep.regex( * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -257,7 +249,6 @@ fun CheckerStep.regex( * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @JvmName("regexIgnoringCase") fun CheckerStep.regex( @@ -287,7 +278,6 @@ fun CheckerStep.regex( * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun EntryPointStep.regex( pattern: String, @@ -309,7 +299,6 @@ fun EntryPointStep.regex( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * @@ -337,7 +326,6 @@ fun CheckerStep.elementsOf( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * @@ -365,7 +353,6 @@ fun CheckerStep.elementsOf( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceContainsCreatorsDeprecated.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceContainsCreatorsDeprecated.kt index 64a3c83e6a..a425c0619c 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceContainsCreatorsDeprecated.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/charSequenceContainsCreatorsDeprecated.kt @@ -34,7 +34,6 @@ import kotlin.jvm.JvmName * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ fun CheckerOption.value(expected: CharSequenceOrNumberOrChar): Expect = @@ -63,7 +62,6 @@ fun CheckerOption.value(expected: Cha * @param otherExpected Additional values which are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] or one of the [otherExpected] is not a * [CharSequence], [Number] or [Char]. */ @@ -88,7 +86,6 @@ fun CheckerOption.values( * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ @JvmName("valueIgnoringCase") @@ -119,7 +116,6 @@ fun CheckerOption.value( * @param otherExpected Additional values which are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] or one of the [otherExpected] is not a * [CharSequence], [Number] or [Char]. */ @@ -145,7 +141,6 @@ fun CheckerOption.values( * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ fun Builder.value(expected: CharSequenceOrNumberOrChar): Expect = @@ -171,7 +166,6 @@ fun Builder.value(expected: C * @param otherExpected Additional values which are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] or one of the [otherExpected] is not a * [CharSequence], [Number] or [Char]. */ @@ -199,7 +193,6 @@ fun Builder.values( * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun CheckerOption.regex( pattern: String, @@ -225,7 +218,6 @@ fun CheckerOption.regex( * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -254,7 +246,6 @@ fun CheckerOption.regex( * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @JvmName("regexIgnoringCase") fun CheckerOption.regex( @@ -284,7 +275,6 @@ fun CheckerOption.regex( * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun Builder.regex( pattern: String, @@ -307,7 +297,6 @@ fun Builder.regex( * @param expectedIterable The [Iterable] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterable] is not a [CharSequence], [Number] or [Char] or the given * [expectedIterable] does not have elements (is empty). * @@ -337,7 +326,6 @@ fun CheckerOption.elementsOf( * @param expectedIterable The [Iterable] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterable] is not a [CharSequence], [Number] or [Char] or the given * [expectedIterable] does not have elements (is empty). * @@ -368,7 +356,6 @@ fun CheckerOption.elementsOf( * @param expectedIterable The [Iterable] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterable] is not a [CharSequence], [Number] or [Char] or the given * [expectedIterable] does not have elements (is empty). * @@ -398,7 +385,6 @@ fun Builder.elementsOf( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * @@ -426,7 +412,6 @@ fun CheckerOption.elementsOf( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * @@ -455,7 +440,6 @@ fun CheckerOption.elementsOf( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/collectionAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/collectionAssertions.kt index 3c4af1aa2e..7937a1a3f9 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/collectionAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/collectionAssertions.kt @@ -12,7 +12,6 @@ import ch.tutteli.kbox.identity * Expects that the subject of the assertion (a [Collection]) is an empty [Collection]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CollectionAssertionSamples.isEmpty */ @@ -23,7 +22,6 @@ fun > Expect.isEmpty(): Expect = * Expects that the subject of the assertion (a [Collection]) is not an empty [Collection]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CollectionAssertionSamples.isNotEmpty */ @@ -36,7 +34,6 @@ fun > Expect.isNotEmpty(): Expect = * Shortcut for `size.toBe(expected)`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CollectionAssertionSamples.hasSize */ @@ -60,7 +57,6 @@ val > Expect.size: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.CollectionAssertionSamples.size */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/comparableAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/comparableAssertions.kt index 182a67d307..b07c98d643 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/comparableAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/comparableAssertions.kt @@ -8,7 +8,6 @@ import ch.tutteli.atrium.logic.* * The comparison is carried out with [Comparable.compareTo]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.ComparableAssertionSamples.isLessThan */ @@ -20,7 +19,6 @@ fun > Expect.isLessThan(expected: T): Expect = * The comparison is carried out with [Comparable.compareTo]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.ComparableAssertionSamples.isLessThanOrEqual */ @@ -32,7 +30,6 @@ fun > Expect.isLessThanOrEqual(expected: T): Expect = * The comparison is carried out with [Comparable.compareTo]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.ComparableAssertionSamples.isGreaterThan */ @@ -44,7 +41,6 @@ fun > Expect.isGreaterThan(expected: T): Expect = * The comparison is carried out with [Comparable.compareTo]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.ComparableAssertionSamples.isGreaterThanOrEqual */ @@ -56,7 +52,6 @@ fun > Expect.isGreaterThanOrEqual(expected: T): Expect = * where the comparison is carried out with [Comparable.compareTo]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 * diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/featureAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/featureAssertions.kt index f320174453..c603dea60a 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/featureAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/featureAssertions.kt @@ -27,7 +27,6 @@ fun Expect.feature(property: KProperty1): FeatureExpect * returns the initial [Expect] with the current subject. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] in case the created [AssertionGroup] does not hold. * * @since 0.9.0 */ @@ -57,7 +56,6 @@ fun Expect.feature(f: KFunction1): FeatureExpect = * returns the initial [Expect] with the current subject. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] in case the created [AssertionGroup] does not hold. * * @since 0.9.0 */ @@ -91,7 +89,6 @@ fun Expect.feature( * returns the initial [Expect] with the current subject. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] in case the created [AssertionGroup] does not hold. * * @since 0.9.0 */ @@ -126,7 +123,6 @@ fun Expect.feature( * returns the initial [Expect] with the current subject. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] in case the created [AssertionGroup] does not hold. * * @since 0.9.0 */ @@ -161,7 +157,6 @@ fun Expect.feature( * returns the initial [Expect] with the current subject. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] in case the created [AssertionGroup] does not hold. * * @since 0.9.0 */ @@ -196,7 +191,6 @@ fun Expect.feature( * returns the initial [Expect] with the current subject. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] in case the created [AssertionGroup] does not hold. * * @since 0.9.0 */ @@ -230,7 +224,6 @@ fun Expect.feature( * returns the initial [Expect] with the current subject. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] in case the created [AssertionGroup] does not hold. * * @since 0.9.0 */ @@ -268,7 +261,6 @@ fun Expect.feature(description: String, provider: T.() -> R): FeatureE * implicit parameter `it`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] in case the created [AssertionGroup] does not hold. * * @since 0.9.0 */ @@ -307,7 +299,6 @@ fun Expect.feature(provider: MetaFeatureOption.(T) -> MetaFeature.toBeWithErrorTolerance(expected: Float, tolerance: Float): Exp * | `subject of the assertion` - [expected] | ≤ [tolerance] * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.FloatingPointAssertionSamples.toBeWithErrorToleranceDouble */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/fun0Assertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/fun0Assertions.kt index c4f30e89b1..3cf8c42185 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/fun0Assertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/fun0Assertions.kt @@ -13,7 +13,6 @@ import ch.tutteli.atrium.logic.toThrow * the element type is actually `String`. * * @return An [Expect] with the new type [TExpected]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ inline fun Expect Any?>.toThrow(): Expect = _logic.toThrow(TExpected::class).transform() @@ -49,7 +48,6 @@ inline fun Expect Any?>.toThrow(): Exp * the element type is actually `String`. * * @return An [Expect] with the new type [TExpected]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ inline fun Expect Any?>.toThrow( noinline assertionCreator: Expect.() -> Unit @@ -61,7 +59,6 @@ inline fun Expect Any?>.toThrow( * and changes the subject of the assertion to the return value of type [R]. * * @return An [Expect] with the new type [R]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun R> Expect.notToThrow(): Expect = _logic.notToThrow().transform() @@ -71,7 +68,6 @@ fun R> Expect.notToThrow(): Expect = * and that the corresponding return value holds all assertions the given [assertionCreator] creates. * * @return An [Expect] with the new type [R]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun R> Expect.notToThrow( assertionCreator: Expect.() -> Unit diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableAssertions.kt index 1cd972d666..30ed8a1b4b 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableAssertions.kt @@ -48,7 +48,6 @@ val > Expect.containsNot: NotCheckerStep> Expect.contains(expected: E, vararg otherExpected: E): Expect = contains.inAnyOrder.atLeast(1).values(expected, *otherExpected) @@ -65,7 +64,6 @@ fun > Expect.contains(expected: E, vararg otherExpected: E * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.contains(assertionCreatorOrNull: (Expect.() -> Unit)?): Expect = contains.inAnyOrder.atLeast(1).entry(assertionCreatorOrNull) @@ -85,7 +83,6 @@ fun > Expect.contains(assertionCreatorOrNull: (Expe * which we are looking for (see [assertionCreatorOrNull] for more information). * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.contains( assertionCreatorOrNull: (Expect.() -> Unit)?, @@ -103,7 +100,6 @@ fun > Expect.contains( * [#292](https://github.com/robstoll/atrium/issues/292) for more information) * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.containsExactly(expected: E, vararg otherExpected: E): Expect = contains.inOrder.only.values(expected, *otherExpected) @@ -124,7 +120,6 @@ fun > Expect.containsExactly(expected: E, vararg otherExpe * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.containsExactly(assertionCreatorOrNull: (Expect.() -> Unit)?): Expect = contains.inOrder.only.entry(assertionCreatorOrNull) @@ -148,7 +143,6 @@ fun > Expect.containsExactly(assertionCreatorOrNull * which we are looking for (see [assertionCreatorOrNull] for more information). * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.containsExactly( assertionCreatorOrNull: (Expect.() -> Unit)?, @@ -167,7 +161,6 @@ fun > Expect.containsExactly( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within this [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * @@ -187,7 +180,6 @@ inline fun > Expect.containsExactlyElementsOf( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within this [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * @@ -204,7 +196,6 @@ inline fun > Expect.containsElementsOf( * It is a shortcut for `containsNot.values(expected, *otherExpected)` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.containsNot(expected: E, vararg otherExpected: E): Expect = containsNot.values(expected, *otherExpected) @@ -227,7 +218,6 @@ fun , T : Iterable> Expect.min(): Expect = * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -251,7 +241,6 @@ fun , T : Iterable> Expect.max(): Expect = * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -267,7 +256,6 @@ fun , T : Iterable> Expect.max(assertionCreator: Expect< * It is a shortcut for `contains.inAnyOrder.atLeast(1).entry(assertionCreatorOrNull)` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.any(assertionCreatorOrNull: (Expect.() -> Unit)?): Expect = contains.inAnyOrder.atLeast(1).entry(assertionCreatorOrNull) @@ -280,7 +268,6 @@ fun > Expect.any(assertionCreatorOrNull: (Expect * It is a shortcut for `containsNot.entry(assertionCreatorOrNull)` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.none(assertionCreatorOrNull: (Expect.() -> Unit)?): Expect = containsNot.entry(assertionCreatorOrNull) @@ -291,7 +278,6 @@ fun > Expect.none(assertionCreatorOrNull: (Expect> Expect.all(assertionCreatorOrNull: (Expect.() -> Unit)?): Expect = _logicAppend { all(::identity, assertionCreatorOrNull) } @@ -301,7 +287,6 @@ fun > Expect.all(assertionCreatorOrNull: (Expect * Expects that the subject of the assertion (an [Iterable]) has at least one element. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -312,7 +297,6 @@ fun > Expect.hasNext(): Expect = * Expects that the subject of the assertion (an [Iterable]) does not have next element. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -323,7 +307,6 @@ fun > Expect.hasNotNext(): Expect = * Expects that the subject of the assertion (an [Iterable]) does not have duplicate elements. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableContainsInAnyOrderCreators.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableContainsInAnyOrderCreators.kt index 4bc3e1335f..96be0d9b04 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableContainsInAnyOrderCreators.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableContainsInAnyOrderCreators.kt @@ -21,7 +21,6 @@ import ch.tutteli.kbox.glue * @param expected The value which is expected to be contained within this [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > CheckerOption.value(expected: E): Expect = values(expected) @@ -44,7 +43,6 @@ fun > CheckerOption.value(ex * @param otherExpected Additional objects which are expected to be contained within this [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > CheckerOption.values( expected: E, @@ -63,7 +61,6 @@ fun > CheckerOption.values( * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > CheckerOption.entry( assertionCreatorOrNull: (Expect.() -> Unit)? @@ -82,7 +79,6 @@ fun > CheckerOption. * which we are looking for (see [assertionCreatorOrNull] for more information). * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > CheckerOption.entries( assertionCreatorOrNull: (Expect.() -> Unit)?, @@ -104,7 +100,6 @@ fun > CheckerOption. * @param expectedIterable The [Iterable] whose elements are expected to be contained within this [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case the given [expectedIterable] does not have elements (is empty). * * @since 0.9.0 @@ -130,7 +125,6 @@ inline fun > CheckerOption> Builder.value(expected: E): Expect = values(expected) @@ -44,7 +43,6 @@ fun > Builder.value(expe * @param otherExpected Additional values which are expected to be contained within [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Builder.values( expected: E, @@ -67,7 +65,6 @@ fun > Builder.values( * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Builder.entry( assertionCreatorOrNull: (Expect.() -> Unit)? @@ -99,7 +96,6 @@ fun > Builder.en * which we are looking for (see [assertionCreatorOrNull] for more information). * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Builder.entries( assertionCreatorOrNull: (Expect.() -> Unit)?, @@ -125,7 +121,6 @@ fun > Builder.en * @param expectedIterable The [Iterable] whose elements are expected to be contained within this [Iterable] * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case the given [expectedIterable] does not have elements (is empty). * * @since 0.9.0 @@ -155,7 +150,6 @@ inline fun > Builder> Builder.value(expected: E): Expect = values(expected) @@ -43,7 +42,6 @@ fun > Builder.value(expecte * @param otherExpected Additional values which are expected to be contained within [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Builder.values( expected: E, @@ -66,7 +64,6 @@ fun > Builder.values( * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Builder.entry( assertionCreatorOrNull: (Expect.() -> Unit)? @@ -89,7 +86,6 @@ fun > Builder.entry * which we are looking for (see [assertionCreatorOrNull] for more information). * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Builder.entries( assertionCreatorOrNull: (Expect.() -> Unit)?, @@ -115,7 +111,6 @@ fun > Builder.entri * @param expectedIterable The [Iterable] whose elements are expected to be contained within this [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case the given [expectedIterable] does not have elements (is empty). * * @since 0.9.0 @@ -145,7 +140,6 @@ inline fun > Builder> Builder.inAnyOrder( firstGroup: Group, @@ -52,7 +51,6 @@ fun > Builder. * [Iterable] whereas the groups have to appear in the given order. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @JvmName("inAnyOrderEntries") fun > Builder.inAnyOrder( diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableLikeContainsInAnyOrderCreators.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableLikeContainsInAnyOrderCreators.kt index 30794cccf6..1974777fe2 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableLikeContainsInAnyOrderCreators.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableLikeContainsInAnyOrderCreators.kt @@ -21,7 +21,6 @@ import ch.tutteli.kbox.glue * @param expected The value which is expected to be contained within this [IterableLike]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -47,7 +46,6 @@ fun CheckerStep.value(expe * @param otherExpected Additional objects which are expected to be contained within this [IterableLike]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -68,7 +66,6 @@ fun CheckerStep.values( * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -90,7 +87,6 @@ fun CheckerStep * which we are looking for (see [assertionCreatorOrNull] for more information). * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -114,7 +110,6 @@ fun CheckerStep * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within this [IterableLike]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not * an [Iterable], [Sequence] or one of the [Array] types * or the given [expectedIterableLike] does not have elements (is empty). diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableLikeContainsInAnyOrderOnlyCreators.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableLikeContainsInAnyOrderOnlyCreators.kt index c3f24803b1..780b9eb333 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableLikeContainsInAnyOrderOnlyCreators.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/iterableLikeContainsInAnyOrderOnlyCreators.kt @@ -27,7 +27,6 @@ import ch.tutteli.kbox.glue * @param expected The value which is expected to be contained within the subject (an [IterableLike]). * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -47,7 +46,6 @@ fun EntryPointStep.val * @param otherExpected Additional values which are expected to be contained within [IterableLike]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -72,7 +70,6 @@ fun EntryPointStep.val * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -106,7 +103,6 @@ fun EntryPointStep EntryPointStep EntryPointStep.value * @param otherExpected Additional values which are expected to be contained within [IterableLike]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -70,7 +68,6 @@ fun EntryPointStep.value * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -96,7 +93,6 @@ fun EntryPointStep EntryPointStep EntryPointStep> Expect.hasNext(): Expect = * Expects that the subject of the assertion (an [Iterator]) does not have a next element. * * @return an [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 * diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/listAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/listAssertions.kt index 94079be77f..e61fa23c35 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/listAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/listAssertions.kt @@ -9,7 +9,6 @@ import ch.tutteli.atrium.logic.get * returns an [Expect] for the element at that position. * * @return The newly created [Expect] for the element at position [index]. - * @throws AssertionError Might throw an [AssertionError] if the given [index] is out of bound. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.ListAssertionSamples.getFeature */ @@ -21,7 +20,6 @@ fun > Expect.get(index: Int): Expect = * the element at that position holds all assertions the given [assertionCreator] creates for it. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the given [index] is out of bound. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.ListAssertionSamples.get */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapAssertions.kt index 7b65c4ab43..dfe880bc65 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapAssertions.kt @@ -29,7 +29,6 @@ val > Expect.contains: MapLikeContains.EntryPointStep * even though they match the same entry. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.contains( keyValuePair: Pair, @@ -44,7 +43,6 @@ fun > Expect.contains( * Delegates to `contains.inAnyOrder.only.entries(keyValuePair, *otherPairs)` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.containsOnly( keyValuePair: Pair, @@ -65,7 +63,6 @@ fun > Expect.containsOnly( * , then both match, even though they match the same entry. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ inline fun > Expect.contains( keyValue: KeyValue, @@ -82,7 +79,6 @@ inline fun > Expect.contains( * Delegates to `contains.inAnyOrder.only.entries(keyValue, *otherKeyValues)` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ inline fun > Expect.containsOnly( keyValue: KeyValue, @@ -95,7 +91,6 @@ inline fun > Expect.containsOnly( * Delegates to ` contains.inAnyOrder.entriesOf` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.containsEntriesOf( mapLike: MapLike @@ -108,7 +103,6 @@ fun > Expect.containsEntriesOf( * Delegates to `contains.inAnyOrder.only.entriesOf` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.containsOnlyEntriesOf( mapLike: MapLike @@ -118,7 +112,6 @@ fun > Expect.containsOnlyEntriesOf( * Expects that the subject of the assertion (a [Map]) contains the given [key]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.containsKey(key: K): Expect = _logicAppend { containsKey(::identity, key) } @@ -127,7 +120,6 @@ fun > Expect.containsKey(key: K): Expect = * Expects that the subject of the assertion (a [Map]) does not contain the given [key]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.containsNotKey(key: K): Expect = _logicAppend { containsNotKey(::identity, key) } @@ -138,7 +130,6 @@ fun > Expect.containsNotKey(key: K): Expect = * so that further fluent calls are assertions about it. * * @return The newly created [Expect] for the extracted feature. - * @throws AssertionError Might throw an [AssertionError] if the given [key] does not exist. */ fun > Expect.getExisting(key: K): Expect = _logic.getExisting(::identity, key).transform() @@ -148,8 +139,6 @@ fun > Expect.getExisting(key: K): Expect = * the corresponding value holds all assertions the given [assertionCreator] creates for it. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. */ fun > Expect.getExisting(key: K, assertionCreator: Expect.() -> Unit): Expect = _logic.getExisting(::identity, key).collectAndAppend(assertionCreator) @@ -169,7 +158,6 @@ val > Expect.keys: Expect> * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.keys(assertionCreator: Expect>.() -> Unit): Expect = _logic.property(Map::keys).collectAndAppend(assertionCreator) @@ -189,7 +177,6 @@ val > Expect.values: Expect> * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.values(assertionCreator: Expect>.() -> Unit): Expect = _logic.property(Map::values).collectAndAppend(assertionCreator) @@ -224,7 +211,6 @@ fun > Expect.asEntries( * Expects that the subject of the assertion (a [Map]) is an empty [Map]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.isEmpty(): Expect = _logicAppend { isEmpty(::toEntries) } @@ -234,7 +220,6 @@ fun > Expect.isEmpty(): Expect = * Expects that the subject of the assertion (a [Map]) is not an empty [Map]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.isNotEmpty(): Expect = _logicAppend { isNotEmpty(::toEntries) } diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapCollectionLikeAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapCollectionLikeAssertions.kt index c9372d70a9..a3c3c67208 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapCollectionLikeAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapCollectionLikeAssertions.kt @@ -22,7 +22,6 @@ val > Expect.size: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapEntryAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapEntryAssertions.kt index f5628be280..45048d73a1 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapEntryAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapEntryAssertions.kt @@ -12,7 +12,6 @@ import ch.tutteli.atrium.logic.* * reporting etc. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.isKeyValue(key: K, value: V): Expect = _logicAppend { isKeyValue(key, value) } @@ -32,7 +31,6 @@ val > Expect.key: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.key(assertionCreator: Expect.() -> Unit): Expect = _logic.key().collectAndAppend(assertionCreator) @@ -52,7 +50,6 @@ val > Expect.value: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun > Expect.value(assertionCreator: Expect.() -> Unit): Expect = _logic.value().collectAndAppend(assertionCreator) diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapLikeContainsInAnyOrderCreators.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapLikeContainsInAnyOrderCreators.kt index 812f98ae9b..493cfca2f5 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapLikeContainsInAnyOrderCreators.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/mapLikeContainsInAnyOrderCreators.kt @@ -18,7 +18,6 @@ import ch.tutteli.kbox.glue * Delegates to [entries]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ @@ -35,7 +34,6 @@ fun EntryPointStep.entry * even though they match the same entry. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ @@ -54,7 +52,6 @@ fun EntryPointStep.entri * Delegates to [entries]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ @@ -75,7 +72,6 @@ inline fun EntryPointStep EntryPointStep EntryPointStep.e * in which order they appear. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ @@ -51,7 +49,6 @@ fun EntryPointStep.e * Delegates to [entries]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ @@ -68,7 +65,6 @@ inline fun EntryPointStep EntryPointStep EntryPointStep.entr * needs to contain only the given [keyValuePair] as well as the [otherPairs] in the specified order. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ @@ -54,7 +52,6 @@ fun EntryPointStep.entr * Delegates to [entries]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ @@ -72,7 +69,6 @@ inline fun EntryPointStep EntryPointStep> Expect.first: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.PairAssertionSamples.first */ @@ -46,7 +45,6 @@ val > Expect.second: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.PairAssertionSamples.second */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/throwableAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/throwableAssertions.kt index 6a4d385e41..77d75d067e 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/throwableAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/throwableAssertions.kt @@ -10,7 +10,6 @@ import ch.tutteli.atrium.logic.causeIsA * creates an [Expect] for it and returns it. * * @return The newly created [Expect] for the property [Throwable.message] of the subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ val Expect.message: Expect get() = feature(Throwable::message).notToBeNull() @@ -21,7 +20,6 @@ val Expect.message: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun Expect.message(assertionCreator: Expect.() -> Unit): Expect = feature(Throwable::message) { notToBeNull(assertionCreator) } @@ -39,7 +37,6 @@ fun Expect.message(assertionCreator: Expect.() -> Uni * so that you can mix [String] and [Int] for instance. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun Expect.messageContains( expected: CharSequenceOrNumberOrChar, @@ -52,7 +49,6 @@ fun Expect.messageContains( * creates an [Expect] of the [TExpected] type for it and returns it. * * @return The newly created [Expect] for the property [Throwable.cause] of the subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.10.0 */ @@ -68,7 +64,6 @@ inline fun Expect.cause(): Expect * [Expect] of the initial type, which was some type `T `, but an [Expect] of the specified type [TExpected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.10.0 */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/bigDecimalAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/bigDecimalAssertions.kt index f61ff3dec9..009d382579 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/bigDecimalAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/bigDecimalAssertions.kt @@ -49,7 +49,6 @@ fun Expect.toBe(expected: T): Nothing = throw PleaseUseRepl * Expects that the subject of the assertion (a [BigDecimal]) is `null`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.fluent.en_GB.samples.BigDecimalAssertionSamples.toBe */ @@ -92,7 +91,6 @@ fun Expect.notToBe(expected: T): Nothing = throw PleaseUseRe * - `expect(BigDecimal("10")).isNumericallyEqualTo(BigDecimal("10.0"))` holds. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun Expect.isNumericallyEqualTo(expected: T): Expect = _logicAppend { isNumericallyEqualTo(expected) } @@ -110,7 +108,6 @@ fun Expect.isNumericallyEqualTo(expected: T): Expect = * - `expect(BigDecimal("10")).isNotNumericallyEqualTo(BigDecimal("10.0"))` does not hold. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun Expect.isNotNumericallyEqualTo(expected: T): Expect = _logicAppend { isNotNumericallyEqualTo(expected) } @@ -125,7 +122,6 @@ fun Expect.isNotNumericallyEqualTo(expected: T): Expect = * - `expect(BigDecimal("10")).isNumericallyEqualTo(BigDecimal("10.0"))` holds. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun Expect.isEqualIncludingScale(expected: T): Expect = _logicAppend { isEqualIncludingScale(expected, this::isNumericallyEqualTo.name) } @@ -140,7 +136,6 @@ fun Expect.isEqualIncludingScale(expected: T): Expect = * - `expect(BigDecimal("10")).isNotNumericallyEqualTo(BigDecimal("10.0"))` does not hold. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun Expect.isNotEqualIncludingScale(expected: T): Expect = _logicAppend { isNotEqualIncludingScale(expected) } diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoLocalDateAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoLocalDateAssertions.kt index b9b5d423be..dc77863bc6 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoLocalDateAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoLocalDateAssertions.kt @@ -14,7 +14,6 @@ import java.time.chrono.ChronoLocalDate * is before the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -26,7 +25,6 @@ fun Expect.isBefore(expected: ChronoLocalDate): Expect< * is before or equal the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -38,7 +36,6 @@ fun Expect.isBeforeOrEqual(expected: ChronoLocalDate): * is after the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -50,7 +47,6 @@ fun Expect.isAfter(expected: ChronoLocalDate): Expect Expect.isAfterOrEqual(expected: ChronoLocalDate): E * is equal to the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -75,7 +70,6 @@ fun Expect.isEqual(expected: ChronoLocalDate): Expect Expect.isBefore(expected: String): Expect = * The [expected] parameter needs to be in the form of **yyyy-mm-dd** or else a [java.time.DateTimeException] will be thrown. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -101,7 +94,6 @@ fun Expect.isBeforeOrEqual(expected: String): Expect * The [expected] parameter needs to be in the form of **yyyy-mm-dd** or else a [java.time.DateTimeException] will be thrown. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -114,7 +106,6 @@ fun Expect.isAfter(expected: String): Expect = * The [expected] parameter needs to be in the form of **yyyy-mm-dd** or else a [java.time.DateTimeException] will be thrown. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -127,7 +118,6 @@ fun Expect.isAfterOrEqual(expected: String): Expect * The [expected] parameter needs to be in the form of **yyyy-mm-dd** or else a [java.time.DateTimeException] will be thrown. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoLocalDateTimeAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoLocalDateTimeAssertions.kt index 3441bccce9..4626a7375e 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoLocalDateTimeAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoLocalDateTimeAssertions.kt @@ -16,7 +16,6 @@ import java.time.chrono.ChronoLocalDateTime * is before the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -29,7 +28,6 @@ fun > Expect.isBefore( * is before or equal the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -42,7 +40,6 @@ fun > Expect.isBeforeOrEqual( * is after the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -55,7 +52,6 @@ fun > Expect.isAfter( * is after or equal the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -68,7 +64,6 @@ fun > Expect.isAfterOrEqual( * is equal to the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -88,7 +83,6 @@ fun > Expect.isEqual( * yyyy-mm-dd * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ @@ -108,7 +102,6 @@ fun > Expect.isBefore( * yyyy-mm-dd * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ @@ -128,7 +121,6 @@ fun > Expect.isBeforeOrEqual( * yyyy-mm-dd * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ @@ -148,7 +140,6 @@ fun > Expect.isAfter( * yyyy-mm-dd * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ @@ -168,7 +159,6 @@ fun > Expect.isAfterOrEqual( * yyyy-mm-dd * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoZonedDateTimeAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoZonedDateTimeAssertions.kt index 49fe75d240..4c0d07cb07 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoZonedDateTimeAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/chronoZonedDateTimeAssertions.kt @@ -15,7 +15,6 @@ import java.time.chrono.ChronoZonedDateTime * is before the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -28,7 +27,6 @@ fun > Expect.isBefore( * is before or equals the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -41,7 +39,6 @@ fun > Expect.isBeforeOrEqual( * is after the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -54,7 +51,6 @@ fun > Expect.isAfter( * is after or equal the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -67,7 +63,6 @@ fun > Expect.isAfterOrEqual( * is equal to the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -101,7 +96,6 @@ fun > Expect.isEqual( * - 2020-01-02+01:30 * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -135,7 +129,6 @@ fun > Expect.isBefore( * - 2020-01-02+01:30 * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -169,7 +162,6 @@ fun > Expect.isBeforeOrEqual( * - 2020-01-02+01:30 * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -203,7 +195,6 @@ fun > Expect.isAfter( * - 2020-01-02+01:30 * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -237,7 +228,6 @@ fun > Expect.isAfterOrEqual( * - 2020-01-02+01:30 * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/floatingPointJvmAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/floatingPointJvmAssertions.kt index 2106b1ac0b..15118f7a54 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/floatingPointJvmAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/floatingPointJvmAssertions.kt @@ -22,7 +22,6 @@ import java.math.BigDecimal * | `subject of the assertion` - [expected] | ≤ [tolerance] * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun Expect.toBeWithErrorTolerance(expected: BigDecimal, tolerance: BigDecimal): Expect = _logicAppend { toBeWithErrorTolerance(expected, tolerance) } diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/localDateAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/localDateAssertions.kt index b014a0bd84..8eaec49983 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/localDateAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/localDateAssertions.kt @@ -26,7 +26,6 @@ val Expect.year: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -50,7 +49,6 @@ val Expect.month: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -74,7 +72,6 @@ val Expect.dayOfWeek: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -99,7 +96,6 @@ val Expect.day: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/localDateTimeAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/localDateTimeAssertions.kt index f2ff70b390..a8aa851e22 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/localDateTimeAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/localDateTimeAssertions.kt @@ -27,7 +27,6 @@ val Expect.year: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -51,7 +50,6 @@ val Expect.month: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -75,7 +73,6 @@ val Expect.dayOfWeek: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -99,7 +96,6 @@ val Expect.day: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/optionalAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/optionalAssertions.kt index 1f8bdb5a4c..a9cd334f61 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/optionalAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/optionalAssertions.kt @@ -19,7 +19,6 @@ import java.util.* * depends on the underlying implementation though. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -34,7 +33,6 @@ fun > Expect.isEmpty(): Expect = * depends on the underlying implementation though. * * @return The newly created [Expect] for the inner type [E]. - * @throws AssertionError Might throw an [AssertionError] if the given assertion is not a success. * * @since 0.9.0 */ @@ -46,7 +44,6 @@ fun > Expect.isPresent(): Expect = * that it holds all assertions the given [assertionCreator] creates. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the given assertions are not success. * * @since 0.9.0 */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/pathAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/pathAssertions.kt index d9cf321fe2..ebbb1ed15c 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/pathAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/pathAssertions.kt @@ -15,7 +15,6 @@ import java.nio.file.Path * Expects that the subject of the assertion (a [Path]) starts with the [expected] [Path]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -26,7 +25,6 @@ fun Expect.startsWith(expected: Path): Expect = * Expects that the subject of the assertion (a [Path]) does not start with the [expected] [Path]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -37,7 +35,6 @@ fun Expect.startsNotWith(expected: Path): Expect = * Expects that the subject of the assertion (a [Path]) ends with the expected [Path]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -49,7 +46,6 @@ fun Expect.endsWith(expected: Path): Expect = * * @param expected The [Path] provided to the assertion * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -64,7 +60,6 @@ fun Expect.endsNotWith(expected: Path): Expect = * then the search will continue at that location. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -79,7 +74,6 @@ fun Expect.exists(): Expect = * then the search will continue at that location. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -105,7 +99,6 @@ val Expect.fileName: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -118,7 +111,6 @@ fun Expect.fileName(assertionCreator: Expect.() -> Unit): * so that further fluent calls are assertions about it. * * @return The newly created [Expect] for the extracted feature. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -132,7 +124,6 @@ val Expect.fileNameWithoutExtension: Expect * and returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -144,7 +135,6 @@ fun Expect.fileNameWithoutExtension(assertionCreator: Expect Expect.parent: Expect * given [assertionCreator] creates for it and returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -168,7 +157,6 @@ fun Expect.parent(assertionCreator: Expect.() -> Unit): Expe * so that further fluent calls are assertions about it. * * @return The newly created [Expect] for the extracted feature. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.10.0 */ @@ -180,7 +168,6 @@ fun Expect.resolve(other: String): Expect = * given [assertionCreator] creates for it and returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.10.0 */ @@ -201,7 +188,6 @@ fun Expect.resolve(other: String, assertionCreator: Expect.( * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -218,7 +204,6 @@ fun Expect.isReadable(): Expect = * at the location the link points at. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -240,7 +225,6 @@ fun Expect.isWritable(): Expect = * at the location the link points at. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -260,7 +244,6 @@ fun Expect.isExecutable(): Expect = * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -280,7 +263,6 @@ fun Expect.isRegularFile(): Expect = * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -292,7 +274,6 @@ fun Expect.isDirectory(): Expect = * meaning that the [Path] specified in this instance starts at the file system root. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -304,7 +285,6 @@ fun Expect.isAbsolute(): Expect = * meaning that the [Path] specified in this instance does not start at the file system root. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -326,7 +306,6 @@ fun Expect.isRelative(): Expect = * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -352,7 +331,6 @@ val Expect.extension: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -367,7 +345,6 @@ fun Expect.extension(assertionCreator: Expect.() -> Unit): * @param targetCharset target file encoding - UTF-8 per default. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -382,7 +359,6 @@ fun Expect.hasSameTextualContentAs( * as [targetPath]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ diff --git a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/zonedDateTimeAssertions.kt b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/zonedDateTimeAssertions.kt index 4598511434..34c58f39e5 100644 --- a/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/zonedDateTimeAssertions.kt +++ b/apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/zonedDateTimeAssertions.kt @@ -27,7 +27,6 @@ val Expect.year: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -51,7 +50,6 @@ val Expect.month: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -75,7 +73,6 @@ val Expect.dayOfWeek: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -99,7 +96,6 @@ val Expect.day: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ diff --git a/apis/fluent-en_GB/extensions/kotlin_1_3/atrium-api-fluent-en_GB-kotlin_1_3-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/kotlin_1_3/resultAssertions.kt b/apis/fluent-en_GB/extensions/kotlin_1_3/atrium-api-fluent-en_GB-kotlin_1_3-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/kotlin_1_3/resultAssertions.kt index ab7d74f4b0..bd6963531e 100644 --- a/apis/fluent-en_GB/extensions/kotlin_1_3/atrium-api-fluent-en_GB-kotlin_1_3-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/kotlin_1_3/resultAssertions.kt +++ b/apis/fluent-en_GB/extensions/kotlin_1_3/atrium-api-fluent-en_GB-kotlin_1_3-common/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/kotlin_1_3/resultAssertions.kt @@ -10,7 +10,6 @@ import ch.tutteli.atrium.logic.kotlin_1_3.isSuccess * and returns an [Expect] for the inner type [E]. * * @return The newly created [Expect] if the given assertion is success - * @throws AssertionError Might throw an [AssertionError] if the given assertion is not a success. * * @since 0.9.0 */ @@ -22,7 +21,6 @@ fun > Expect.isSuccess(): Expect = * that it holds all assertions the given [assertionCreator] creates. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the given assertions are not success. * * @since 0.9.0 */ @@ -34,7 +32,6 @@ fun > Expect.isSuccess(assertionCreator: Expect.() -> Uni * that it encapsulates an exception of type [TExpected]. * * @return An [Expect] with the new type [TExpected] - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -47,7 +44,6 @@ inline fun Expect>.isFailure(): Ex * holds all assertions the given [assertionCreator] creates. * * @return An [Expect] with the new type [TExpected] - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/anyAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/anyAssertions.kt index b908c4e4ee..c0f62d368a 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/anyAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/anyAssertions.kt @@ -12,7 +12,6 @@ import ch.tutteli.atrium.reporting.Reporter * Expects that the subject of the assertion is (equal to) [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @sample ch.tutteli.atrium.api.infix.en_GB.samples.AnyAssertionSamples.toBe */ @@ -22,7 +21,6 @@ infix fun Expect.toBe(expected: T): Expect = _logicAppend { toBe(expec * Expects that the subject of the assertion is not (equal to) [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.notToBe(expected: T): Expect = _logicAppend { notToBe(expected) } @@ -30,7 +28,6 @@ infix fun Expect.notToBe(expected: T): Expect = _logicAppend { notToBe * Expects that the subject of the assertion is the same instance as [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.isSameAs(expected: T): Expect = _logicAppend { isSameAs(expected) } @@ -38,7 +35,6 @@ infix fun Expect.isSameAs(expected: T): Expect = _logicAppend { isSame * Expects that the subject of the assertion is not the same instance as [expected]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.isNotSameAs(expected: T): Expect = _logicAppend { isNotSameAs(expected) } @@ -67,7 +63,6 @@ fun of(reason: String, assertionCreator: Expect.() -> Unit): KeyWithCreat * is `null` or is not `null` and holds all assertions [assertionCreatorOrNull] creates. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.toBeNullIfNullGivenElse( assertionCreatorOrNull: (Expect.() -> Unit)? @@ -80,7 +75,6 @@ infix fun Expect.toBeNullIfNullGivenElse( * @param o The filler object [o]. * * @return An [Expect] with the non-nullable type [T] (was `T?` before). - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -93,7 +87,6 @@ inline infix fun Expect.notToBeNull(@Suppress("UNUSED_PARA * that it holds all assertions the given [assertionCreator] creates. * * @return An [Expect] with the non-nullable type [T] (was `T?` before) - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Suppress(/* less magic */ "RemoveExplicitTypeArguments") inline infix fun Expect.notToBeNull(noinline assertionCreator: Expect.() -> Unit): Expect = @@ -116,7 +109,6 @@ inline infix fun Expect.notToBeNull(noinline assertionCrea * `assert(listOf(1, 2)).isA>{}` holds, even though `List` is clearly not a `List`. * * @return An [Expect] with the new type [TSub]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ //TODO make infix and add `o` as parameter as soon as https://youtrack.jetbrains.com/issue/KT-21593 is fixed inline fun Expect<*>.isA(): Expect = @@ -161,7 +153,6 @@ inline fun Expect<*>.isA(): Expect = * `assert(listOf(1, 2)).isA>{}` holds, even though `List` is clearly not a `List`. * * @return An [Expect] with the new type [TSub]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ inline infix fun Expect<*>.isA(noinline assertionCreator: Expect.() -> Unit): Expect = _logic.isA(TSub::class).transformAndAppend(assertionCreator) @@ -248,7 +239,6 @@ inline val Expect.its: Expect get() : Expect = this * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ @@ -262,7 +252,6 @@ infix fun Expect.isNoneOf(values: Values): Expect = * are passed. This function expects [IterableLike] (which is a typealias for [Any]) to avoid cluttering the API. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case the iterable is empty. * * @since 0.13.0 diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceAssertions.kt index 344436bcfa..63abac71bf 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceAssertions.kt @@ -52,7 +52,6 @@ infix fun Expect.containsNot( * so that you can mix [String] and [Int] for instance. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ infix fun Expect.contains(expected: CharSequenceOrNumberOrChar): Expect = @@ -83,7 +82,6 @@ infix fun Expect.contains(expected: CharSequenceOrNumberOr * -- use the function `values(t, ...)` to create a [Values]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case one of the [values] is not a * [CharSequence], [Number] or [Char]. */ @@ -100,7 +98,6 @@ infix fun Expect.contains(values: Values Expect.containsNot(expected: CharSequenceOrNumberOrChar): Expect = this containsNot o value expected @@ -118,7 +115,6 @@ infix fun Expect.containsNot(expected: CharSequenceOrNumbe * @param values The values which should not be found -- use the function `values(t, ...)` to create a [Values]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.containsNot(values: Values): Expect = this containsNot o the values @@ -132,7 +128,6 @@ infix fun Expect.containsNot(values: Values Expect.containsRegex(pattern: String): Expect = this contains o atLeast 1 regex pattern @@ -146,7 +141,6 @@ infix fun Expect.containsRegex(pattern: String): Expect * @param pattern The pattern which is expected to have a match against the input of the search. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.contains(pattern: Regex): Expect = this contains o atLeast 1 matchFor pattern @@ -172,7 +166,6 @@ infix fun Expect.contains(pattern: Regex): Expect = * use the function `regexPatterns(t, ...)` to create a [RegexPatterns]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.contains(regexPatterns: RegexPatterns): Expect = this contains o atLeast 1 the regexPatterns @@ -199,7 +192,6 @@ infix fun Expect.contains(regexPatterns: RegexPatterns): E * use the function `all(Regex(...), ...)` to create a [All]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.contains(patterns: All): Expect = this contains o atLeast 1 matchFor patterns @@ -208,7 +200,6 @@ infix fun Expect.contains(patterns: All): Expect * Expects that the subject of the assertion (a [CharSequence]) starts with [expected]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.startsWith(expected: CharSequence): Expect = _logicAppend { startsWith(expected) } @@ -217,7 +208,6 @@ infix fun Expect.startsWith(expected: CharSequence): Expec * Expects that the subject of the assertion (a [CharSequence]) starts with [expected]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -228,7 +218,6 @@ infix fun Expect.startsWith(expected: Char): Expect = * Expects that the subject of the assertion (a [CharSequence]) does not start with [expected]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.startsNotWith(expected: CharSequence): Expect = _logicAppend { startsNotWith(expected) } @@ -237,7 +226,6 @@ infix fun Expect.startsNotWith(expected: CharSequence): Ex * Expects that the subject of the assertion (a [CharSequence]) does not start with [expected]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -249,7 +237,6 @@ infix fun Expect.startsNotWith(expected: Char): Expect * Expects that the subject of the assertion (a [CharSequence]) ends with [expected]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.endsWith(expected: CharSequence): Expect = _logicAppend { endsWith(expected) } @@ -258,7 +245,6 @@ infix fun Expect.endsWith(expected: CharSequence): Expect< * Expects that the subject of the assertion (a [CharSequence]) ends with [expected]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -269,7 +255,6 @@ infix fun Expect.endsWith(expected: Char): Expect = * Expects that the subject of the assertion (a [CharSequence]) does not end with [expected]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.endsNotWith(expected: CharSequence): Expect = _logicAppend { endsNotWith(expected) } @@ -278,7 +263,6 @@ infix fun Expect.endsNotWith(expected: CharSequence): Expe * Expects that the subject of the assertion (a [CharSequence]) does not end with [expected]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -292,7 +276,6 @@ infix fun Expect.endsNotWith(expected: Char): Expect = * @param empty Use the pseudo-keyword `empty`. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.toBe(@Suppress("UNUSED_PARAMETER") empty: empty): Expect = _logicAppend { isEmpty() } @@ -303,7 +286,6 @@ infix fun Expect.toBe(@Suppress("UNUSED_PARAMETER") empty: * @param empty Use the pseudo-keyword `empty`. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.notToBe(@Suppress("UNUSED_PARAMETER") empty: empty): Expect = _logicAppend { isNotEmpty() } @@ -314,7 +296,6 @@ infix fun Expect.notToBe(@Suppress("UNUSED_PARAMETER") emp * @param blank Use the pseudo-keyword `blank`. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.notToBe(@Suppress("UNUSED_PARAMETER") blank: blank): Expect = _logicAppend { isNotBlank() } @@ -325,7 +306,6 @@ infix fun Expect.notToBe(@Suppress("UNUSED_PARAMETER") bla * In contrast to [containsRegex] it does not look for a partial match but for an entire match. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -338,7 +318,6 @@ infix fun Expect.matches(expected: Regex): Expect = * In contrast to `containsNot.regex` it does not look for a partial match but for an entire match. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceContainsCreators.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceContainsCreators.kt index 71ab96faf0..53ca65dd4e 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceContainsCreators.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceContainsCreators.kt @@ -39,7 +39,6 @@ import kotlin.jvm.JvmName * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ infix fun CheckerStep.value( @@ -69,7 +68,6 @@ infix fun CheckerStep.value( * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case one of the [values] is not a [CharSequence], [Number] or [Char]. */ infix fun CheckerStep.the( @@ -92,7 +90,6 @@ infix fun CheckerStep.the( * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ @JvmName("valueIgnoringCase") @@ -123,7 +120,6 @@ infix fun CheckerStep.value( * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case one of the [values] is not a [CharSequence], [Number] or [Char]. */ @JvmName("valuesIgnoringCase") @@ -146,7 +142,6 @@ infix fun CheckerStep.the( * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ infix fun EntryPointStep.value( @@ -179,7 +174,6 @@ infix fun EntryPointStep.valu * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case one of the [values] is not a [CharSequence], [Number] or [Char]. */ infix fun EntryPointStep.the( @@ -195,7 +189,6 @@ infix fun EntryPointStep.the( * @param pattern The pattern which is expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun CheckerStep.regex(pattern: String): Expect = this the regexPatterns(pattern) @@ -209,7 +202,6 @@ infix fun CheckerStep.regex(pattern: * @param pattern The pattern which is expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -236,7 +228,6 @@ infix fun CheckerStep.matchFor( * -- use the function `regexPatterns(t, ...)` to create a [RegexPatterns]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun CheckerStep.the(patterns: RegexPatterns): Expect = _logicAppend { regex(patterns.toList()) } @@ -260,7 +251,6 @@ infix fun CheckerStep.the(patterns: R * use the function `all(Regex(...), ...)` to create a [All]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -276,7 +266,6 @@ infix fun CheckerStep.matchFor(patter * @param pattern The patterns which is expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @JvmName("regexIgnoringCase") infix fun CheckerStep.regex(pattern: String): Expect = @@ -301,7 +290,6 @@ infix fun CheckerStep.regex(p * -- use the function `regexPatterns(t, ...)` to create a [RegexPatterns]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @JvmName("regexIgnoringCase") infix fun CheckerStep.the(patterns: RegexPatterns): Expect = @@ -316,7 +304,6 @@ infix fun CheckerStep.the(pat * @param pattern The patterns which is expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun EntryPointStep.regex(pattern: String): Expect = this atLeast 1 regex pattern @@ -342,7 +329,6 @@ infix fun EntryPointStep.rege * use the function `regexPatterns(t, ...)` to create a [RegexPatterns]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun EntryPointStep.the(patterns: RegexPatterns): Expect = this atLeast 1 the patterns @@ -362,7 +348,6 @@ infix fun EntryPointStep.the( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * @@ -389,7 +374,6 @@ infix fun CheckerStep.elementsOf( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * @@ -417,7 +401,6 @@ infix fun CheckerStep.element * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceContainsCreatorsDeprecated.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceContainsCreatorsDeprecated.kt index 20c910c122..e1403737c4 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceContainsCreatorsDeprecated.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/charSequenceContainsCreatorsDeprecated.kt @@ -36,7 +36,6 @@ import kotlin.jvm.JvmName * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ infix fun CheckerOption.value( @@ -66,7 +65,6 @@ infix fun CheckerOption.value( * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case one of the [values] is not a [CharSequence], [Number] or [Char]. */ infix fun CheckerOption.the( @@ -89,7 +87,6 @@ infix fun CheckerOption.the( * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ @JvmName("valueIgnoringCase") @@ -120,7 +117,6 @@ infix fun CheckerOption.value * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case one of the [values] is not a [CharSequence], [Number] or [Char]. */ @JvmName("valuesIgnoringCase") @@ -143,7 +139,6 @@ infix fun CheckerOption.the( * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ infix fun Builder.value( @@ -176,7 +171,6 @@ infix fun Builder.value( * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case one of the [values] is not a [CharSequence], [Number] or [Char]. */ infix fun Builder.the( @@ -192,7 +186,6 @@ infix fun Builder.the( * @param pattern The pattern which is expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun CheckerOption.regex(pattern: String): Expect = this the regexPatterns(pattern) @@ -206,7 +199,6 @@ infix fun CheckerOption.regex(pattern * @param pattern The pattern which is expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -233,7 +225,6 @@ infix fun CheckerOption.matchFor( * -- use the function `regexPatterns(t, ...)` to create a [RegexPatterns]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun CheckerOption.the(patterns: RegexPatterns): Expect = addAssertion(ExpectImpl.charSequence.contains.regex(this, patterns.toList())) @@ -257,7 +248,6 @@ infix fun CheckerOption.the(patterns: * use the function `all(Regex(...), ...)` to create a [All]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -274,7 +264,6 @@ infix fun CheckerOption.matchFor(patt * @param pattern The patterns which is expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @JvmName("regexIgnoringCase") infix fun CheckerOption.regex(pattern: String): Expect = @@ -299,7 +288,6 @@ infix fun CheckerOption.regex * -- use the function `regexPatterns(t, ...)` to create a [RegexPatterns]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @JvmName("regexIgnoringCase") infix fun CheckerOption.the(patterns: RegexPatterns): Expect = @@ -314,7 +302,6 @@ infix fun CheckerOption.the(p * @param pattern The patterns which is expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Builder.regex(pattern: String): Expect = this atLeast 1 regex pattern @@ -340,7 +327,6 @@ infix fun Builder.regex(patte * use the function `regexPatterns(t, ...)` to create a [RegexPatterns]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Builder.the(patterns: RegexPatterns): Expect = this atLeast 1 the patterns @@ -361,7 +347,6 @@ infix fun Builder.the(pattern * @param expectedIterable The [Iterable] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterable] is not a [CharSequence], [Number] or [Char] or the given * [expectedIterable] does not have elements (is empty). * @@ -392,7 +377,6 @@ infix fun CheckerOption.elementsOf( * @param expectedIterable The [Iterable] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterable] is not a [CharSequence], [Number] or [Char] or the given * [expectedIterable] does not have elements (is empty). * @@ -423,7 +407,6 @@ infix fun CheckerOption.eleme * @param expectedIterable The [Iterable] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterable] is not a [CharSequence], [Number] or [Char] or the given * [expectedIterable] does not have elements (is empty). * @@ -453,7 +436,6 @@ infix fun Builder.elementsOf( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * @@ -482,7 +464,6 @@ infix fun CheckerOption.elementsOf( * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * @@ -511,7 +492,6 @@ infix fun CheckerOption.eleme * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types or the given * [expectedIterableLike] does not have elements (is empty). * diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/collectionAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/collectionAssertions.kt index fdd9e1dcc6..0b801d2546 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/collectionAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/collectionAssertions.kt @@ -10,7 +10,6 @@ import ch.tutteli.kbox.identity * @param empty Use the pseudo-keyword `empty`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.toBe(@Suppress("UNUSED_PARAMETER") empty: empty): Expect = _logicAppend { isEmpty(::identity) } @@ -21,7 +20,6 @@ infix fun > Expect.toBe(@Suppress("UNUSED_PARAMETER") empty * @param empty Use the pseudo-keyword `empty`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.notToBe(@Suppress("UNUSED_PARAMETER") empty: empty): Expect = _logicAppend { isNotEmpty(::identity) } @@ -32,7 +30,6 @@ infix fun > Expect.notToBe(@Suppress("UNUSED_PARAMETER") em * Shortcut for `size.toBe(expected)`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.hasSize(expected: Int): Expect = size { toBe(expected) } @@ -53,7 +50,6 @@ val > Expect.size: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.size(assertionCreator: Expect.() -> Unit): Expect = _logic.size(::identity).collectAndAppend(assertionCreator) diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/comparableAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/comparableAssertions.kt index 2f48a586cd..51159b6146 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/comparableAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/comparableAssertions.kt @@ -8,7 +8,6 @@ import ch.tutteli.atrium.logic.* * The comparison is carried out with [Comparable.compareTo]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.isLessThan(expected: T): Expect = _logicAppend { isLessThan(expected) } @@ -18,7 +17,6 @@ infix fun > Expect.isLessThan(expected: T): Expect = * The comparison is carried out with [Comparable.compareTo]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.isLessThanOrEqual(expected: T): Expect = _logicAppend { isLessThanOrEqual(expected) } @@ -28,7 +26,6 @@ infix fun > Expect.isLessThanOrEqual(expected: T): Expect> Expect.isGreaterThan(expected: T): Expect = _logicAppend { isGreaterThan(expected) } @@ -38,7 +35,6 @@ infix fun > Expect.isGreaterThan(expected: T): Expect = * The comparison is carried out with [Comparable.compareTo]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.isGreaterThanOrEqual(expected: T): Expect = _logicAppend { isGreaterThanOrEqual(expected) } @@ -48,7 +44,6 @@ infix fun > Expect.isGreaterThanOrEqual(expected: T): Expec * where the comparison is carried out with [Comparable.compareTo]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/creating/feature/Feature.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/creating/feature/Feature.kt index 08c6897a7c..b5dce1f69d 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/creating/feature/Feature.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/creating/feature/Feature.kt @@ -12,7 +12,7 @@ import kotlin.reflect.KProperty1 * * @property description The description of the feature. * @property extractor The extractor which extracts the feature out of the subject of the assertion. - + * * @since 0.12.0 */ data class Feature internal constructor(val description: String, val extractor: (T) -> R) diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/featureAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/featureAssertions.kt index 4247fc3a4c..6d37733ec6 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/featureAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/featureAssertions.kt @@ -78,7 +78,6 @@ infix fun Expect.feature(of: Feature): FeatureExpect = * in-between the required arguments in case of a `KFunctionX` where `X` > 1. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] in case the created [AssertionGroup] does not hold. * * @since 0.12.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/fun0Assertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/fun0Assertions.kt index e007738f9d..83951fad98 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/fun0Assertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/fun0Assertions.kt @@ -13,7 +13,6 @@ import ch.tutteli.atrium.logic.toThrow * the element type is actually `String`. * * @return An [Expect] with the new type [TExpected]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ inline fun Expect Any?>.toThrow(): Expect = _logic.toThrow(TExpected::class).transform() @@ -49,7 +48,6 @@ inline fun Expect Any?>.toThrow(): Exp * the element type is actually `String`. * * @return An [Expect] with the new type [TExpected]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ inline infix fun Expect Any?>.toThrow( noinline assertionCreator: Expect.() -> Unit @@ -61,7 +59,6 @@ inline infix fun Expect Any?>.toThrow( * and changes the subject of the assertion to the return value of type [R]. * * @return An [Expect] with the new type [R]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ fun R> Expect.notToThrow(): Expect = _logic.notToThrow().transform() @@ -71,7 +68,6 @@ fun R> Expect.notToThrow(): Expect = * and that the corresponding return value holds all assertions the given [assertionCreator] creates. * * @return An [Expect] with the new type [R]. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun R> Expect.notToThrow( assertionCreator: Expect.() -> Unit diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableAssertions.kt index bac54df7ec..af444d74ee 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableAssertions.kt @@ -46,7 +46,6 @@ infix fun > Expect.containsNot( * It is a shortcut for `contains o inAny order atLeast 1 value expected` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.contains(expected: E): Expect = it contains o inAny order atLeast 1 value expected @@ -70,7 +69,6 @@ infix fun > Expect.contains(expected: E): Expect = * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.contains(values: Values): Expect = it contains o inAny order atLeast 1 the values @@ -87,7 +85,6 @@ infix fun > Expect.contains(values: Values): Expect * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.contains(assertionCreatorOrNull: (Expect.() -> Unit)?): Expect = it contains o inAny order atLeast 1 entry assertionCreatorOrNull @@ -105,7 +102,6 @@ infix fun > Expect.contains(assertionCreatorOrNull: * -- use the function `entries(t, ...)` to create an [Entries]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.contains(entries: Entries): Expect = it contains o inAny order atLeast 1 the entries @@ -115,9 +111,8 @@ infix fun > Expect.contains(entries: Entries): E * the [expected] value. * * It is a shortcut for `contains o inGiven order and only value expected` - + * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.containsExactly(expected: E): Expect = it contains o inGiven order and only value expected @@ -136,7 +131,6 @@ infix fun > Expect.containsExactly(expected: E): Expect * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.containsExactly(values: Values): Expect = it contains o inGiven order and only the values @@ -157,7 +151,6 @@ infix fun > Expect.containsExactly(values: Values): Exp * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.containsExactly( assertionCreatorOrNull: (Expect.() -> Unit)? @@ -181,7 +174,6 @@ infix fun > Expect.containsExactly( * -- use the function `entries(t, ...)` to create an [Entries]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.containsExactly(entries: Entries): Expect = it contains o inGiven order and only the entries @@ -196,7 +188,6 @@ infix fun > Expect.containsExactly(entries: Entries * are passed. This function expects [IterableLike] (which is a typealias for [Any]) to avoid cluttering the API. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types * or the given [expectedIterableLike] does not have elements (is empty). * @@ -216,7 +207,6 @@ inline infix fun > Expect.containsExactlyElementsO * @param expectedIterableLike The [IterableLike] whose elements are expected to be contained within this [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedIterableLike] is not an [Iterable], [Sequence] or one of the [Array] types * or the given [expectedIterableLike] does not have elements (is empty). * @@ -233,7 +223,6 @@ inline infix fun > Expect.containsElementsOf( * It is a shortcut for `containsNot o value expected` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.containsNot(expected: E): Expect = it containsNot o value expected @@ -248,7 +237,6 @@ infix fun > Expect.containsNot(expected: E): Expect = * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.containsNot(values: Values): Expect = it containsNot o the values @@ -272,7 +260,6 @@ infix fun , T : Iterable> Expect.min(@Suppress("UNUSED_P * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -299,7 +286,6 @@ infix fun , T : Iterable> Expect.max(@Suppress("UNUSED_P * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -315,7 +301,6 @@ infix fun , T : Iterable> Expect.max(assertionCreator: E * It is a shortcut for `contains o inAny order atLeast 1 entry assertionCreatorOrNull` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.any(assertionCreatorOrNull: (Expect.() -> Unit)?): Expect = it contains o inAny order atLeast 1 entry assertionCreatorOrNull @@ -329,7 +314,6 @@ infix fun > Expect.any(assertionCreatorOrNull: (Exp * It is a shortcut for `containsNot o entry assertionCreatorOrNull` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.none(assertionCreatorOrNull: (Expect.() -> Unit)?): Expect = it containsNot o entry assertionCreatorOrNull @@ -340,7 +324,6 @@ infix fun > Expect.none(assertionCreatorOrNull: (Ex * that all elements are `null` in case [assertionCreatorOrNull] is defined as `null`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.all(assertionCreatorOrNull: (Expect.() -> Unit)?): Expect = _logicAppend { all(::identity, assertionCreatorOrNull) } @@ -350,7 +333,6 @@ infix fun > Expect.all(assertionCreatorOrNull: (Exp * Expects that the subject of the assertion (an [Iterable]) has at least one element. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -361,7 +343,6 @@ infix fun > Expect.has(@Suppress("UNUSED_PARAMETER") next: * Expects that the subject of the assertion (an [Iterable]) does not have next element. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -372,7 +353,6 @@ infix fun > Expect.hasNot(@Suppress("UNUSED_PARAMETER") ne * Expects that the subject of the assertion (an [Iterable]) does not have duplicate elements. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableContainsInAnyOrderCreators.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableContainsInAnyOrderCreators.kt index f5db4397b2..fe159e90c8 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableContainsInAnyOrderCreators.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableContainsInAnyOrderCreators.kt @@ -22,7 +22,6 @@ import ch.tutteli.atrium.domain.creating.typeutils.IterableLike * @param expected The value which is expected to be contained within this [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > CheckerOption.value(expected: E): Expect = this the values(expected) @@ -45,7 +44,6 @@ infix fun > CheckerOption.va * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > CheckerOption.the(values: Values): Expect = addAssertion(ExpectImpl.iterable.contains.valuesInAnyOrder(this, values.toList())) @@ -62,7 +60,6 @@ infix fun > CheckerOption.th * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > CheckerOption.entry( assertionCreatorOrNull: (Expect.() -> Unit)? @@ -79,7 +76,6 @@ infix fun > CheckerOption> CheckerOption.the( entries: Entries @@ -95,7 +91,6 @@ infix fun > CheckerOption> CheckerOption> Builder.value(expected: E): Expect = this the values(expected) @@ -43,7 +42,6 @@ infix fun > Builder.valu * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Builder.the(values: Values): Expect = addAssertion(ExpectImpl.iterable.contains.valuesInAnyOrderOnly(this, values.toList())) @@ -64,7 +62,6 @@ infix fun > Builder.the( * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Builder.entry( assertionCreatorOrNull: (Expect.() -> Unit)? @@ -94,7 +91,6 @@ infix fun > Builder> Builder.the( @@ -115,7 +111,6 @@ infix fun > Builder> Builder> Builder.value(expected: E): Expect = this the values(expected) @@ -43,7 +42,6 @@ infix fun > Builder.value(e * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Builder.the(values: Values): Expect = addAssertion(ExpectImpl.iterable.contains.valuesInOrderOnly(this, values.toList())) @@ -64,7 +62,6 @@ infix fun > Builder.the(val * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Builder.entry( assertionCreatorOrNull: (Expect.() -> Unit)? @@ -86,7 +83,6 @@ infix fun > Builder * -- use the function `entries(t, ...)` to create an [Entries]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Builder.the( entries: Entries @@ -106,7 +102,6 @@ infix fun > Builder * @param expectedIterable The [Iterable] whose elements are expected to be contained within this [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case the given [expectedIterable] does not have elements (is empty). * * @since 0.12.0 @@ -136,7 +131,6 @@ inline infix fun > Builder> Builder.inAny( order: Order> @@ -63,7 +62,6 @@ fun order( * ``` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @JvmName("inAnyOrderEntries") infix fun > Builder.inAny( diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableLikeContainsInAnyOrderCreators.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableLikeContainsInAnyOrderCreators.kt index a6afe164d2..cdd174fcd3 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableLikeContainsInAnyOrderCreators.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/iterableLikeContainsInAnyOrderCreators.kt @@ -22,7 +22,6 @@ import ch.tutteli.atrium.logic.utils.toVarArg * @param expected The value which is expected to be contained within this [IterableLike]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -48,7 +47,6 @@ infix fun CheckerStep.val * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -67,7 +65,6 @@ infix fun CheckerStep.the * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -87,7 +84,6 @@ infix fun CheckerStep CheckerStep EntryPointStep.value(expected: E): Expect = this the values(expected) @@ -44,7 +43,6 @@ infix fun EntryPointStep EntryPointStep.the(values: Values): Expect = _logicAppend { valuesInAnyOrderOnly(values.toList()) } @@ -65,7 +63,6 @@ infix fun EntryPointStep EntryPointStep.entry( assertionCreatorOrNull: (Expect.() -> Unit)? @@ -93,7 +90,6 @@ infix fun EntryPointStep EntryPointStep.the( @@ -117,7 +113,6 @@ infix fun EntryPointStep EntryPointStep * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -68,7 +66,6 @@ infix fun EntryPointStep * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 -- API existed for [Iterable] but not for [IterableLike]. */ @@ -91,7 +88,6 @@ infix fun EntryPointStep EntryPointStep EntryPointStep> Expect.has(@Suppress("UNUSED_PARAMETER") next: * Expects that the subject of the assertion (an [Iterator]) does not have next element. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/listAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/listAssertions.kt index ca881b6d29..90807c3531 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/listAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/listAssertions.kt @@ -10,7 +10,6 @@ import ch.tutteli.atrium.logic.get * returns an [Expect] for the element at that position. * * @return The newly created [Expect] for the element at position [index]. - * @throws AssertionError Might throw an [AssertionError] if the given [index] is out of bound. */ infix fun > Expect.get(index: Int): Expect = _logic.get(index).transform() @@ -23,8 +22,6 @@ infix fun > Expect.get(index: Int): Expect = * Use the function `index(Int) { ... }` to create an [IndexWithCreator]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the given [index] is out of bound or - * if the assertion made is not correct. */ infix fun > Expect.get(index: IndexWithCreator): Expect = _logic.get(index.index).collectAndAppend(index.assertionCreator) diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapAssertions.kt index eab695d11e..a97e0a77f8 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapAssertions.kt @@ -27,7 +27,6 @@ infix fun > Expect.contains( * Delegates to 'it contains o inAny order entry keyValuePair'. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.contains(keyValuePair: Pair): Expect = it contains o inAny order entry keyValuePair @@ -39,7 +38,6 @@ infix fun > Expect.contains(keyValuePair: Pair) * Delegates to 'it contains o inAny order but only entry keyValuePair'. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.containsOnly(keyValuePair: Pair): Expect = it contains o inAny order but only entry keyValuePair @@ -58,7 +56,6 @@ infix fun > Expect.containsOnly(keyValuePair: Pair> Expect.contains(keyValuePairs: Pairs): Expect = it contains o inAny order the keyValuePairs @@ -73,7 +70,6 @@ infix fun > Expect.contains(keyValuePairs: Pairs> Expect.containsOnly(keyValuePairs: Pairs): Expect = it contains o inAny order but only the keyValuePairs @@ -92,7 +88,6 @@ infix fun > Expect.containsOnly(keyValuePairs: Pairs< * -- use the function `keyValue(x) { ... }` to create a [KeyWithValueCreator]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ inline infix fun > Expect.contains(keyValue: KeyWithValueCreator): Expect = it contains o inAny order entry keyValue @@ -111,7 +106,6 @@ inline infix fun > Expect.contains(key * -- use the function `keyValue(x) { ... }` to create a [KeyWithValueCreator]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ inline infix fun > Expect.containsOnly(keyValue: KeyWithValueCreator): Expect = it contains o inAny order but only entry keyValue @@ -136,7 +130,6 @@ fun keyValue(key: K, valueAssertionCreatorOrNull: (Expect.() -> * another one is defined as `Key('a') { isLessThan(2) }`, then both match, even though they match the same entry. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ inline infix fun > Expect.contains( allKeyValues: KeyValues @@ -152,7 +145,6 @@ inline infix fun > Expect.contains( * Delegates to `it contains o inAny order but only the keyValues` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ inline infix fun > Expect.containsOnly( allKeyValues: KeyValues @@ -164,7 +156,6 @@ inline infix fun > Expect.containsOnly * Delegates to `it contains o inAny order entriesOf` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.containsEntriesOf( mapLike: MapLike @@ -177,7 +168,6 @@ infix fun > Expect.containsEntriesOf( * Delegates to `it contains o inAny order but only entriesOf` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.containsOnlyEntriesOf( mapLike: MapLike @@ -188,7 +178,6 @@ infix fun > Expect.containsOnlyEntriesOf( * Expects that the subject of the assertion (a [Map]) contains the given [key]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.containsKey(key: K): Expect = _logicAppend { containsKey(::identity, key) } @@ -197,7 +186,6 @@ infix fun > Expect.containsKey(key: K): Expect = * Expects that the subject of the assertion (a [Map]) does not contain the given [key]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.containsNotKey(key: K): Expect = _logicAppend { containsNotKey(::identity, key) } @@ -208,7 +196,6 @@ infix fun > Expect.containsNotKey(key: K): Expect = * so that further fluent calls are assertions about it. * * @return The newly created [Expect] for the extracted feature. - * @throws AssertionError Might throw an [AssertionError] if the given [key] does not exist. */ infix fun > Expect.getExisting(key: K): Expect = _logic.getExisting(::identity, key).transform() @@ -221,8 +208,6 @@ infix fun > Expect.getExisting(key: K): Expect = * to the key and the second is the `assertionCreator`-lambda * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] the given [key] does not exist or - * if the assertion made is not correct. */ infix fun > Expect.getExisting(key: KeyWithCreator): Expect = _logic.getExisting(::identity, key.key).collectAndAppend(key.assertionCreator) @@ -249,7 +234,6 @@ val > Expect.keys: Expect> * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.keys(assertionCreator: Expect>.() -> Unit): Expect = _logic.property(Map::keys).collectAndAppend(assertionCreator) @@ -269,7 +253,6 @@ val > Expect.values: Expect> * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.values(assertionCreator: Expect>.() -> Unit): Expect = _logic.property(Map::values).collectAndAppend(assertionCreator) @@ -306,7 +289,6 @@ infix fun > Expect.asEntries( * @param empty Use the pseudo-keyword `empty`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.toBe(@Suppress("UNUSED_PARAMETER") empty: empty): Expect = _logicAppend { isEmpty(::toEntries) } @@ -318,7 +300,6 @@ infix fun > Expect.toBe(@Suppress("UNUSED_PARAMETER") empty: em * @param empty Use the pseudo-keyword `empty`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.notToBe(@Suppress("UNUSED_PARAMETER") empty: empty): Expect = _logicAppend { isNotEmpty(::toEntries) } diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapCollectionLikeAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapCollectionLikeAssertions.kt index c01d641fb9..2d871f9734 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapCollectionLikeAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapCollectionLikeAssertions.kt @@ -21,7 +21,6 @@ val > Expect.size: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapEntryAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapEntryAssertions.kt index 7070cc56d4..65c16f5140 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapEntryAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapEntryAssertions.kt @@ -12,7 +12,6 @@ import ch.tutteli.atrium.logic.* * reporting etc. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.isKeyValue(keyValuePair: Pair): Expect = _logicAppend { isKeyValue(keyValuePair.first, keyValuePair.second) } @@ -32,7 +31,6 @@ val > Expect.key: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.key(assertionCreator: Expect.() -> Unit): Expect = _logic.key().collectAndAppend(assertionCreator) @@ -52,7 +50,6 @@ val > Expect.value: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.value(assertionCreator: Expect.() -> Unit): Expect = _logic.value().collectAndAppend(assertionCreator) diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapLikeContainsInAnyOrderCreators.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapLikeContainsInAnyOrderCreators.kt index 0f39b5c344..0e79096080 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapLikeContainsInAnyOrderCreators.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapLikeContainsInAnyOrderCreators.kt @@ -20,7 +20,6 @@ import ch.tutteli.atrium.logic.utils.toVarArgPairs * Delegates to `the pairs(keyValuePair)`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ @@ -37,7 +36,6 @@ infix fun EntryPointStep * even though they match the same entry. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ @@ -55,7 +53,6 @@ infix fun EntryPointStep * Delegates to `the keyValues(keyValue)`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ @@ -77,7 +74,6 @@ inline infix fun EntryPointStep keyValues( * @param expectedMapLike The [MapLike] whose elements are expected to be contained within this [MapLike]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expectedMapLike] is not * a [Map], [Sequence] or one of the [Array] types * or the given [expectedMapLike] does not have elements (is empty). diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapLikeContainsInAnyOrderOnlyCreators.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapLikeContainsInAnyOrderOnlyCreators.kt index 69d172f6b0..888c09979f 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapLikeContainsInAnyOrderOnlyCreators.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/mapLikeContainsInAnyOrderOnlyCreators.kt @@ -20,7 +20,6 @@ import ch.tutteli.atrium.logic.utils.toVarArgPairs * Delegates to `the pairs(keyValuePair)`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.15.0 */ @@ -34,7 +33,6 @@ infix fun EntryPointStep EntryPointStep EntryPointStep EntryPointStep EntryPointStep EntryPointStep EntryPointStep EntryPointStep> Expect.first: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.first(assertionCreator: Expect.() -> Unit): Expect = _logic.first().collectAndAppend(assertionCreator) @@ -40,7 +39,6 @@ val > Expect.second: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun > Expect.second(assertionCreator: Expect.() -> Unit): Expect = _logic.second().collectAndAppend(assertionCreator) diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/throwableAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/throwableAssertions.kt index 19d9e2d40d..7767151c46 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/throwableAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/throwableAssertions.kt @@ -11,7 +11,6 @@ import ch.tutteli.atrium.logic.causeIsA * creates an [Expect] for it and returns it. * * @return The newly created [Expect] for the property [Throwable.message] of the subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ val Expect.message: Expect get() = it feature Throwable::message notToBeNull o @@ -22,7 +21,6 @@ val Expect.message: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.message(assertionCreator: Expect.() -> Unit): Expect = it feature of(Throwable::message) { it notToBeNull assertionCreator } @@ -36,7 +34,6 @@ infix fun Expect.message(assertionCreator: Expect.() * so that you can mix [String] and [Int] for instance. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.messageContains(expected: CharSequenceOrNumberOrChar): Expect = this messageContains values(expected) @@ -52,7 +49,6 @@ infix fun Expect.messageContains(expected: CharSequenceOrNumb * -- use the function `values(t, ...)` to create a [Values]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Expect.messageContains(values: Values): Expect = message { contains(values) } @@ -62,7 +58,6 @@ infix fun Expect.messageContains(values: Values): Expect * creates an [Expect] of the [TExpected] type for it and returns it. * * @return The newly created [Expect] for the property [Throwable.cause] of the subject of the assertion - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -78,7 +73,6 @@ inline fun Expect.cause(): Expect * [Expect] of the initial type, which was some type `T `, but an [Expect] of the specified type [TExpected]. * * @return This assertion container to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/bigDecimalAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/bigDecimalAssertions.kt index 1673b4d621..cccbf918bd 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/bigDecimalAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/bigDecimalAssertions.kt @@ -49,8 +49,7 @@ infix fun Expect.toBe(expected: T): Nothing = throw PleaseU * Expects that the subject of the assertion (a [BigDecimal]) is `null`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. - * + */ @JvmName("toBeNull") infix fun Expect.toBe(expected: Nothing?): Expect = @@ -91,8 +90,7 @@ infix fun Expect.notToBe(expected: T): Nothing = throw Pleas * - `expect(BigDecimal("10")).isNumericallyEqualTo(BigDecimal("10.0"))` holds. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. - * + */ infix fun Expect.isNumericallyEqualTo(expected: T): Expect = _logicAppend { isNumericallyEqualTo(expected) } @@ -110,8 +108,7 @@ infix fun Expect.isNumericallyEqualTo(expected: T): Expect Expect.isNotNumericallyEqualTo(expected: T): Expect = _logicAppend { isNotNumericallyEqualTo(expected) } @@ -127,8 +124,7 @@ infix fun Expect.isNotNumericallyEqualTo(expected: T): Expec * - `expect(BigDecimal("10")).isNumericallyEqualTo(BigDecimal("10.0"))` holds. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. - * + */ infix fun Expect.isEqualIncludingScale(expected: T): Expect = _logicAppend { isEqualIncludingScale(expected, this::isNumericallyEqualTo.name) } @@ -143,8 +139,7 @@ infix fun Expect.isEqualIncludingScale(expected: T): Expect< * - `expect(BigDecimal("10")).isNotNumericallyEqualTo(BigDecimal("10.0"))` does not hold. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. - * + */ infix fun Expect.isNotEqualIncludingScale(expected: T): Expect = _logicAppend { isNotEqualIncludingScale(expected) } diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoLocalDateAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoLocalDateAssertions.kt index 660db5ec06..9410504ff8 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoLocalDateAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoLocalDateAssertions.kt @@ -14,7 +14,6 @@ import java.time.chrono.ChronoLocalDate * is before the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -26,7 +25,6 @@ infix fun Expect.isBefore(expected: ChronoLocalDate): E * is before or equal the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -38,7 +36,6 @@ infix fun Expect.isBeforeOrEqual(expected: ChronoLocalD * is after the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -50,7 +47,6 @@ infix fun Expect.isAfter(expected: ChronoLocalDate): Ex * is after or equal the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -62,7 +58,6 @@ infix fun Expect.isAfterOrEqual(expected: ChronoLocalDa * is equal to the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -75,7 +70,6 @@ infix fun Expect.isEqual(expected: ChronoLocalDate): Ex * The [expected] parameter needs to be in the form of **yyyy-mm-dd** or else a [java.time.DateTimeException] will be thrown. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -88,7 +82,6 @@ infix fun Expect.isBefore(expected: String): Expect * The [expected] parameter needs to be in the form of **yyyy-mm-dd** or else a [java.time.DateTimeException] will be thrown. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -101,7 +94,6 @@ infix fun Expect.isBeforeOrEqual(expected: String): Exp * The [expected] parameter needs to be in the form of **yyyy-mm-dd** or else a [java.time.DateTimeException] will be thrown. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -114,7 +106,6 @@ infix fun Expect.isAfter(expected: String): Expect = * The [expected] parameter needs to be in the form of **yyyy-mm-dd** or else a [java.time.DateTimeException] will be thrown. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -127,7 +118,6 @@ infix fun Expect.isAfterOrEqual(expected: String): Expe * The [expected] parameter needs to be in the form of **yyyy-mm-dd** or else a [java.time.DateTimeException] will be thrown. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoLocalDateTimeAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoLocalDateTimeAssertions.kt index 37b1983643..98a901dc9b 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoLocalDateTimeAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoLocalDateTimeAssertions.kt @@ -16,7 +16,6 @@ import java.time.chrono.ChronoLocalDateTime * is before the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -29,7 +28,6 @@ infix fun > Expect.isBefore( * is before or equal the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -42,7 +40,6 @@ infix fun > Expect.isBeforeOrEqu * is after the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -55,7 +52,6 @@ infix fun > Expect.isAfter( * is after or equal the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -68,7 +64,6 @@ infix fun > Expect.isAfterOrEqua * is equal to the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -88,7 +83,6 @@ infix fun > Expect.isEqual( * yyyy-mm-dd * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ @@ -108,7 +102,6 @@ infix fun > Expect.isBefore( * yyyy-mm-dd * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ @@ -128,7 +121,6 @@ infix fun > Expect.isBeforeOrEqu * yyyy-mm-dd * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ @@ -148,7 +140,6 @@ infix fun > Expect.isAfter( * yyyy-mm-dd * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ @@ -168,7 +159,6 @@ infix fun > Expect.isAfterOrEqua * yyyy-mm-dd * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoZonedDateTimeAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoZonedDateTimeAssertions.kt index 47f99d884b..5623bd80bc 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoZonedDateTimeAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/chronoZonedDateTimeAssertions.kt @@ -15,7 +15,6 @@ import java.time.chrono.ChronoZonedDateTime * is before the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -28,7 +27,6 @@ infix fun > Expect.isBefore( * is before or equals the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -41,7 +39,6 @@ infix fun > Expect.isBeforeOrEqu * is after the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -54,7 +51,6 @@ infix fun > Expect.isAfter( * is after or equal the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -67,7 +63,6 @@ infix fun > Expect.isAfterOrEqua * is equal to the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -101,7 +96,6 @@ infix fun > Expect.isEqual( * - 2020-01-02+01:30 * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -135,7 +129,6 @@ infix fun > Expect.isBefore( * - 2020-01-02+01:30 * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -169,7 +162,6 @@ infix fun > Expect.isBeforeOrEqu * - 2020-01-02+01:30 * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -203,7 +195,6 @@ infix fun > Expect.isAfter( * - 2020-01-02+01:30 * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -237,7 +228,6 @@ infix fun > Expect.isAfterOrEqua * - 2020-01-02+01:30 * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/localDateAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/localDateAssertions.kt index 7ebc1d654c..3496144020 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/localDateAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/localDateAssertions.kt @@ -27,7 +27,6 @@ val Expect.year: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -51,7 +50,6 @@ val Expect.month: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -75,7 +73,6 @@ val Expect.dayOfWeek: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -100,7 +97,6 @@ val Expect.day: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/localDateTimeAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/localDateTimeAssertions.kt index 3ba67d361e..7c3f20c325 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/localDateTimeAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/localDateTimeAssertions.kt @@ -27,7 +27,6 @@ val Expect.year: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -51,7 +50,6 @@ val Expect.month: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -75,7 +73,6 @@ val Expect.dayOfWeek: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -99,7 +96,6 @@ val Expect.day: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/optionalAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/optionalAssertions.kt index dd4859fb7a..722d1dcc2f 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/optionalAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/optionalAssertions.kt @@ -21,7 +21,6 @@ import java.util.* * depends on the underlying implementation though. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -36,7 +35,6 @@ infix fun > Expect.toBe(@Suppress("UNUSED_PARAMETER") empty: * depends on the underlying implementation though. * * @return The newly created [Expect] for the inner type [E]. - * @throws AssertionError Might throw an [AssertionError] if the given assertion is not a success. * * @since 0.12.0 */ @@ -48,7 +46,6 @@ infix fun > Expect.toBe(@Suppress("UNUSED_PARAMETER") pres * that it holds all assertions the given [PresentWithCreator.assertionCreator] creates. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the given assertions are not success. * * @since 0.12.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/pathAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/pathAssertions.kt index 4a395f79f0..680fe2558a 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/pathAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/pathAssertions.kt @@ -18,7 +18,6 @@ import java.nio.file.Path * Expects that the subject of the assertion (a [Path]) starts with the [expected] [Path]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -29,7 +28,6 @@ infix fun Expect.startsWith(expected: Path): Expect = * Expects that the subject of the assertion (a [Path]) does not start with the [expected] [Path]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -40,7 +38,6 @@ infix fun Expect.startsNotWith(expected: Path): Expect = * Expects that the subject of the assertion (a [Path]) ends with the expected [Path]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -52,7 +49,6 @@ infix fun Expect.endsWith(expected: Path): Expect = * * @param expected The [Path] provided to the assertion * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -67,7 +63,6 @@ infix fun Expect.endsNotWith(expected: Path): Expect = * then the search will continue at that location. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -82,7 +77,6 @@ infix fun Expect.toBe(@Suppress("UNUSED_PARAMETER") existing: exis * then the search will continue at that location. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -108,7 +102,6 @@ val Expect.fileName: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -121,7 +114,6 @@ infix fun Expect.fileName(assertionCreator: Expect.() -> U * so that further fluent calls are assertions about it. * * @return The newly created [Expect] for the extracted feature. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -135,7 +127,6 @@ val Expect.fileNameWithoutExtension: Expect * and returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -147,7 +138,6 @@ infix fun Expect.fileNameWithoutExtension(assertionCreator: Expect * so that further fluent calls are assertions about it. * * @return The newly created [Expect] for the extracted feature. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -159,7 +149,6 @@ val Expect.parent: Expect * given [assertionCreator] creates for it and returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -171,7 +160,6 @@ infix fun Expect.parent(assertionCreator: Expect.() -> Unit) * so that further fluent calls are assertions about it. * * @return The newly created [Expect] for the extracted feature. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -193,7 +181,6 @@ infix fun Expect.resolve(other: String): Expect = * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @see [has] * * @since 0.14.0 @@ -216,7 +203,6 @@ infix fun Expect.hasDirectoryEntry(entry: String) = * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @see [directoryEntries] * @see [hasDirectoryEntry] * @@ -240,7 +226,6 @@ fun directoryEntries(entry: String, vararg otherEntries: String) = DirectoryEntr * Use the function `path(String) { ... }` to create a [PathWithCreator]. * * @return The newly created [Expect] for the extracted feature. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -267,7 +252,6 @@ fun path(path: String, assertionCreator: Expect.() -> Unit): PathWithCrea * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -284,7 +268,6 @@ infix fun Expect.toBe(@Suppress("UNUSED_PARAMETER") readable: read * at the location the link points at. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -305,7 +288,6 @@ infix fun Expect.toBe(@Suppress("UNUSED_PARAMETER") writable: writ * at the location the link points at. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -325,7 +307,6 @@ infix fun Expect.toBe(@Suppress("UNUSED_PARAMETER") executable: ex * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -345,7 +326,6 @@ infix fun Expect.toBe(@Suppress("UNUSED_PARAMETER") aRegularFile: * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -357,7 +337,6 @@ infix fun Expect.toBe(@Suppress("UNUSED_PARAMETER") aDirectory: aD * meaning that the [Path] specified in this instance starts at the file system root. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -369,7 +348,6 @@ infix fun Expect.toBe(@Suppress("UNUSED_PARAMETER") absolute: abso * meaning that the [Path] specified in this instance does not start at the file system root. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.14.0 */ @@ -396,7 +374,6 @@ val Expect.extension: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -408,7 +385,6 @@ infix fun Expect.extension(assertionCreator: Expect.() -> * as [targetPath] (using UTF-8 for encoding) * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ @@ -438,7 +414,6 @@ fun withEncoding( * Use the function `withEncoding(Path, Charset, Charset)` to create a [PathWithEncoding]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ @@ -452,7 +427,6 @@ infix fun Expect.hasSameTextualContentAs(pathWithEncoding: PathWit * as [targetPath]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.13.0 */ diff --git a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/zonedDateTimeAssertions.kt b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/zonedDateTimeAssertions.kt index 5c588e7198..70ea7c15c9 100644 --- a/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/zonedDateTimeAssertions.kt +++ b/apis/infix-en_GB/atrium-api-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/zonedDateTimeAssertions.kt @@ -27,7 +27,6 @@ val Expect.year: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -51,7 +50,6 @@ val Expect.month: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -75,7 +73,6 @@ val Expect.dayOfWeek: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -99,7 +96,6 @@ val Expect.day: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ diff --git a/apis/infix-en_GB/extensions/kotlin_1_3/atrium-api-infix-en_GB-kotlin_1_3-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/kotlin_1_3/resultAssertions.kt b/apis/infix-en_GB/extensions/kotlin_1_3/atrium-api-infix-en_GB-kotlin_1_3-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/kotlin_1_3/resultAssertions.kt index e4fea61ab0..fb3da3bdb9 100644 --- a/apis/infix-en_GB/extensions/kotlin_1_3/atrium-api-infix-en_GB-kotlin_1_3-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/kotlin_1_3/resultAssertions.kt +++ b/apis/infix-en_GB/extensions/kotlin_1_3/atrium-api-infix-en_GB-kotlin_1_3-common/src/main/kotlin/ch/tutteli/atrium/api/infix/en_GB/kotlin_1_3/resultAssertions.kt @@ -12,7 +12,6 @@ import ch.tutteli.atrium.logic.kotlin_1_3.isSuccess * and returns an [Expect] for the inner type [E]. * * @return The newly created [Expect] if the given assertion is success - * @throws AssertionError Might throw an [AssertionError] if the given assertion is not a success. * * @since 0.12.0 */ @@ -26,7 +25,6 @@ infix fun > Expect.toBe(@Suppress("UNUSED_PARAMETER") succes * Use the function `success { ... }` to create a [SuccessWithCreator]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the given assertions are not success. * * @since 0.12.0 */ @@ -38,7 +36,6 @@ infix fun > Expect.toBe(success: SuccessWithCreator): Exp * that it encapsulates an exception of type [TExpected]. * * @return An [Expect] with the new type [TExpected] - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -51,7 +48,6 @@ inline fun Expect>.isFailure(): Ex * holds all assertions the given [assertionCreator] creates. * * @return An [Expect] with the new type [TExpected] - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ diff --git a/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/checking/AssertionChecker.kt b/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/checking/AssertionChecker.kt index 977eb07f2a..3209393a81 100644 --- a/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/checking/AssertionChecker.kt +++ b/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/checking/AssertionChecker.kt @@ -18,7 +18,7 @@ interface AssertionChecker { * have been created. * @param assertions The [assertions] which shall be checked. * - * @throws AssertionError An implementation is allowed to throw [AssertionError] if an assertion fails. + * @throws AssertionError An implementation is allowed to throw an [AssertionError] if an assertion fails. */ fun check(assertionVerb: Translatable, representation: Any?, assertions: List) diff --git a/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/AssertionHolder.kt b/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/AssertionHolder.kt index 2c497cd531..626fbf8aa8 100644 --- a/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/AssertionHolder.kt +++ b/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/AssertionHolder.kt @@ -17,7 +17,6 @@ interface AssertionHolder { * @param assertion The assertion which will be added to this holder. * * @return This holder to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] in case the [Assertion] does not hold. - */ + */ fun addAssertion(assertion: Assertion): AssertionHolder } diff --git a/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/AssertionPlantWithCommonFields.kt b/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/AssertionPlantWithCommonFields.kt index a5bbc030ae..74d2cb9558 100644 --- a/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/AssertionPlantWithCommonFields.kt +++ b/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/AssertionPlantWithCommonFields.kt @@ -68,8 +68,7 @@ interface AssertionPlantWithCommonFields { * * @param assertions The assertions which shall be checked. * - * @throws AssertionError Might throw an [AssertionError] if any of the [assertions] does not hold. - */ + */ fun check(assertions: List) { @Suppress("DEPRECATION") assertionChecker.check(assertionVerb, representation, assertions) diff --git a/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/Expect.kt b/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/Expect.kt index 465cea6cb1..c949bf841c 100644 --- a/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/Expect.kt +++ b/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/Expect.kt @@ -46,8 +46,7 @@ interface Expect : SubjectProvider { * @param assertionCreator The receiver function which should create and add assertions to this container. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] depending on the concrete implementation. - */ + */ fun addAssertionsCreatedBy(assertionCreator: Expect.() -> Unit): Expect /** diff --git a/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/ReportingAssertionContainer.kt b/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/ReportingAssertionContainer.kt index 7c7e0caaa1..8b816218e8 100644 --- a/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/ReportingAssertionContainer.kt +++ b/core/api/atrium-core-api-common/src/main/kotlin/ch/tutteli/atrium/creating/ReportingAssertionContainer.kt @@ -52,8 +52,7 @@ interface ReportingAssertionContainer : RootExpect { * * @param assertions The assertions which shall be checked. * - * @throws AssertionError Might throw an [AssertionError] if any of the [assertions] does not hold. - */ + */ fun check(assertions: List) diff --git a/core/robstoll-lib/atrium-core-robstoll-lib-common/src/main/kotlin/ch/tutteli/atrium/core/robstoll/lib/checking/FeatureAssertionChecker.kt b/core/robstoll-lib/atrium-core-robstoll-lib-common/src/main/kotlin/ch/tutteli/atrium/core/robstoll/lib/checking/FeatureAssertionChecker.kt index 6b0c3de3c1..25352f919f 100644 --- a/core/robstoll-lib/atrium-core-robstoll-lib-common/src/main/kotlin/ch/tutteli/atrium/core/robstoll/lib/checking/FeatureAssertionChecker.kt +++ b/core/robstoll-lib/atrium-core-robstoll-lib-common/src/main/kotlin/ch/tutteli/atrium/core/robstoll/lib/checking/FeatureAssertionChecker.kt @@ -43,8 +43,7 @@ class FeatureAssertionChecker(private val originalAssertionHolder: AssertionHold * @param representation Is used as [AssertionGroup.representation]. * @param assertions Is used as [AssertionGroup.assertions]. * - * @throws AssertionError Might throw an [AssertionError] in case one of the given [assertions] does not hold. - */ + */ override fun check(assertionVerb: Translatable, representation: Any?, assertions: List) { originalAssertionHolder.addAssertion( assertionBuilder.feature diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/anyAssertions.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/anyAssertions.kt index 11bf9fed85..e8a9b94f80 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/anyAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/anyAssertions.kt @@ -18,7 +18,6 @@ import ch.tutteli.atrium.reporting.Reporter * Currently the following is possible: `assert(1).toBe(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.toBe(expected)")) fun Assert.toBe(expected: T) @@ -31,7 +30,6 @@ fun Assert.toBe(expected: T) * Currently the following is possible: `assert(1).notToBe(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.notToBe(expected)")) fun Assert.notToBe(expected: T) @@ -44,7 +42,6 @@ fun Assert.notToBe(expected: T) * Currently the following is possible: `assert(1).isSame(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `isSameAs` from package en_GB; will be removed with 1.0.0", ReplaceWith("isSameAs(expected)", "ch.tutteli.atrium.api.cc.en_GB.isSameAs")) fun Assert.isSame(expected: T) @@ -57,7 +54,6 @@ fun Assert.isSame(expected: T) * Currently the following is possible: `assert(1).isNotSame(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `isNotSameAs` from package en_GB; will be removed with 1.0.0", ReplaceWith("isNotSameAs(expected)", "ch.tutteli.atrium.api.cc.en_GB.isNotSameAs")) fun Assert.isNotSame(expected: T) @@ -68,7 +64,6 @@ fun Assert.isNotSame(expected: T) * * @return Does not support a fluent API because: what else would you want to assert about `null` anyway? * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Will be removed with 1.0.0 because it is redundant in terms of `toBe(null)` without adding enough to be a legit alternative.", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.toBe(null)")) fun AssertionPlantNullable.isNull() { diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/bigDecimalAssertions.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/bigDecimalAssertions.kt index 9e78c3450f..c884ddf01a 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/bigDecimalAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/bigDecimalAssertions.kt @@ -41,7 +41,6 @@ fun Assert.notToBe(expected: T): Nothing * - `assert(BigDecimal("10")).isNumericallyEqualTo(BigDecimal("10.0"))` holds. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isNumericallyEqualTo(expected)")) fun Assert.isNumericallyEqualTo(expected: T) @@ -60,7 +59,6 @@ fun Assert.isNumericallyEqualTo(expected: T) * - `assert(BigDecimal("10")).isNotNumericallyEqualTo(BigDecimal("10.0"))` does not hold. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isNotNumericallyEqualTo(expected)")) fun Assert.isNotNumericallyEqualTo(expected: T) @@ -77,7 +75,6 @@ fun Assert.isNotNumericallyEqualTo(expected: T) * - `assert(BigDecimal("10")).isNumericallyEqualTo(BigDecimal("10.0"))` holds. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.v(expected)")) fun Assert.isEqualIncludingScale(expected: T) @@ -93,7 +90,6 @@ fun Assert.isEqualIncludingScale(expected: T) * - `assert(BigDecimal("10")).isNotNumericallyEqualTo(BigDecimal("10.0"))` does not hold. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isNotEqualIncludingScale(expected)")) fun Assert.isNotEqualIncludingScale(expected: T) diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/booleanAssertions.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/booleanAssertions.kt index 63939bd307..122c7a8114 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/booleanAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/booleanAssertions.kt @@ -11,7 +11,6 @@ import ch.tutteli.atrium.creating.SubjectProvider * Delegates to [toBe] with argument `true`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Will be removed with 1.0.0 because it is redundant with `toBe(true)` without adding enough to be a legit alternative.", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.toBe(true)")) fun Assert.isTrue() = toBe(true) @@ -22,7 +21,6 @@ fun Assert.isTrue() = toBe(true) * Delegates to [toBe] with argument `false`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Will be removed with 1.0.0 because it is redundant with `toBe(false)` without adding enough to be a legit alternative.", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.toBe(false)")) fun Assert.isFalse() = toBe(false) diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/charSequenceAssertions.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/charSequenceAssertions.kt index 38c1101874..8cbb790b2e 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/charSequenceAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/charSequenceAssertions.kt @@ -67,7 +67,6 @@ fun getContainsNot(plant: Assert): DeprecatedNotCheckerBu * `contains('a', 'a')` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] or one of the [otherExpected] is not a * [CharSequence], [Number] or [Char]. */ @@ -82,7 +81,6 @@ fun Assert.contains(expected: Any, vararg otherExpected: A * It is a shortcut for `containsNot.values(expected, *otherExpected)`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.containsNot(expected, *otherExpected)")) fun Assert.containsNot(expected: Any, vararg otherExpected: Any) @@ -109,7 +107,6 @@ fun Assert.containsNot(expected: Any, vararg otherExpected * `containsDefaultTranslationOf(IS, IS)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.containsDefaultTranslationOf(expected, *otherExpected)")) fun Assert.containsDefaultTranslationOf(expected: Translatable, vararg otherExpected: Translatable): AssertionPlant @@ -123,7 +120,6 @@ fun Assert.containsDefaultTranslationOf(expected: Translat * It is a shortcut for `containsNot.defaultTranslationOf(expected, *otherExpected)`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.containsNotDefaultTranslationOf(expected, *otherExpected)")) fun Assert.containsNotDefaultTranslationOf(expected: Translatable, vararg otherExpected: Translatable) @@ -151,7 +147,6 @@ fun Assert.containsNotDefaultTranslationOf(expected: Trans * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.containsRegex(expected, *otherExpected)")) fun Assert.containsRegex(pattern: String, vararg otherPatterns: String): AssertionPlant @@ -161,7 +156,6 @@ fun Assert.containsRegex(pattern: String, vararg otherPatt * Makes the assertion that the [Assert.subject][SubjectProvider.subject] starts with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.startsWith(expected)")) fun Assert.startsWith(expected: CharSequence) @@ -171,7 +165,6 @@ fun Assert.startsWith(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not start with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.startsNotWith(expected)")) fun Assert.startsNotWith(expected: CharSequence) @@ -182,7 +175,6 @@ fun Assert.startsNotWith(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] ends with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.endsWith(expected)")) fun Assert.endsWith(expected: CharSequence) @@ -192,7 +184,6 @@ fun Assert.endsWith(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not end with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.endsNotWith(expected)")) fun Assert.endsNotWith(expected: CharSequence) @@ -203,7 +194,6 @@ fun Assert.endsNotWith(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] [CharSequence].[kotlin.text.isEmpty]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isEmpty()")) fun Assert.isEmpty() @@ -213,7 +203,6 @@ fun Assert.isEmpty() * Makes the assertion that the [Assert.subject][SubjectProvider.subject] [CharSequence].[kotlin.text.isNotEmpty]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isNotEmpty()")) fun Assert.isNotEmpty() diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/charSequenceContainsCreators.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/charSequenceContainsCreators.kt index 90ea1578b9..4e6123a002 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/charSequenceContainsCreators.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/charSequenceContainsCreators.kt @@ -26,7 +26,6 @@ import ch.tutteli.atrium.reporting.translating.Translatable * @param expected The object which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.value(expected)")) @@ -55,7 +54,6 @@ fun CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption.defaultTranslationOf(expected: Translatable, vararg otherExpected: Translatable): AssertionPlant @@ -160,7 +155,6 @@ fun CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption.regex(pattern: String, vararg otherPatterns: String): AssertionPlant @@ -212,7 +205,6 @@ fun CharSequenceContains.CheckerOption> Assert.hasSize(size: Int) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is an empty [Collection]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isEmpty()")) fun > Assert.isEmpty() @@ -32,7 +30,6 @@ fun > Assert.isEmpty() * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is not an empty [Collection]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isNotEmpty()")) fun > Assert.isNotEmpty() diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/comparableAssertions.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/comparableAssertions.kt index b47bbb6f58..1c967f7f7e 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/comparableAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/comparableAssertions.kt @@ -11,7 +11,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is less than [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isLessThan(expected)")) fun > Assert.isLessThan(expected: T) @@ -21,7 +20,6 @@ fun > Assert.isLessThan(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is less than or equals [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isLessOrEquals(expected)")) fun > Assert.isLessOrEquals(expected: T) @@ -31,7 +29,6 @@ fun > Assert.isLessOrEquals(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is greater than [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isGreaterThan(expected)")) fun > Assert.isGreaterThan(expected: T) @@ -41,7 +38,6 @@ fun > Assert.isGreaterThan(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is greater than or equals [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isGreaterOrEquals(expected)")) fun > Assert.isGreaterOrEquals(expected: T) diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/featureAssertions.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/featureAssertions.kt index 6547dec29c..6ad7b3d1c5 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/featureAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/featureAssertions.kt @@ -28,9 +28,6 @@ fun Assert.property(property: KProperty0 Assert.property(property: KProperty0, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -64,9 +61,6 @@ fun Assert.returnValueOf(method: KFunction0 Assert.returnValueOf(method: KFunction0, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -101,9 +95,6 @@ fun Assert.returnValueOf(method: KFu * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.returnValueOf(method, arg1, assertionCreator)")) fun Assert.returnValueOf(method: KFunction1, arg1: T1, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -138,9 +129,6 @@ fun Assert.returnValueOf( * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.returnValueOf(method, arg1, arg2, assertionCreator)")) fun Assert.returnValueOf(method: KFunction2, arg1: T1, arg2: T2, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -176,9 +164,6 @@ fun Assert.ret * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.returnValueOf(method, arg1, arg2, arg3, assertionCreator)")) fun Assert.returnValueOf(method: KFunction3, arg1: T1, arg2: T2, arg3: T3, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -213,9 +198,6 @@ fun As * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.returnValueOf(method, arg1, arg2, arg3, arg4, assertionCreator)")) fun Assert.returnValueOf(method: KFunction4, arg1: T1, arg2: T2, arg3: T3, arg4: T4, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -250,9 +232,6 @@ fun Assert.returnValueOf(method: KFunction5, arg1: T1, arg2: T2, arg3: T3, arg4: T4, arg5: T5, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/floatingPointAssertions.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/floatingPointAssertions.kt index d77df5cff1..6e41393a77 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/floatingPointAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/floatingPointAssertions.kt @@ -19,7 +19,6 @@ import java.math.BigDecimal * | [Assert.subject][SubjectProvider.subject] - [expected] | ≤ [tolerance] * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.toBeWithErrorTolerance(expected, tolerance)")) fun Assert.toBeWithErrorTolerance(expected: Float, tolerance: Float) @@ -36,7 +35,6 @@ fun Assert.toBeWithErrorTolerance(expected: Float, tolerance: Float) * | [Assert.subject][SubjectProvider.subject] - [expected] | ≤ [tolerance] * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.toBeWithErrorTolerance(expected, tolerance)")) fun Assert.toBeWithErrorTolerance(expected: Double, tolerance: Double) @@ -53,7 +51,6 @@ fun Assert.toBeWithErrorTolerance(expected: Double, tolerance: Double) * | [Assert.subject][SubjectProvider.subject] - [expected] | ≤ [tolerance] * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.toBeWithErrorTolerance(expected, tolerance)")) fun Assert.toBeWithErrorTolerance(expected: BigDecimal, tolerance: BigDecimal) diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableAssertions.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableAssertions.kt index 16f07c78ba..7fb799fdf2 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableAssertions.kt @@ -60,7 +60,6 @@ fun > getContainsNot(plant: Assert): DeprecatedNotCheckerB * `contains('a', 'a')` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `containsNullableValues` from package en_GB or `contains` from package en_GB in case you do not deal with nullable elements; will be removed with 1.0.0", ReplaceWith("containsNullableValues(expected, *otherExpected)", "ch.tutteli.atrium.api.cc.en_GB.containsNullableValues")) fun > Assert.contains(expected: E, vararg otherExpected: E): AssertionPlant @@ -74,7 +73,6 @@ fun > Assert.contains(expected: E, vararg otherExpected: E * It is a shortcut for `contains.inAnyOrder.atLeast(1).entries(assertionCreator, *otherAssertionCreators)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.contains(assertionCreator, *otherAssertionCreators)")) fun > Assert.contains(assertionCreator: Assert.() -> Unit, vararg otherAssertionCreators: Assert.() -> Unit): AssertionPlant @@ -88,7 +86,6 @@ fun > Assert.contains(assertionCreator: Assert.() * It is a shortcut for `contains.inAnyOrder.atLeast(1).entries(assertionCreator, *otherAssertionCreators)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @JvmName("containsDeprecated") @Deprecated("Use `containsNullableEntries` from package en_GB or `contains` from package en_GB in case you do not deal with nullable elements; will be removed with 1.0.0", ReplaceWith("containsNullableEntries(assertionCreator, *otherAssertionCreators)", "ch.tutteli.atrium.api.cc.en_GB.containsNullableEntries")) @@ -107,7 +104,6 @@ fun > containsNullable(plant: Assert, assertionCrea * It is a shortcut for `contains.inOrder.only.values(expected, *otherExpected)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `containsStrictlyNullableValues` from package en_GB or `containsStrictly` from package en_GB in case you do not deal with nullable elements; will be removed with 1.0.0", ReplaceWith("containsStrictlyNullableValues(expected, *otherExpected)", "ch.tutteli.atrium.api.cc.en_GB.containsStrictlyNullableValues")) fun > Assert.containsStrictly(expected: E, vararg otherExpected: E): AssertionPlant @@ -121,7 +117,6 @@ fun > Assert.containsStrictly(expected: E, vararg otherExp * It is a shortcut for `contains.inOrder.only.entries(expected, *otherExpected)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.containsStrictly(assertionCreator, *otherAssertionCreators)")) fun > Assert.containsStrictly(assertionCreator: Assert.() -> Unit, vararg otherAssertionCreators: Assert.() -> Unit): AssertionPlant @@ -135,7 +130,6 @@ fun > Assert.containsStrictly(assertionCreator: Asse * It is a shortcut for `contains.inOrder.only.entries(expected, *otherExpected)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `containsStrictlyNullableEntries` from package en_GB or `containsStrictly` from package en_GB in case you do not deal with nullable elements; will be removed with 1.0.0", ReplaceWith("containsStrictlyNullableEntries(assertionCreator, *otherAssertionCreators)", "ch.tutteli.atrium.api.cc.en_GB.containsStrictlyNullableEntries")) @JvmName("containsStrictly?") @@ -154,7 +148,6 @@ fun > containsStrictlyNulllable(plant: Assert, asse * It is a shortcut for `containsNot.values(expected, *otherExpected)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `containsNot.nullableValues` from package en_GB or `containsNot` from package en_GB in case you do not deal with nullable elements; will be removed with 1.0.0", ReplaceWith("containsNot.nullableValues(expected, *otherExpected)", "ch.tutteli.atrium.api.cc.en_GB.containsNot", "ch.tutteli.atrium.api.cc.en_GB.nullableValues" )) fun > Assert.containsNot(expected: E, vararg otherExpected: E) diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInAnyOrderCreators.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInAnyOrderCreators.kt index 7d731dce68..c584d16ab4 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInAnyOrderCreators.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInAnyOrderCreators.kt @@ -22,7 +22,6 @@ import ch.tutteli.atrium.domain.creating.iterable.contains.searchbehaviours.InAn * @param expected The value which is expected to be contained within the [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.value(expected)")) fun > IterableContains.CheckerOption.value(expected: E): AssertionPlant @@ -54,7 +53,6 @@ fun > value(checkerBuilder: IterableContainsCheckerBuilder> IterableContains.CheckerOption.values(expected: E, vararg otherExpected: E): AssertionPlant @@ -98,7 +96,6 @@ fun > objects(checkerBuilder: IterableContainsCheckerBuilder< * or not. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.entry(assertionCreator)")) fun > IterableContains.CheckerOption.entry(assertionCreator: Assert.() -> Unit): AssertionPlant @@ -121,7 +118,6 @@ fun > entry(checkerBuilder: IterableContainsCheckerBuil * which we are looking for. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.entries(assertionCreator, *otherAssertionCreators)")) fun > IterableContains.CheckerOption.entries( @@ -148,7 +144,6 @@ fun > entries( * @param expected The value which is expected to be contained within the [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.nullableValue(expected)")) fun > IterableContains.CheckerOption.nullableValue(expected: E): AssertionPlant @@ -171,7 +166,6 @@ fun > IterableContains.CheckerOption> IterableContains.CheckerOption.nullableValues(expected: E, vararg otherExpected: E): AssertionPlant @@ -189,7 +183,6 @@ fun > IterableContains.CheckerOption> nullableEntry(checkerBuilder: IterableContainsCh * which we are looking for. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.entries(assertionCreator, *otherAssertionCreators)")) @JvmName("entries?") diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInAnyOrderOnlyCreators.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInAnyOrderOnlyCreators.kt index 745bdfa172..bc99b173c8 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInAnyOrderOnlyCreators.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInAnyOrderOnlyCreators.kt @@ -22,7 +22,6 @@ import ch.tutteli.atrium.domain.creating.iterable.contains.searchbehaviours.InAn * @param expected The value which is expected to be contained within the [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.value(expected)")) fun > IterableContains.Builder.value(expected: E): AssertionPlant @@ -46,7 +45,6 @@ fun > value(checkerBuilder: IterableContainsBuilder> IterableContains.Builder.values(expected: E, vararg otherExpected: E): AssertionPlant @@ -88,7 +86,6 @@ fun > objects(checkerBuilder: IterableContainsBuilder> IterableContains.Builder.entry(assertionCreator: Assert.() -> Unit): AssertionPlant @@ -119,7 +116,6 @@ fun > entry(checkerBuilder: IterableContainsBuilder> IterableContains.Builder.entries( @@ -146,7 +142,6 @@ fun > entries( * @param expected The value which is expected to be contained within the [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.nullableValue(expected)")) fun > IterableContains.Builder.nullableValue(expected: E): AssertionPlant @@ -160,7 +155,6 @@ fun > IterableContains.Builder> IterableContains.Builder.nullableValues(expected: E, vararg otherExpected: E): AssertionPlant @@ -176,7 +170,6 @@ fun > IterableContains.Builder> nullableEntry(checkerBuilder: IterableContainsBu * which we are looking for. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.entries(assertionCreator, *otherAssertionCreators)")) @JvmName("entries?") diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInOrderOnlyCreators.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInOrderOnlyCreators.kt index b28d78ede8..06d309f383 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInOrderOnlyCreators.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/iterableContainsInOrderOnlyCreators.kt @@ -19,7 +19,6 @@ import ch.tutteli.atrium.domain.creating.iterable.contains.searchbehaviours.InOr * @param expected The value which is expected to be contained within the [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.value(expected)")) fun > IterableContains.Builder.value(expected: E): AssertionPlant @@ -43,7 +42,6 @@ fun > value(checkerBuilder: IterableContainsBuilder> IterableContains.Builder.values(expected: E, vararg otherExpected: E): AssertionPlant @@ -85,7 +83,6 @@ fun > objects(checkerBuilder: IterableContainsBuilder> IterableContains.Builder.entry(assertionCreator: Assert.() -> Unit): AssertionPlant @@ -108,7 +105,6 @@ fun > entry(checkerBuilder: IterableContainsBuilder> IterableContains.Builder.entries( @@ -135,7 +131,6 @@ fun > entries( * @param expected The value which is expected to be contained within the [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.nullableValue(expected)")) fun > IterableContains.Builder.nullableValue(expected: E): AssertionPlant @@ -149,7 +144,6 @@ fun > IterableContains.Builder> IterableContains.Builder.nullableValues(expected: E, vararg otherExpected: E): AssertionPlant @@ -164,7 +158,6 @@ fun > IterableContains.Builder> nullableEntry(checkerBuilder: IterableContainsBu * which we are looking for. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.entries(assertionCreator, *otherAssertionCreators)")) @JvmName("entries?") diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/throwableAssertions.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/throwableAssertions.kt index c77bcb30ea..f617360c1e 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/throwableAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/throwableAssertions.kt @@ -17,7 +17,6 @@ import ch.tutteli.atrium.domain.creating.throwable.thrown.ThrowableThrown * If you want to define subsequent assertions on the down-casted [Throwable], then use the overload which expects a * lambda (where you can define subsequent assertions). * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.toThrow()")) inline fun ThrowableThrown.Builder.toThrow() { @@ -32,7 +31,6 @@ inline fun ThrowableThrown.Builder.toThrow() { * assertion (a [Throwable] was thrown) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.toThrow(assertionCreator)")) inline fun ThrowableThrown.Builder.toThrow(noinline assertionCreator: Assert.() -> Unit) { @@ -47,9 +45,6 @@ inline fun ThrowableThrown.Builder.toThrow(noinl * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion [message][Throwable.message] is not null) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. - * - * @throws AssertionError Might throw an [AssertionError] in case [message][Throwable.message] is `null` - * or if an additionally created [Assertion]s (by calling [assertionCreator]) does not hold. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.message(assertionCreator)")) fun Assert.message(assertionCreator: Assert.() -> Unit) { diff --git a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/typeTransformationAssertions.kt b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/typeTransformationAssertions.kt index 864004ab1b..23e984778b 100644 --- a/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/typeTransformationAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/en_UK/typeTransformationAssertions.kt @@ -17,7 +17,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * assertion ([Assert.subject][SubjectProvider.subject] is not null) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.notToBeNull(assertionCreator)")) inline fun AssertionPlantNullable.isNotNull(noinline assertionCreator: Assert.() -> Unit) { @@ -33,7 +32,6 @@ inline fun AssertionPlantNullable.isNotNull(noinline asser * assertion ([Assert.subject][SubjectProvider.subject] *is a* [TSub]) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.en_GB.isA(assertionCreator)")) inline fun Assert.isA(noinline assertionCreator: AssertionPlant.() -> Unit) { diff --git a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/anyAssertions.kt b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/anyAssertions.kt index 5af4dc1f83..79e8771d65 100644 --- a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/anyAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/anyAssertions.kt @@ -17,7 +17,6 @@ import ch.tutteli.atrium.reporting.Reporter * Currently the following is possible: `assert(1).toBe(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.toBe(expected)")) infix fun Assert.toBe(expected: T) @@ -30,7 +29,6 @@ infix fun Assert.toBe(expected: T) * Currently the following is possible: `assert(1).notToBe(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.notToBe(expected)")) infix fun Assert.notToBe(expected: T) @@ -43,7 +41,6 @@ infix fun Assert.notToBe(expected: T) * Currently the following is possible: `assert(1).isSame(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `isSameAs` from package en_GB; will be removed with 1.0.0", ReplaceWith("isSameAs(expected)", "ch.tutteli.atrium.api.cc.infix.en_GB.isSameAs")) infix fun Assert.isSame(expected: T) @@ -56,7 +53,6 @@ infix fun Assert.isSame(expected: T) * Currently the following is possible: `assert(1).isNotSame(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `isNotSameAs` from package en_GB; will be removed with 1.0.0", ReplaceWith("isNotSameAs(expected)", "ch.tutteli.atrium.api.cc.infix.en_GB.isNotSameAs")) infix fun Assert.isNotSame(expected: T) @@ -68,7 +64,6 @@ infix fun Assert.isNotSame(expected: T) * @param null Has to be `null`. * * @return Does not support a fluent API because: what else would you want to assert about `null` anyway? - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.toBe(null)")) infix fun AssertionPlantNullable.toBe(@Suppress("UNUSED_PARAMETER") `null`: Nothing?) { diff --git a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/bigDecimalAssertions.kt b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/bigDecimalAssertions.kt index c5ca0d275d..d74287ddda 100644 --- a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/bigDecimalAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/bigDecimalAssertions.kt @@ -40,7 +40,6 @@ infix fun Assert.notToBe(expected: T): Nothing * - `assert(BigDecimal("10")) isNumericallyEqualTo BigDecimal("10.0")` holds. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.isNumericallyEqualTo(expected)")) infix fun Assert.isNumericallyEqualTo(expected: T) @@ -58,7 +57,6 @@ infix fun Assert.isNumericallyEqualTo(expected: T) * - `assert(BigDecimal("10")) isNotNumericallyEqualTo BigDecimal("10.0")` does not hold. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.isNotNumericallyEqualTo(expected)")) infix fun Assert.isNotNumericallyEqualTo(expected: T) @@ -75,7 +73,6 @@ infix fun Assert.isNotNumericallyEqualTo(expected: T) * - `assert(BigDecimal("10")) isNumericallyEqualTo BigDecimal("10.0")` holds. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.v(expected)")) infix fun Assert.isEqualIncludingScale(expected: T) @@ -91,7 +88,6 @@ infix fun Assert.isEqualIncludingScale(expected: T) * - `assert(BigDecimal("10")) isNotNumericallyEqualTo BigDecimal("10.0")` does not hold. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.isNotEqualIncludingScale(expected)")) infix fun Assert.isNotEqualIncludingScale(expected: T) diff --git a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/charSequenceAssertions.kt b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/charSequenceAssertions.kt index 3001a6dedb..90dc8c7bb1 100644 --- a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/charSequenceAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/charSequenceAssertions.kt @@ -59,7 +59,6 @@ fun notTo(plant: Assert, @Suppress("UNUSED_PARAMETER") con * By non disjoint is meant that `'aa'` in `'aaaa'` is found three times and not only two times. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.contains(expected)")) @@ -88,7 +87,6 @@ infix fun Assert.contains(expected: Any): AssertionPlant Assert.contains(values: Values): AssertionP * It is a shortcut for `to contain atLeast 1 defaultTranslationOf translatable)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.containsDefaultTranslationOf(translatable)")) infix fun Assert.containsDefaultTranslationOf(translatable: Translatable): AssertionPlant @@ -129,7 +126,6 @@ infix fun Assert.containsDefaultTranslationOf(translatable * `to contain atLeast 1 the DefaultTranslationOf(IS, IS)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.contains(defaultTranslationOf)")) infix fun Assert.contains(defaultTranslationOf: DefaultTranslationsOf): AssertionPlant @@ -141,7 +137,6 @@ infix fun Assert.contains(defaultTranslationOf: DefaultTra * It is a shortcut for `to contain atLeast 1 regex pattern`. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.containsRegex(pattern)")) infix fun Assert.containsRegex(pattern: String): AssertionPlant @@ -167,7 +162,6 @@ infix fun Assert.containsRegex(pattern: String): Assertion * @param patterns The patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.contains(patterns)")) infix fun Assert.contains(patterns: RegexPatterns): AssertionPlant @@ -179,7 +173,6 @@ infix fun Assert.contains(patterns: RegexPatterns): Assert * Delegates to [containsNot] [Values]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.containsNot(expected)")) infix fun Assert.containsNot(expected: Any) @@ -192,7 +185,6 @@ infix fun Assert.containsNot(expected: Any) * It is a shortcut for `notTo contain the Values(expected, *otherExpected)`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.containsNot(values)")) infix fun Assert.containsNot(values: Values) @@ -207,7 +199,6 @@ infix fun Assert.containsNot(values: Values) * It is a shortcut for `notTo contain the DefaultTranslationsOf(expected, *otherExpected)`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.containsNot(defaultTranslationsOf)")) infix fun Assert.containsNot(defaultTranslationsOf: DefaultTranslationsOf) @@ -218,7 +209,6 @@ infix fun Assert.containsNot(defaultTranslationsOf: Defaul * Makes the assertion that the [Assert.subject][SubjectProvider.subject] starts with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.startsWith(expected)")) infix fun Assert.startsWith(expected: CharSequence) @@ -228,7 +218,6 @@ infix fun Assert.startsWith(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not start with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.startsNotWith(expected)")) infix fun Assert.startsNotWith(expected: CharSequence) @@ -239,7 +228,6 @@ infix fun Assert.startsNotWith(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] ends with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.endsWith(expected)")) infix fun Assert.endsWith(expected: CharSequence) @@ -249,7 +237,6 @@ infix fun Assert.endsWith(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not end with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.endsNotWith(expected)")) infix fun Assert.endsNotWith(expected: CharSequence) @@ -262,7 +249,6 @@ infix fun Assert.endsNotWith(expected: CharSequence) * @param Empty Has to be `Empty`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.toBe(Empty)")) infix fun Assert.toBe(@Suppress("UNUSED_PARAMETER") Empty: Empty) @@ -274,7 +260,6 @@ infix fun Assert.toBe(@Suppress("UNUSED_PARAMETER") Empty: * @param onlyEmptyAllowed Has to be `Empty`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.notToBe(Empty)")) infix fun Assert.notToBe(@Suppress("UNUSED_PARAMETER") onlyEmptyAllowed: Empty) diff --git a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/charSequenceContainsCreators.kt b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/charSequenceContainsCreators.kt index ca423284f9..78bf0aa480 100644 --- a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/charSequenceContainsCreators.kt +++ b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/charSequenceContainsCreators.kt @@ -25,7 +25,6 @@ import ch.tutteli.atrium.reporting.translating.Translatable * @param expected The object which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.value(expected)")) @@ -53,7 +52,6 @@ infix fun CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption.defaultTranslationOf(translatable: Translatable): AssertionPlant @@ -145,7 +140,6 @@ infix fun CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption.the(translatables: DefaultTranslationsOf): AssertionPlant @@ -161,7 +155,6 @@ infix fun CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption.regex(pattern: String): AssertionPlant @@ -227,7 +218,6 @@ infix fun CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption.the(patterns: RegexPatterns): AssertionPlant @@ -243,7 +233,6 @@ infix fun CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption> Assert.hasSize(size: Int) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is an empty [Collection]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.toBe(Empty)")) infix fun > Assert.toBe(@Suppress("UNUSED_PARAMETER") Empty: Empty) @@ -31,7 +29,6 @@ infix fun > Assert.toBe(@Suppress("UNUSED_PARAMETER") Empty * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is not an empty [Collection]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.notToBe(Empty)")) infix fun > Assert.notToBe(@Suppress("UNUSED_PARAMETER") Empty: Empty) diff --git a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/comparableAssertions.kt b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/comparableAssertions.kt index c0ef0feab6..2fb8c79c6d 100644 --- a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/comparableAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/comparableAssertions.kt @@ -10,7 +10,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is less than [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.isLessThan(expected)")) infix fun > Assert.isLessThan(expected: T) @@ -20,7 +19,6 @@ infix fun > Assert.isLessThan(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is less than or equals [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.isLessOrEquals(expected)")) infix fun > Assert.isLessOrEquals(expected: T) @@ -30,7 +28,6 @@ infix fun > Assert.isLessOrEquals(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is greater than [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.isGreaterThan(expected)")) infix fun > Assert.isGreaterThan(expected: T) @@ -40,7 +37,6 @@ infix fun > Assert.isGreaterThan(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is greater than or equals [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.isGreaterOrEquals(expected)")) infix fun > Assert.isGreaterOrEquals(expected: T) diff --git a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/featureAssertions.kt b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/featureAssertions.kt index 0828106033..4608f18025 100644 --- a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/featureAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/featureAssertions.kt @@ -28,9 +28,6 @@ fun Assert.property(property: KProperty0 Assert.property(property: KProperty0, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -64,9 +61,6 @@ fun Assert.returnValueOf(method: KFunction0 Assert.returnValueOf(method: KFunction0, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -101,9 +95,6 @@ fun Assert.returnValueOf(method: KFu * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.returnValueOf(method, arg1, assertionCreator)")) fun Assert.returnValueOf(method: KFunction1, arg1: T1, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -138,9 +129,6 @@ fun Assert.returnValueOf( * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.returnValueOf(method, arg1, arg2, assertionCreator)")) fun Assert.returnValueOf(method: KFunction2, arg1: T1, arg2: T2, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -176,9 +164,6 @@ fun Assert.ret * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.returnValueOf(method, arg1, arg2, arg3, assertionCreator)")) fun Assert.returnValueOf(method: KFunction3, arg1: T1, arg2: T2, arg3: T3, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -213,9 +198,6 @@ fun As * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.returnValueOf(method, arg1, arg2, arg3, arg4, assertionCreator)")) fun Assert.returnValueOf(method: KFunction4, arg1: T1, arg2: T2, arg3: T3, arg4: T4, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant @@ -250,9 +232,6 @@ fun Assert.returnValueOf(method: KFunction5, arg1: T1, arg2: T2, arg3: T3, arg4: T4, arg5: T5, assertionCreator: AssertionPlant.() -> Unit): AssertionPlant diff --git a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableAssertions.kt b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableAssertions.kt index cf678bd4e9..ba98ac8ef4 100644 --- a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableAssertions.kt @@ -50,7 +50,6 @@ fun > notTo(plant: Assert, @Suppress("UNUSED_PARAMETER") c * It is a shortcut for `to contain inAny order atLeast 1 value expected` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `contains NullableValue` from package en_GB or `contains` from package en_GB in case you do not deal with nullable elements; will be removed with 1.0.0", ReplaceWith("this contains NullableValue(expected)", "ch.tutteli.atrium.api.cc.infix.en_GB.contains", "ch.tutteli.atrium.api.cc.infix.en_GB.NullableValue")) infix fun > Assert.contains(expected: E) @@ -72,7 +71,6 @@ infix fun > Assert.contains(expected: E) * `contains Values('a', 'a')` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `contains NullableValues` from package en_GB or `contains Values` from package en_GB in case you do not deal with nullable elements; will be removed with 1.0.0", ReplaceWith("this contains NullableValues(values.expected, *values.otherExpected)", "ch.tutteli.atrium.api.cc.infix.en_GB.contains", "ch.tutteli.atrium.api.cc.infix.en_GB.NullableValues")) infix fun > Assert.contains(values: Values): AssertionPlant @@ -93,7 +91,6 @@ infix fun > Assert.contains(values: Values): AssertionP * `contains Objects('a', 'a')` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Will be removed with 1.0.0 because it is redundant in terms of `contains Values(expected, otherExpected)` without adding enough to be a legit alternative.", ReplaceWith("this contains Values(objects)")) infix fun > Assert.contains(objects: Objects): AssertionPlant @@ -106,7 +103,6 @@ infix fun > Assert.contains(objects: Objects): Assertio * It is a shortcut for `to contain inAny order atLeast 1 entry { ... }` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.contains(assertionCreator)")) infix fun > Assert.contains(assertionCreator: Assert.() -> Unit): AssertionPlant @@ -120,7 +116,6 @@ infix fun > Assert.contains(assertionCreator: Assert * It is a shortcut for `to contain inAny order atLeast 1 the Entries(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.contains(entries)")) infix fun > Assert.contains(entries: Entries.() -> Unit>): AssertionPlant @@ -133,7 +128,6 @@ infix fun > Assert.contains(entries: Entries> containsNullable(plant: Assert, assertionCrea * It is a shortcut for `to contain inAny order atLeast 1 the Entries(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `contains NullableEntries` from package en_GB; will be removed with 1.0.0", ReplaceWith("this contains NullableEntries(entries.assertionCreator, *entries.otherAssertionCreators)", "ch.tutteli.atrium.api.cc.infix.en_GB.contains", "ch.tutteli.atrium.api.cc.infix.en_GB.NullableEntries")) @JvmName("containsDeprecated") @@ -171,7 +164,6 @@ fun > containsNullable(plant: Assert, entries: Entr * It is a shortcut for `to contain inGiven order but only value expected` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `containsStrictly NullableValue` from package en_GB or `containsStrictly` from package en_GB in case you do not deal with nullable elements; will be removed with 1.0.0", ReplaceWith("this contains NullableValue(expected)", "ch.tutteli.atrium.api.cc.infix.en_GB.containsStrictly", "ch.tutteli.atrium.api.cc.infix.en_GB.NullableValue")) infix fun > Assert.containsStrictly(expected: E): AssertionPlant @@ -183,7 +175,6 @@ infix fun > Assert.containsStrictly(expected: E): Assertio * It is a shortcut for `to contain inGiven order but only the Values(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `containsStrictly NullableValues` from package en_GB or `containsStrictly` from package en_GB in case you do not deal with nullable elements; will be removed with 1.0.0", ReplaceWith("this contains NullableValues(value.expected, *value.otherExpected)", "ch.tutteli.atrium.api.cc.infix.en_GB.containsStrictly", "ch.tutteli.atrium.api.cc.infix.en_GB.NullableValues")) infix fun > Assert.containsStrictly(values: Values): AssertionPlant @@ -195,7 +186,6 @@ infix fun > Assert.containsStrictly(values: Values): As * It is a shortcut for `to contain inGiven order but only the Objects(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Will be removed with 1.0.0 because it is redundant in terms of `containsStrictly Values(expected, otherExpected)` without adding enough to be a legit alternative.", ReplaceWith("this containsStrictly Values(objects)")) infix fun > Assert.containsStrictly(objects: Objects): AssertionPlant @@ -208,7 +198,6 @@ infix fun > Assert.containsStrictly(objects: Objects): * It is a shortcut for `to contain inAny order atLeast 1 entry { ... }` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.containsStrictly(assertionCreator)")) infix fun > Assert.containsStrictly(assertionCreator: Assert.() -> Unit): AssertionPlant @@ -222,7 +211,6 @@ infix fun > Assert.containsStrictly(assertionCreator * It is a shortcut for `to contain inGiven order but only the Entries(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.containsStrictly(entries)")) infix fun > Assert.containsStrictly(entries: Entries.() -> Unit>): AssertionPlant @@ -235,7 +223,6 @@ infix fun > Assert.containsStrictly(entries: Entries * It is a shortcut for `to contain inAny order atLeast 1 entry { ... }` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `contains NullableEntry` from package en_GB; will be removed with 1.0.0", ReplaceWith("this contains NullableEntry(expected)", "ch.tutteli.atrium.api.cc.infix.en_GB.contains", "ch.tutteli.atrium.api.cc.infix.en_GB.NullableEntry")) @JvmName("containsStrictly?") @@ -255,7 +242,6 @@ fun > containsStrictlyNullable(plant: Assert, asser * It is a shortcut for `to contain inGiven order but only the Entries(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `containsStrictly NullableEntries` from package en_GB; will be removed with 1.0.0", ReplaceWith("this containsStrictly NullableEntries(entries.assertionCreator, *entries.otherAssertionCreators)", "ch.tutteli.atrium.api.cc.infix.en_GB.containsStrictly", "ch.tutteli.atrium.api.cc.infix.en_GB.NullableEntries")) @JvmName("containsStrictly?") @@ -272,7 +258,6 @@ fun > containsStrictlyNullable(plant: Assert, entri * Delegates to `containsNot Values(expected)`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.containsNot(expected)")) infix fun > Assert.containsNot(expected: E): AssertionPlant @@ -284,7 +269,6 @@ infix fun > Assert.containsNot(expected: E): AssertionPlan * It is a shortcut for `notTo contain the Values(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use `notTo contain the NullableValues` from package en_GB or `containsNot` from package en_GB in case you do not deal with nullable elements; will be removed with 1.0.0", ReplaceWith("notTo contain the NullableValues(values.expected, *values.otherExpected)", "ch.tutteli.atrium.api.cc.infix.en_GB.notTo", "ch.tutteli.atrium.api.cc.infix.en_GB.keywords.contain", "ch.tutteli.atrium.api.cc.infix.en_GB.the", "ch.tutteli.atrium.api.cc.infix.en_GB.NullableValues")) infix fun > Assert.containsNot(values: Values): AssertionPlant @@ -296,7 +280,6 @@ infix fun > Assert.containsNot(values: Values): Asserti * It is a shortcut for `notTo contain the Objects(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Will be removed with 1.0.0 because it is redundant in terms of `containsNot Values(expected, otherExpected)` without adding enough to be a legit alternative.", ReplaceWith("this containsNot Values(objects)")) infix fun > Assert.containsNot(objects: Objects) diff --git a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableContainsInAnyOrderCreators.kt b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableContainsInAnyOrderCreators.kt index 4a72f4c479..a711997f3d 100644 --- a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableContainsInAnyOrderCreators.kt +++ b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableContainsInAnyOrderCreators.kt @@ -21,7 +21,6 @@ import ch.tutteli.atrium.domain.creating.iterable.contains.searchbehaviours.InAn * @param expected The value which is expected to be contained within the [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.value(expected)")) infix fun > IterableContains.CheckerOption.value(expected: E): AssertionPlant @@ -49,7 +48,6 @@ fun > value(checkerBuilder: IterableContainsCheckerBuilder> IterableContains.CheckerOption.the(values: Values): AssertionPlant @@ -88,7 +86,6 @@ fun > the(checkerBuilder: IterableContainsCheckerBuilder> IterableContains.CheckerOption.entry(assertionCreator: Assert.() -> Unit): AssertionPlant @@ -107,7 +104,6 @@ fun > entry(checkerBuilder: IterableContainsCheckerBuil * @param entries The parameter object which contains the identification lambdas. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.the(entries)")) infix fun > IterableContains.CheckerOption.the(entries: Entries.() -> Unit>): AssertionPlant @@ -129,7 +125,6 @@ fun > the(checkerBuilder: IterableContainsCheckerBuilde * or not. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.entry(assertionCreator)")) @JvmName("entry?") @@ -149,7 +144,6 @@ fun > nullableEntry(checkerBuilder: IterableContainsCh * @param entries The parameter object which contains the identification lambdas. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.the(entries)")) @JvmName("entries?") diff --git a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableContainsInAnyOrderOnlyCreators.kt b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableContainsInAnyOrderOnlyCreators.kt index d59b9215e5..139edc2e4d 100644 --- a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableContainsInAnyOrderOnlyCreators.kt +++ b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/iterableContainsInAnyOrderOnlyCreators.kt @@ -21,7 +21,6 @@ import ch.tutteli.atrium.domain.creating.iterable.contains.searchbehaviours.InAn * @param expected The value which is expected to be contained within the [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.value(expected)")) infix fun > IterableContains.Builder.value(expected: E): AssertionPlant @@ -41,7 +40,6 @@ fun > value(builder: IterableContainsBuilder> IterableContains.Builder.the(values: Values): AssertionPlant @@ -78,7 +76,6 @@ fun > the(builder: IterableContainsBuilder> IterableContains.Builder.entry(assertionCreator: Assert.() -> Unit): AssertionPlant @@ -105,7 +102,6 @@ fun > entry(builder: IterableContainsBuilder> IterableContains.Builder.the(entries: Entries.() -> Unit>): AssertionPlant @@ -125,7 +121,6 @@ fun > the(builder: IterableContainsBuilder> nullableEntry(builder: IterableContainsBuilder> IterableContains.Builder.value(expected: E): AssertionPlant @@ -33,7 +32,6 @@ infix fun > IterableContains.Builder> IterableContains.Builder.the(values: Values): AssertionPlant @@ -70,7 +68,6 @@ fun > the(builder: IterableContainsBuilder> IterableContains.Builder.entry(assertionCreator: Assert.() -> Unit): AssertionPlant @@ -89,7 +86,6 @@ fun > entry(builder: IterableContainsBuilder> IterableContains.Builder.the(entries: Entries.() -> Unit>): AssertionPlant @@ -109,7 +105,6 @@ fun > the(builder: IterableContainsBuilder> nullableEntry(builder: IterableContainsBuilder ThrowableThrown.Builder.toThrow() { @@ -32,7 +31,6 @@ inline fun ThrowableThrown.Builder.toThrow() { * assertion (a [Throwable] was thrown) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.toThrow(assertionCreator)")) inline infix fun ThrowableThrown.Builder.toThrow(noinline assertionCreator: Assert.() -> Unit) { @@ -47,9 +45,6 @@ inline infix fun ThrowableThrown.Builder.toThrow * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion [message][Throwable.message] is not null) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. - * - * @throws AssertionError Might throw an [AssertionError] in case [message][Throwable.message] is `null` - * or if an additionally created [Assertion]s (by calling [assertionCreator]) does not hold. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.message(assertionCreator)")) infix fun Assert.message(assertionCreator: Assert.() -> Unit) { diff --git a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/typeTransformationAssertions.kt b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/typeTransformationAssertions.kt index b639d34bef..c0faec95b6 100644 --- a/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/typeTransformationAssertions.kt +++ b/misc/deprecated/apis/atrium-api-cc-infix-en_UK/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_UK/typeTransformationAssertions.kt @@ -17,7 +17,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * assertion ([Assert.subject][SubjectProvider.subject] is not null) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.notToBeNull(assertionCreator)")) inline infix fun AssertionPlantNullable.notToBeNull(noinline assertionCreator: Assert.() -> Unit) { @@ -33,7 +32,6 @@ inline infix fun AssertionPlantNullable.notToBeNull(noinli * assertion ([Assert.subject][SubjectProvider.subject] *is a* [TSub]) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Use pendant from package en_GB; will be removed with 1.0.0", ReplaceWith("ch.tutteli.atrium.api.cc.infix.en_GB.isA(assertionCreator)")) inline infix fun Assert.isA(noinline assertionCreator: AssertionPlant.() -> Unit) { diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/anyAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/anyAssertions.kt index 4d511d1d7d..b9ebdf76a1 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/anyAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/anyAssertions.kt @@ -22,7 +22,6 @@ import kotlin.jvm.JvmName * Currently the following is possible: `esGilt(1).ist(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.ist(expected: T) @@ -35,7 +34,6 @@ fun Assert.ist(expected: T) * Currently the following is possible: `esGilt(1).istNicht(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istNicht(expected: T) @@ -48,7 +46,6 @@ fun Assert.istNicht(expected: T) * Currently the following is possible: `esGilt(1).istSelbeInstanzWie(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istSelbeInstanzWie(expected: T) @@ -61,7 +58,6 @@ fun Assert.istSelbeInstanzWie(expected: T) * Currently the following is possible: `esGilt(1).istNichtSelbeInstanzWie(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istNichtSelbeInstanzWie(expected: T) @@ -72,7 +68,6 @@ fun Assert.istNichtSelbeInstanzWie(expected: T) * * @return Does not support a fluent API because: what else would you want to assert about `null` anyway? * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") @@ -91,7 +86,6 @@ inline fun AssertionPlantNullable.ist(expected: T?) { * ``` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceAssertions.kt index 2e7fe47fb9..db4ee550c6 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceAssertions.kt @@ -59,7 +59,6 @@ val Assert.enthaeltNicht: NotCheckerOption Assert.enthaelt(expected: Any, vararg otherExpected: A * function expects `Any` for your convenience, so that you can mix [String] and [Int] for instance). * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.enthaeltNicht(expected: Any, vararg otherExpected: Any) @@ -104,7 +102,6 @@ fun Assert.enthaeltNicht(expected: Any, vararg otherExpect * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.enthaeltRegex( @@ -116,7 +113,6 @@ fun Assert.enthaeltRegex( * Makes the assertion that the [Assert.subject][SubjectProvider.subject] starts with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.beginntMit(expected: CharSequence) @@ -126,7 +122,6 @@ fun Assert.beginntMit(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not start with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.beginntNichtMit(expected: CharSequence) @@ -137,7 +132,6 @@ fun Assert.beginntNichtMit(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] ends with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.endetMit(expected: CharSequence) @@ -147,7 +141,6 @@ fun Assert.endetMit(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not end with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.endetNichtMit(expected: CharSequence) @@ -158,7 +151,6 @@ fun Assert.endetNichtMit(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] [CharSequence].[kotlin.text.isEmpty]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istLeer() @@ -168,7 +160,6 @@ fun Assert.istLeer() * Makes the assertion that the [Assert.subject][SubjectProvider.subject] [CharSequence].[kotlin.text.isNotEmpty]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istNichtLeer() @@ -178,7 +169,6 @@ fun Assert.istNichtLeer() * Makes the assertion that the [Assert.subject][SubjectProvider.subject] [CharSequence].[kotlin.text.isNotBlank]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istNichtBlank() diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceContainsCreators.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceContainsCreators.kt index 0711f78700..e65679eaee 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceContainsCreators.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceContainsCreators.kt @@ -28,7 +28,6 @@ import kotlin.jvm.JvmName * @param expected The value which is expected to be contained within the input of the search. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @@ -51,7 +50,6 @@ fun CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.Builder CharSequenceContains.Builder CharSequenceContains.CheckerOption.regex(pattern: String, vararg otherPatterns: String): AssertionPlant @@ -198,7 +191,6 @@ fun CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.Builder.regex(pattern: String, vararg otherPatterns: String): AssertionPlant diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/collectionAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/collectionAssertions.kt index f476c623f9..72686f4a91 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/collectionAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/collectionAssertions.kt @@ -15,7 +15,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * Shortcut for `size.ist(expectedSize)` depends on the underlying implementation though. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") @@ -26,7 +25,6 @@ fun > Assert.hatDieGroesse(size: Int) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is an empty [Collection]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.istLeer() @@ -36,7 +34,6 @@ fun > Assert.istLeer() * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is not an empty [Collection]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.istNichtLeer() @@ -59,8 +56,6 @@ val Assert>.size get(): Assert = property(Collection<*>::size * holds all assertions the given [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/comparableAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/comparableAssertions.kt index 1bad294ebb..964e4371b8 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/comparableAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/comparableAssertions.kt @@ -11,7 +11,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is less than [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.istKleinerAls(expected: T) @@ -21,7 +20,6 @@ fun > Assert.istKleinerAls(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is less than or equals [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.istKleinerOderGleich(expected: T) @@ -31,7 +29,6 @@ fun > Assert.istKleinerOderGleich(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is greater than [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.istGroesserAls(expected: T) @@ -41,7 +38,6 @@ fun > Assert.istGroesserAls(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is greater than or equals [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.istGroesserOderGleich(expected: T) diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/featureAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/featureAssertions.kt index a5afaf77c9..1486f12fb2 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/featureAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/featureAssertions.kt @@ -44,9 +44,6 @@ fun Assert.property(property: KProperty1 Assert.property(property: KProperty0, assertionCreator: Assert.() -> Unit): AssertionPlant @@ -63,9 +60,6 @@ fun CollectingAssertionPlant.property(property: KP * starting with a group consisting of the [Assertion]s created by the [assertionCreator] lambda. * * @return An [AssertionPlant] for the given [property]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.property(property: KProperty1, assertionCreator: Assert.() -> Unit): AssertionPlant @@ -133,9 +127,6 @@ fun Assert.rueckgabewertVon(method: KFunction1): Ass * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.rueckgabewertVon(method: KFunction0, assertionCreator: Assert.() -> Unit): AssertionPlant @@ -153,9 +144,6 @@ fun CollectingAssertionPlant.rueckgabewertVon(method: KFun * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @JvmName("sicherRueckgabewertVon") @@ -230,9 +218,6 @@ fun Assert.rueckgabewertVon(method: KFunction2 Assert.rueckgabewertVon(method: KFunction1, arg1: T1, assertionCreator: Assert.() -> Unit): AssertionPlant @@ -250,9 +235,6 @@ fun CollectingAssertionPlant.rueckgabewertVon(method: * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @JvmName("sicherRueckgabewertVon") @@ -327,9 +309,6 @@ fun Assert.rueckgabewertVon(method: KFunction3 Assert.rueckgabewertVon(method: KFunction2, arg1: T1, arg2: T2, assertionCreator: Assert.() -> Unit): AssertionPlant @@ -347,9 +326,6 @@ fun CollectingAssertionPlant.rueckgabewertVon(meth * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @JvmName("sicherRueckgabewertVon") @@ -424,9 +400,6 @@ fun Assert.rueckgabewertVon(method: KFunction4 * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.rueckgabewertVon(method: KFunction3, arg1: T1, arg2: T2, arg3: T3, assertionCreator: Assert.() -> Unit): AssertionPlant @@ -444,9 +417,6 @@ fun CollectingAssertionPlant.rueckgabewertVon( * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @JvmName("sicherRueckgabewertVon") @@ -521,9 +491,6 @@ fun Assert.rueckgabewertVon(method: KFunct * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.rueckgabewertVon(method: KFunction4, arg1: T1, arg2: T2, arg3: T3, arg4: T4, assertionCreator: Assert.() -> Unit): AssertionPlant @@ -541,9 +508,6 @@ fun CollectingAssertionPlant.rueckgabewert * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @JvmName("sicherRueckgabewertVon") @@ -618,9 +582,6 @@ fun Assert.rueckgabewertVon(method: KF * by the [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.rueckgabewertVon(method: KFunction5, arg1: T1, arg2: T2, arg3: T3, arg4: T4, arg5: T5, assertionCreator: Assert.() -> Unit): AssertionPlant @@ -638,9 +599,6 @@ fun CollectingAssertionPlant.rueckgabe * by the [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @JvmName("sicherRueckgabewertVon") diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/floatingPointAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/floatingPointAssertions.kt index aebe86a05f..5d617fa056 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/floatingPointAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/floatingPointAssertions.kt @@ -23,7 +23,6 @@ import kotlin.jvm.JvmName * | [Assert.subject][SubjectProvider.subject] - [expected] | ≤ [tolerance] * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istMitFehlerToleranz(expected: Float, tolerance: Float) @@ -40,7 +39,6 @@ fun Assert.istMitFehlerToleranz(expected: Float, tolerance: Float) * | [Assert.subject][SubjectProvider.subject] - [expected] | ≤ [tolerance] * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istMitFehlerToleranz(expected: Double, tolerance: Double) diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/iterableAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/iterableAssertions.kt index e7979c3e7b..cc6eb9435c 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/iterableAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/iterableAssertions.kt @@ -53,7 +53,6 @@ val > Assert.enthaeltNicht: NotCheckerOption> Assert.enthaelt(expected: E, vararg otherExpected: E): AssertionPlant @@ -67,7 +66,6 @@ fun > Assert.enthaelt(expected: E, vararg otherExpected: E) * It is a shortcut for `enthaelt.inBeliebigerReihenfolge.zumindest(1).eintrag(assertionCreatorOrNull)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.enthaelt(assertionCreatorOrNull: (Assert.() -> Unit)?): AssertionPlant @@ -82,7 +80,6 @@ fun > Assert.enthaelt(assertionCreatorOrNull: (Assert * It is a shortcut for `enthaelt.inBeliebigerReihenfolge.zumindest(1).eintraege(assertionCreatorOrNull, *otherAssertionCreatorsOrNulls)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.enthaelt(assertionCreatorOrNull: (Assert.() -> Unit)?, vararg otherAssertionCreatorsOrNulls: (Assert.() -> Unit)?): AssertionPlant @@ -96,7 +93,6 @@ fun > Assert.enthaelt(assertionCreatorOrNull: (Assert * It is a shortcut for `enthaelt.inGegebenerReihenfolge.nur.werte(expected, *otherExpected)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.enthaeltExakt(expected: E, vararg otherExpected: E): AssertionPlant @@ -110,7 +106,6 @@ fun > Assert.enthaeltExakt(expected: E, vararg otherExpec * It is a shortcut for `enthaelt.inGegebenerReihenfolge.nur.eintrag(assertionCreatorOrNull)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.enthaeltExakt(assertionCreatorOrNull: (Assert.() -> Unit)?): AssertionPlant @@ -125,7 +120,6 @@ fun > Assert.enthaeltExakt(assertionCreatorOrNull: * It is a shortcut for `enthaelt.inGegebenerReihenfolge.nur.eintraege(assertionCreatorOrNull, *otherAssertionCreatorsOrNulls)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.enthaeltExakt(assertionCreatorOrNull: (Assert.() -> Unit)?, vararg otherAssertionCreatorsOrNulls: (Assert.() -> Unit)?): AssertionPlant @@ -139,7 +133,6 @@ fun > Assert.enthaeltExakt(assertionCreatorOrNull: * It is a shortcut for `enthaeltNicht.werte(expected, *otherExpected)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.enthaeltNicht(expected: E, vararg otherExpected: E) @@ -153,7 +146,6 @@ fun > Assert.enthaeltNicht(expected: E, vararg otherExpect * It is a shortcut for `enthaelt.inBeliebigerReihenfolge.zumindest(1).eintrag(assertionCreatorOrNull)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.irgendEiner(assertionCreatorOrNull: (Assert.() -> Unit)?): AssertionPlant @@ -167,7 +159,6 @@ fun > Assert.irgendEiner(assertionCreatorOrNull: (Ass * It is a shortcut for `enthaeltNicht.eintrag(assertionCreatorOrNull)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.keiner(assertionCreatorOrNull: (Assert.() -> Unit)?) @@ -179,7 +170,6 @@ fun > Assert.keiner(assertionCreatorOrNull: (Assert * in case [assertionCreatorOrNull] is defined as `null`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.alle(assertionCreatorOrNull: (Assert.() -> Unit)?) diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/iterableContainsInAnyOrderCreators.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/iterableContainsInAnyOrderCreators.kt index c50189e1d9..f84277c006 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/iterableContainsInAnyOrderCreators.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/iterableContainsInAnyOrderCreators.kt @@ -26,7 +26,6 @@ import kotlin.jvm.JvmName * @param expected The value which is expected to be contained within the [Iterable]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > IterableContains.CheckerOption.wert(expected: E): AssertionPlant @@ -51,7 +50,6 @@ fun > IterableContains.CheckerOption> IterableContains.CheckerOption.werte(expected: E, vararg otherExpected: E): AssertionPlant @@ -69,7 +67,6 @@ fun > IterableContains.CheckerOption> IterableContains.CheckerOption.eintrag(assertionCreatorOrNull: (Assert.() -> Unit)?): AssertionPlant @@ -88,7 +85,6 @@ fun > IterableContains.CheckerOption> IterableContains.Builder.wert(expected: E): AssertionPlant @@ -42,7 +41,6 @@ fun > IterableContains.Builder> IterableContains.Builder.werte(expected: E, vararg otherExpected: E): AssertionPlant @@ -58,7 +56,6 @@ fun > IterableContains.Builder> IterableContains.Builder.eintrag(assertionCreatorOrNull: (Assert.() -> Unit)?): AssertionPlant @@ -86,7 +83,6 @@ fun > IterableContains.Builder> IterableContains.Builder.wert(expected: E): AssertionPlant @@ -39,7 +38,6 @@ fun > IterableContains.Builder> IterableContains.Builder.werte(expected: E, vararg otherExpected: E): AssertionPlant @@ -55,7 +53,6 @@ fun > IterableContains.Builder> IterableContains.Builder.eintrag(assertionCreatorOrNull: (Assert.() -> Unit)?): AssertionPlant @@ -74,7 +71,6 @@ fun > IterableContains.Builder> IterableContains.Builder.inBeliebigerReihenfolge( @@ -55,7 +54,6 @@ fun > IterableContains.Builder> Assert.get(index: Int): Assert * the corresponding element holds all assertions the given [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @@ -40,7 +37,6 @@ fun > Assert.get(index: Int, assertionCreator: Assert.( * creates a feature assertion plant for the corresponding nullable element and returns the newly created plant. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the given [index] is out of bound. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/mapAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/mapAssertions.kt index bee63efb5e..e959294c53 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/mapAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/mapAssertions.kt @@ -22,7 +22,6 @@ import kotlin.js.JsName * even though they match the same entry. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") @@ -41,7 +40,6 @@ fun > Assert.enthaelt(entry: Pair, vararg otherE * , then both match, even though they match the same entry. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") @@ -55,7 +53,6 @@ fun > Assert.enthaelt( * Makes the assertion that the [Assert.subject][SubjectProvider.subject] contains the given [key]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert>.enthaeltKey(key: K) @@ -65,7 +62,6 @@ fun Assert>.enthaeltKey(key: K) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not contain the given [key]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert>.enthaeltNichtKey(key: K) @@ -77,7 +73,6 @@ fun Assert>.enthaeltNichtKey(key: K) * assertion plant for corresponding value and returns the newly created plant. * * @return The newly created plant for the feature - * @throws AssertionError Might throw an [AssertionError] if the given [key] does not exist. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") @@ -90,8 +85,6 @@ fun > Assert.getExistierend(key: K): Assert * holds all assertions the given [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @@ -105,7 +98,6 @@ fun > Assert.getExistierend(key: K, assertionCrea * assertion plant for corresponding nullable value and returns the newly created plant. * * @return The newly created plant for the feature - * @throws AssertionError Might throw an [AssertionError] if the given [key] does not exist. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") @@ -117,7 +109,6 @@ fun > Assert.getExistierend(key: K): AssertionPlantNul * Makes the assertion that the [Assert.subject][SubjectProvider.subject]'s [Map.size] is [size]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") @@ -128,7 +119,6 @@ fun > Assert.hatDieGroesse(size: Int) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is an empty [Map]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.istLeer() @@ -138,7 +128,6 @@ fun > Assert.istLeer() * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is not an empty [Map]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun > Assert.istNichtLeer() @@ -161,8 +150,6 @@ val Assert>.keys get() : Assert> = property(Map Assert>.values get() : Assert> = property * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/mapEntryAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/mapEntryAssertions.kt index 8b99a9ddd6..35c9bd1bd5 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/mapEntryAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/mapEntryAssertions.kt @@ -18,7 +18,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * if the assertion about the key fails. Moreover, it might be that reporting differs compared to using the long form. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") @@ -55,8 +54,6 @@ val Assert>.key get() : AssertionPlantNullable = property * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @@ -95,8 +92,6 @@ val Assert>.value get() : AssertionPlantNullable = proper * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/pairAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/pairAssertions.kt index a83904b048..21ebf66a92 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/pairAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/pairAssertions.kt @@ -40,8 +40,6 @@ val Assert>.first get() : AssertionPlantNullable = property(Pa * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @@ -80,8 +78,6 @@ val Assert>.second get() : AssertionPlantNullable = property(P * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/throwableAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/throwableAssertions.kt index 23b9b18d11..400dfc24d7 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/throwableAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/throwableAssertions.kt @@ -22,7 +22,6 @@ import kotlin.jvm.JvmName * assertion (a [Throwable] was thrown) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") inline fun ThrowableThrown.Builder.wirft(noinline assertionCreator: Assert.() -> Unit) { @@ -36,7 +35,6 @@ inline fun ThrowableThrown.Builder.wirft(noinlin * @return Notice, that this assertion function cannot provide a fluent API because we assume nothing happens, * so there is nothing we could make assertions on in addition. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun ThrowableThrown.Builder.wirftNichts() { @@ -52,9 +50,6 @@ fun ThrowableThrown.Builder.wirftNichts() { * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion [message][Throwable.message] is not null) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. - * - * @throws AssertionError Might throw an [AssertionError] in case [message][Throwable.message] is `null` - * or if an additionally created [Assertion]s (by calling [assertionCreator]) does not hold. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.message(assertionCreator: Assert.() -> Unit) { @@ -73,9 +68,6 @@ fun Assert.message(assertionCreator: Assert.() -> Uni * * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion [message][Throwable.message] is not null) holds or not. - * - * @throws AssertionError Might throw an [AssertionError] in case [message][Throwable.message] is `null` - * or does not contain [expected] or [otherExpected]. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.messageEnthaelt(expected: Any, vararg otherExpected: Any) { diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/typeTransformationAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/typeTransformationAssertions.kt index f7e872497b..2f1259df9f 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/typeTransformationAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-common/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/typeTransformationAssertions.kt @@ -20,7 +20,6 @@ import kotlin.jvm.JvmName * assertion ([Assert.subject][SubjectProvider.subject] is not null) holds or not. Define subsequent assertions via * the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") @@ -48,7 +47,6 @@ inline fun AssertionPlantNullable.istNichtNull(noinline as * assertion ([Assert.subject][SubjectProvider.subject] *is a* [TSub]) holds or not. Define subsequent assertions * via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") @Suppress("DEPRECATION") diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/anyDeprecatedAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/anyDeprecatedAssertions.kt index dad2530c6c..d2a121db86 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/anyDeprecatedAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/anyDeprecatedAssertions.kt @@ -14,7 +14,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * * @return Does not support a fluent API because: what else would you want to assert about `null` anyway? * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Will be removed with 1.0.0 because it is redundant in terms of `ist(null)` without adding enough to be a legit alternative.", ReplaceWith("ist(null)")) fun AssertionPlantNullable.istNull() { diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/bigDecimalAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/bigDecimalAssertions.kt index 528127c840..0f79356b84 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/bigDecimalAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/bigDecimalAssertions.kt @@ -51,7 +51,6 @@ infix fun AssertionPlantNullable.istNichtNullAber(expected: * - `esGilt(BigDecimal("10")).istNumerischGleichWie(BigDecimal("10.0"))` holds. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istNumerischGleichWie(expected: T) @@ -70,7 +69,6 @@ fun Assert.istNumerischGleichWie(expected: T) * - `esGilt(BigDecimal("10")).istNichtNumerischGleichWie(BigDecimal("10.0"))` does not hold. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istNichtNumerischGleichWie(expected: T) @@ -87,7 +85,6 @@ fun Assert.istNichtNumerischGleichWie(expected: T) * - `esGilt(BigDecimal("10")).istNumerischGleichWie(BigDecimal("10.0"))` holds. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istGleichInklusiveScale(expected: T) @@ -103,7 +100,6 @@ fun Assert.istGleichInklusiveScale(expected: T) * - `assert(BigDecimal("10")).istNichtNumerischGleichWie(BigDecimal("10.0"))` does not hold. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("api-cc-de_CH is discontinued, switch to api-fluent-en_GB; will be removed with 1.0.0") fun Assert.istNichtGleichInklusiveScale(expected: T) diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/booleanDeprecatedAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/booleanDeprecatedAssertions.kt index 20ed508958..a291027e02 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/booleanDeprecatedAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/booleanDeprecatedAssertions.kt @@ -13,7 +13,6 @@ import ch.tutteli.atrium.creating.SubjectProvider * Delegates to [ist] with argument `true`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Will be removed with 1.0.0 because it is redundant in terms of `ist(true)` without adding enough to be a legit alternative.", ReplaceWith("ist(true)")) fun Assert.istTrue() = ist(true) @@ -24,7 +23,6 @@ fun Assert.istTrue() = ist(true) * Delegates to [ist] with argument `false`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Will be removed with 1.0.0 because it is redundant with `ist(false)` without adding enough to be a legit alternative.", ReplaceWith("ist(false)")) fun Assert.istFalse() = ist(false) diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceDeprecatedAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceDeprecatedAssertions.kt index 08c1927339..32b16a937b 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceDeprecatedAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceDeprecatedAssertions.kt @@ -42,7 +42,6 @@ fun getEnthaeltNicht(plant: Assert): DeprecatedNotChecker * `enthaeltStandardUebersetzungVon(IS, IS)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Most probably only used by Atrium itself; will be made internal with 1.0.0", ReplaceWith("please open an issue on GitHub if you use it as well")) fun Assert.enthaeltStandardUebersetzungVon( @@ -58,7 +57,6 @@ fun Assert.enthaeltStandardUebersetzungVon( * It is a shortcut for `enthaeltNicht.standardUebersetzungVon(expected, *otherExpected)`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Most probably only used by Atrium itself; will be made internal with 1.0.0", ReplaceWith("please open an issue on GitHub if you use it as well")) fun Assert.enthaeltNichtDieStandardUebersetzungVon( diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceDeprecatedContainsCreators.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceDeprecatedContainsCreators.kt index 143e561125..6478015004 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceDeprecatedContainsCreators.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/charSequenceDeprecatedContainsCreators.kt @@ -31,7 +31,6 @@ import ch.tutteli.atrium.reporting.translating.Translatable * `enthaelt.zumindest(1).standardUebersetzungVon(IS, IS)` * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Most probably only used by Atrium itself; will be made internal with 1.0.0", ReplaceWith("please open an issue on GitHub if you use it as well")) fun CharSequenceContains.CheckerOption.standardUebersetzungVon(expected: Translatable, vararg otherExpected: Translatable): AssertionPlant @@ -55,7 +54,6 @@ fun CharSequenceContains.CheckerOption Assert.istMitFehlerToleranz(expected: T, tolerance: T) diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/throwableDeprecatedAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/throwableDeprecatedAssertions.kt index 03a6c88d07..250d2dff0e 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/throwableDeprecatedAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/throwableDeprecatedAssertions.kt @@ -14,7 +14,6 @@ import ch.tutteli.atrium.domain.creating.throwable.thrown.ThrowableThrown * If you want to define subsequent assertions on the down-casted [Throwable], then use the overload which expects a * lambda (where you can define subsequent assertions). * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Does not add enough to be a valid alternative to the overload with assertionCreator; will be removed with 1.0.0", ReplaceWith("wirft {}")) inline fun ThrowableThrown.Builder.wirft() { diff --git a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/typeTransformationDeprecatedAssertions.kt b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/typeTransformationDeprecatedAssertions.kt index 7bc51144e0..4efc821ebd 100644 --- a/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/typeTransformationDeprecatedAssertions.kt +++ b/misc/deprecated/apis/cc-de_CH/atrium-api-cc-de_CH-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/de_CH/typeTransformationDeprecatedAssertions.kt @@ -15,7 +15,6 @@ import ch.tutteli.atrium.creating.SubjectProvider * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion ([Assert.subject][SubjectProvider.subject] is not null) holds or not. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Will be removed with 1.0.0 because it is redundant in terms of `ist(expected)` without adding enough to be a legit alternative.", ReplaceWith("ist(expected)")) inline fun AssertionPlantNullable.istNichtNullAber(expected: T) { diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/anyAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/anyAssertions.kt index 975da3ec78..19a7026f18 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/anyAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/anyAssertions.kt @@ -22,7 +22,6 @@ import kotlin.jvm.JvmName * Currently the following is possible: `assert(1).toBe(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -42,7 +41,6 @@ fun Assert.toBe(expected: T) = addAssertion(AssertImpl.any.toBe(thi * Currently the following is possible: `assert(1).notToBe(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -62,7 +60,6 @@ fun Assert.notToBe(expected: T) = addAssertion(AssertImpl.any.notTo * Currently the following is possible: `assert(1).isSameAs(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -82,7 +79,6 @@ fun Assert.isSameAs(expected: T) = addAssertion(AssertImpl.any.isSa * Currently the following is possible: `assert(1).isNotSameAs(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -100,7 +96,6 @@ fun Assert.isNotSameAs(expected: T) = addAssertion(AssertImpl.any.i * * @return Does not support a fluent API because: what else would you want to assert about `null` anyway? * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -126,7 +121,6 @@ inline fun AssertionPlantNullable.toBe(expected: T?) { * ``` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/charSequenceAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/charSequenceAssertions.kt index 8a99f4daf5..140870e768 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/charSequenceAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/charSequenceAssertions.kt @@ -68,7 +68,6 @@ val Assert.containsNot: NotCheckerOption Assert.contains(expected: Any, vararg otherExpected: A * function expects `Any` for your convenience, so that you can mix [String] and [Int] for instance). * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -130,7 +128,6 @@ fun Assert.containsNot(expected: Any, vararg otherExpected * @param otherPatterns Additional patterns which are expected to have a match against the input of the search. * * @return The [AssertionPlant] for which the assertion was built to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -148,7 +145,6 @@ fun Assert.containsRegex(pattern: String, vararg otherPatt * Makes the assertion that the [Assert.subject][SubjectProvider.subject] starts with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -166,7 +162,6 @@ fun Assert.startsWith(expected: CharSequence) = * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not start with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -185,7 +180,6 @@ fun Assert.startsNotWith(expected: CharSequence) = * Makes the assertion that the [Assert.subject][SubjectProvider.subject] ends with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -203,7 +197,6 @@ fun Assert.endsWith(expected: CharSequence) = * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not end with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -222,7 +215,6 @@ fun Assert.endsNotWith(expected: CharSequence) = * Makes the assertion that the [Assert.subject][SubjectProvider.subject] [CharSequence].[kotlin.text.isEmpty]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -239,7 +231,6 @@ fun Assert.isEmpty() = addAssertion(AssertImpl.charSequenc * Makes the assertion that the [Assert.subject][SubjectProvider.subject] [CharSequence].[kotlin.text.isNotEmpty]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -256,7 +247,6 @@ fun Assert.isNotEmpty() = addAssertion(AssertImpl.charSequ * Makes the assertion that the [Assert.subject][SubjectProvider.subject] [CharSequence].[kotlin.text.isNotBlank]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/charSequenceContainsCreators.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/charSequenceContainsCreators.kt index 51ea015206..c27790aebd 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/charSequenceContainsCreators.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/charSequenceContainsCreators.kt @@ -26,7 +26,6 @@ import kotlin.jvm.JvmName * @param expected The value which is expected to be contained within the input of the search. * * @return The [AssertionPlant] for which the assertion was built to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ @@ -62,7 +61,6 @@ fun CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.Builder CharSequenceContains.Builder CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption> Assert.hasSize(size: Int) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is an empty [Collection]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -50,7 +48,6 @@ fun > Assert.isEmpty() * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is not an empty [Collection]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -88,8 +85,6 @@ val Assert>.size get(): Assert = property(Collection<*>::size * holds all assertions the given [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/comparableAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/comparableAssertions.kt index a5c797ccd7..8741c3c398 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/comparableAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/comparableAssertions.kt @@ -10,7 +10,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is less than [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -28,7 +27,6 @@ fun > Assert.isLessThan(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is less than or equals [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -46,7 +44,6 @@ fun > Assert.isLessOrEquals(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is greater than [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -64,7 +61,6 @@ fun > Assert.isGreaterThan(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is greater than or equals [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/featureAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/featureAssertions.kt index a54b753523..9eb55d4466 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/featureAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/featureAssertions.kt @@ -62,9 +62,6 @@ fun Assert.property(property: KProperty1 CollectingAssertionPlant.property(property: KP * starting with a group consisting of the [Assertion]s created by the [assertionCreator] lambda. * * @return An [AssertionPlant] for the given [property]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect and use feature instead; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -200,9 +194,6 @@ fun Assert.returnValueOf(method: KFunction1): Assert * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect and use feature instead; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -228,9 +219,6 @@ fun CollectingAssertionPlant.returnValueOf(method: KFuncti * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( @@ -346,9 +334,6 @@ fun Assert.returnValueOf(method: KFunction2, * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect and use feature instead; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -374,9 +359,6 @@ fun CollectingAssertionPlant.returnValueOf(method: KFu * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( @@ -491,9 +473,6 @@ fun Assert.returnValueOf(method: KFunction3 CollectingAssertionPlant.returnValueOf(method: * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( @@ -636,9 +612,6 @@ fun Assert.returnValueOf(method: KFunction4 CollectingAssertionPlant.returnValueOf(met * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( @@ -781,9 +751,6 @@ fun Assert.returnValueOf(method: KFunction * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect and use feature instead; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -809,9 +776,6 @@ fun CollectingAssertionPlant.returnValueOf * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( @@ -926,9 +890,6 @@ fun Assert.returnValueOf(method: KFunc * by the [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect and use feature instead; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -954,9 +915,6 @@ fun CollectingAssertionPlant.returnVal * by the [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/floatingPointAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/floatingPointAssertions.kt index a44fb9ac0e..68a69eaf1d 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/floatingPointAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/floatingPointAssertions.kt @@ -22,7 +22,6 @@ import kotlin.jvm.JvmName * | [Assert.subject][SubjectProvider.subject] - [expected] | ≤ [tolerance] * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -47,7 +46,6 @@ fun Assert.toBeWithErrorTolerance(expected: Float, tolerance: Float) * | [Assert.subject][SubjectProvider.subject] - [expected] | ≤ [tolerance] * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/iterableAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/iterableAssertions.kt index eee667bb96..033e6ca24a 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/iterableAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/iterableAssertions.kt @@ -67,7 +67,6 @@ val > Assert.containsNot: NotCheckerOption> Assert.contains(expected: E, vararg otherExpected: E) * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -123,7 +121,6 @@ fun > Assert.contains(assertionCreatorOrNull: (Assert * which we are looking for (see [assertionCreatorOrNull] for more information). * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -148,7 +145,6 @@ fun > Assert.contains(assertionCreatorOrNull: (Assert * It is a shortcut for `contains.inOrder.only.values(expected, *otherExpected)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -174,7 +170,6 @@ fun > Assert.containsExactly(expected: E, vararg otherExpe * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -204,7 +199,6 @@ fun > Assert.containsExactly(assertionCreatorOrNull * which we are looking for (see [assertionCreatorOrNull] for more information). * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -230,7 +224,6 @@ fun > Assert.containsExactly(assertionCreatorOrNull * It is a shortcut for `containsNot.values(expected, *otherExpected)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -253,7 +246,6 @@ fun > Assert.containsNot(expected: E, vararg otherExpected * It is a shortcut for `contains.inAnyOrder.atLeast(1).entry(assertionCreatorOrNull)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -277,7 +269,6 @@ fun > Assert.any(assertionCreatorOrNull: (Assert * It is a shortcut for `containsNot.entry(assertionCreatorOrNull)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -299,7 +290,6 @@ fun > Assert.none(assertionCreatorOrNull: (Assert> IterableContains.CheckerOption> IterableContains.CheckerOption> IterableContains.CheckerOption> IterableContains.Builder> IterableContains.Builder> IterableContains.Builder> IterableContains.Builder> IterableContains.Builder> IterableContains.Builder> IterableContains.Builder> Assert.get(index: Int): Assert * the corresponding element holds all assertions the given [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( @@ -53,7 +50,6 @@ fun > Assert.get(index: Int, assertionCreator: Assert.( * creates a feature assertion plant for the corresponding nullable element and returns the newly created plant. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the given [index] is out of bound. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/mapAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/mapAssertions.kt index af11243713..5cc6360aba 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/mapAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/mapAssertions.kt @@ -22,7 +22,6 @@ import kotlin.js.JsName * even though they match the same entry. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -48,7 +47,6 @@ fun > Assert.contains(keyValuePair: Pair, vararg * , then both match, even though they match the same entry. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -68,7 +66,6 @@ fun > Assert.contains( * Makes the assertion that the [Assert.subject][SubjectProvider.subject] contains the given [key]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -86,7 +83,6 @@ fun Assert>.containsKey(key: K) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not contain the given [key]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -107,7 +103,6 @@ fun Assert>.containsNotKey(key: K) * assertion plant for the corresponding value and returns the newly created plant. * * @return The newly created plant for the feature - * @throws AssertionError Might throw an [AssertionError] if the given [key] does not exist. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -127,8 +122,6 @@ fun > Assert.getExisting(key: K): Assert * the corresponding value holds all assertions the given [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( @@ -149,7 +142,6 @@ fun > Assert.getExisting(key: K, assertionCreator * assertion plant for the corresponding nullable value and returns the newly created plant. * * @return The newly created plant for the feature - * @throws AssertionError Might throw an [AssertionError] if the given [key] does not exist. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -167,7 +159,6 @@ fun > Assert.getExisting(key: K): AssertionPlant * Makes the assertion that the [Assert.subject][SubjectProvider.subject]'s [Map.size] is [size]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -185,7 +176,6 @@ fun > Assert.hasSize(size: Int) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is an empty [Map]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -203,7 +193,6 @@ fun > Assert.isEmpty() * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is not an empty [Map]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -242,8 +231,6 @@ val Assert>.keys get() : Assert> = property(Map::keys * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( @@ -282,8 +269,6 @@ val Assert>.values get() : Assert> = property(Map<*, * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/mapEntryAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/mapEntryAssertions.kt index 201698f2ed..b3fb681770 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/mapEntryAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/mapEntryAssertions.kt @@ -18,7 +18,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * if the assertion about the key fails. Moreover, it might be that reporting differs compared to using the long form. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -76,8 +75,6 @@ val Assert>.key get() : AssertionPlantNullable = property * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( @@ -136,8 +133,6 @@ val Assert>.value get() : AssertionPlantNullable = proper * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/pairAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/pairAssertions.kt index 95cb0ca322..f8b24d6143 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/pairAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/pairAssertions.kt @@ -54,8 +54,6 @@ val Assert>.first get() : AssertionPlantNullable = property(Pa * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( @@ -115,8 +113,6 @@ val Assert>.second get() : AssertionPlantNullable = property(P * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/throwableAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/throwableAssertions.kt index bc28c36758..7da543f074 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/throwableAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/throwableAssertions.kt @@ -17,7 +17,6 @@ import ch.tutteli.atrium.domain.creating.throwable.thrown.ThrowableThrown * assertion (a [Throwable] was thrown) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -37,7 +36,6 @@ inline fun ThrowableThrown.Builder.toThrow(noinl * @return Notice, that this assertion function cannot provide a fluent API because we assume nothing happens, * so there is nothing we could make assertions on in addition. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -58,9 +56,6 @@ fun ThrowableThrown.Builder.notToThrow(){ * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion [message][Throwable.message] is not null) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. - * - * @throws AssertionError Might throw an [AssertionError] in case [message][Throwable.message] is `null` - * or if an additionally created [Assertion]s (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -86,9 +81,6 @@ fun Assert.message(assertionCreator: Assert.() -> Uni * * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion [message][Throwable.message] is not null) holds or not. - * - * @throws AssertionError Might throw an [AssertionError] in case [message][Throwable.message] is `null` - * or does not contain [expected] or [otherExpected]. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/typeTransformationAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/typeTransformationAssertions.kt index 485e3d3e90..41d5774d43 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/typeTransformationAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/typeTransformationAssertions.kt @@ -20,7 +20,6 @@ import kotlin.jvm.JvmName * assertion ([Assert.subject][SubjectProvider.subject] is not null) holds or not. Define subsequent assertions * via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -55,7 +54,6 @@ inline fun AssertionPlantNullable.notToBeNull(noinline ass * assertion ([Assert.subject][SubjectProvider.subject] *is a* [TSub]) holds or not. Define subsequent assertions * via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/bigDecimalAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/bigDecimalAssertions.kt index 32c7e8ba01..8cf60b5354 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/bigDecimalAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/bigDecimalAssertions.kt @@ -51,7 +51,6 @@ fun AssertionPlantNullable.notToBeNullBut(expected: T): Not * - `assert(BigDecimal("10")).isNumericallyEqualTo(BigDecimal("10.0"))` holds. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -78,7 +77,6 @@ fun Assert.isNumericallyEqualTo(expected: T) * - `assert(BigDecimal("10")).isNotNumericallyEqualTo(BigDecimal("10.0"))` does not hold. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -103,7 +101,6 @@ fun Assert.isNotNumericallyEqualTo(expected: T) * - `assert(BigDecimal("10")).isNumericallyEqualTo(BigDecimal("10.0"))` holds. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", @@ -127,7 +124,6 @@ fun Assert.isEqualIncludingScale(expected: T) * - `assert(BigDecimal("10")).isNotNumericallyEqualTo(BigDecimal("10.0"))` does not hold. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/floatingPointJvmAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/floatingPointJvmAssertions.kt index b9be8e3fdf..52c9a6e3b3 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/floatingPointJvmAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/floatingPointJvmAssertions.kt @@ -21,7 +21,6 @@ import java.math.BigDecimal * | [Assert.subject][SubjectProvider.subject] - [expected] | ≤ [tolerance] * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.9.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/typeTransformationDeprecatedAssertions.kt b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/typeTransformationDeprecatedAssertions.kt index e25ab3e7a0..e9133bdf6d 100644 --- a/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/typeTransformationDeprecatedAssertions.kt +++ b/misc/deprecated/apis/cc-en_GB/atrium-api-cc-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/en_GB/typeTransformationDeprecatedAssertions.kt @@ -16,7 +16,6 @@ import ch.tutteli.atrium.creating.SubjectProvider * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion ([Assert.subject][SubjectProvider.subject] is not null) holds or not. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Will be removed with 1.0.0 because it is redundant in terms of `ist(expected)` without adding enough to be a legit alternative.", diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/anyAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/anyAssertions.kt index af0453bce2..552c40376e 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/anyAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/anyAssertions.kt @@ -24,7 +24,6 @@ import kotlin.jvm.JvmName * Currently the following is possible: `assert(1).toBe(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -50,7 +49,6 @@ infix fun Assert.toBe(keyword: Keyword): Nothing * Currently the following is possible: `assert(1).notToBe(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -76,7 +74,6 @@ infix fun Assert.notToBe(keyword: Keyword): Nothing * Currently the following is possible: `assert(1).isSameAs(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -97,7 +94,6 @@ infix fun Assert.isSameAs(expected: T) * Currently the following is possible: `assert(1).isNotSameAs(1.0)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -115,7 +111,6 @@ infix fun Assert.isNotSameAs(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is [expected]. * * @return Does not support a fluent API because: what else would you want to assert about `null` anyway? - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Suppress("DEPRECATION") @Deprecated( @@ -144,7 +139,6 @@ inline infix fun AssertionPlantNullable.toBe(expected: T?) * ``` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Suppress("DEPRECATION") @Deprecated( diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/charSequenceAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/charSequenceAssertions.kt index 115e9fba56..043984fa1d 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/charSequenceAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/charSequenceAssertions.kt @@ -68,7 +68,6 @@ infix fun Assert.notTo(@Suppress("UNUSED_PARAMETER") conta * By non disjoint is meant that `'aa'` in `'aaaa'` is found three times and not only two times. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ @Deprecated( @@ -105,7 +104,6 @@ infix fun Assert.contains(expected: Any): AssertionPlant Assert.contains(values: Values): AssertionP * It is a shortcut for `to contain atLeast 1 regex pattern`. * * @return The [AssertionPlant] for which the assertion was built to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -162,7 +159,6 @@ infix fun Assert.containsRegex(pattern: String): Assertion * @param patterns The patterns which are expected to have a match against the input of the search. * * @return The [AssertionPlant] for which the assertion was built to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -186,7 +182,6 @@ infix fun Assert.contains(patterns: RegexPatterns): Assert * function expects `Any` for your convenience, so that you can mix [String] and [Int] for instance). * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -210,7 +205,6 @@ infix fun Assert.containsNot(expected: Any) * function expects `Any` for your convenience, so that you can mix [String] and [Int] for instance). * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -229,7 +223,6 @@ infix fun Assert.containsNot(values: Values) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] starts with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -247,7 +240,6 @@ infix fun Assert.startsWith(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not start with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -266,7 +258,6 @@ infix fun Assert.startsNotWith(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] ends with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -284,7 +275,6 @@ infix fun Assert.endsWith(expected: CharSequence) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not end with [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -305,7 +295,6 @@ infix fun Assert.endsNotWith(expected: CharSequence) * @param Empty Has to be `Empty`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -326,7 +315,6 @@ infix fun Assert.toBe(@Suppress("UNUSED_PARAMETER") Empty: * @param Empty Has to be `Empty`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -347,7 +335,6 @@ infix fun Assert.notToBe(@Suppress("UNUSED_PARAMETER") Emp * @param Blank Has to be `Blank`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/charSequenceContainsCreators.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/charSequenceContainsCreators.kt index 255c12a5d1..dd5f830469 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/charSequenceContainsCreators.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/charSequenceContainsCreators.kt @@ -24,7 +24,6 @@ import kotlin.jvm.JvmName * @param expected The value which is expected to be contained within the input of the search. * * @return The [AssertionPlant] for which the assertion was built to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * @throws IllegalArgumentException in case [expected] is not a [CharSequence], [Number] or [Char]. */ @Deprecated( @@ -58,7 +57,6 @@ infix fun CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.Builder CharSequenceContains.Builder CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.CheckerOption CharSequenceContains.Builder> Assert.hasSize(size: Int) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is an empty [Collection]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -54,7 +52,6 @@ infix fun > Assert.toBe(@Suppress("UNUSED_PARAMETER") Empty * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is not an empty [Collection]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -94,8 +91,6 @@ val Assert>.size get(): Assert = property(Collection<*>::size * holds all assertions the given [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Suppress("DEPRECATION") diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/comparableAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/comparableAssertions.kt index ad1ed93366..4865246bbe 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/comparableAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/comparableAssertions.kt @@ -11,7 +11,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is less than [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -29,7 +28,6 @@ infix fun > Assert.isLessThan(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is less than or equals [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -47,7 +45,6 @@ infix fun > Assert.isLessOrEquals(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is greater than [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -65,7 +62,6 @@ infix fun > Assert.isGreaterThan(expected: T) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is greater than or equals [expected]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/list/get/builders/ListGetNullableOption.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/list/get/builders/ListGetNullableOption.kt index a6de56b0e1..45809c8ddd 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/list/get/builders/ListGetNullableOption.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/list/get/builders/ListGetNullableOption.kt @@ -37,8 +37,6 @@ interface ListGetNullableOption> { * as the [List] has a nullable element type. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ infix fun assertIt(assertionCreator: AssertionPlantNullable.() -> Unit): Assert diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/list/get/builders/ListGetOption.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/list/get/builders/ListGetOption.kt index acfb895e9d..7c8ad13e4b 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/list/get/builders/ListGetOption.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/list/get/builders/ListGetOption.kt @@ -33,8 +33,6 @@ interface ListGetOption> { * the corresponding entry holds all assertions the given [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ infix fun assertIt(assertionCreator: Assert.() -> Unit): Assert diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/map/get/builders/MapGetNullableOption.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/map/get/builders/MapGetNullableOption.kt index 89b282000a..956a79a66b 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/map/get/builders/MapGetNullableOption.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/map/get/builders/MapGetNullableOption.kt @@ -38,8 +38,6 @@ interface MapGetNullableOption> { * nullable value type. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ infix fun assertIt(assertionCreator: AssertionPlantNullable.() -> Unit): Assert diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/map/get/builders/MapGetOption.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/map/get/builders/MapGetOption.kt index b549a0a7c9..d612e43446 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/map/get/builders/MapGetOption.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/creating/map/get/builders/MapGetOption.kt @@ -34,8 +34,6 @@ interface MapGetOption> { * corresponding value holds all assertions the given [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ infix fun assertIt(assertionCreator: Assert.() -> Unit): Assert diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/featureAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/featureAssertions.kt index 9b2423f417..7a8297146a 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/featureAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/featureAssertions.kt @@ -63,9 +63,6 @@ fun Assert.property(property: KProperty1 CollectingAssertionPlant.property(property: KP * starting with a group consisting of the [Assertion]s created by the [assertionCreator] lambda. * * @return An [AssertionPlant] for the given [property]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect and use feature instead; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -203,9 +197,6 @@ fun Assert.returnValueOf(method: KFunction1): Assert * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect and use feature instead; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -232,9 +223,6 @@ fun CollectingAssertionPlant.returnValueOf(method: KFuncti * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( @@ -351,9 +339,6 @@ fun Assert.returnValueOf(method: KFunction2, * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect and use feature instead; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -380,9 +365,6 @@ fun CollectingAssertionPlant.returnValueOf(method: KFu * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( @@ -500,9 +482,6 @@ fun Assert.returnValueOf(method: KFunction3 CollectingAssertionPlant.returnValueOf(method: * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( @@ -649,9 +625,6 @@ fun Assert.returnValueOf(method: KFunction4 CollectingAssertionPlant.returnValueOf(met * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( @@ -798,9 +768,6 @@ fun Assert.returnValueOf(method: KFunction * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect and use feature instead; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -827,9 +794,6 @@ fun CollectingAssertionPlant.returnValueOf * [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( @@ -947,9 +911,6 @@ fun Assert.returnValueOf(method: KFunc * by the [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect and use feature instead; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -976,9 +937,6 @@ fun CollectingAssertionPlant.returnVal * by the [assertionCreator] lambda. * * @return An [AssertionPlant] for the return value of the given [method]. - * - * @throws AssertionError Might throw an [AssertionError] if an additionally created [Assertion] - * (by calling [assertionCreator]) does not hold. */ @JvmName("safeReturnValueOf") @Deprecated( diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/iterableAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/iterableAssertions.kt index 5a79ccbf78..f31ea60437 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/iterableAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/iterableAssertions.kt @@ -64,7 +64,6 @@ infix fun > Assert.notTo(@Suppress("UNUSED_PARAMETER") con * It is a shortcut for `to contain inAny order atLeast 1 value expected` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -95,7 +94,6 @@ infix fun > Assert.contains(expected: E) * `contains Values('a', 'a')` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -122,7 +120,6 @@ infix fun > Assert.contains(values: Values): AssertionP * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -147,7 +144,6 @@ infix fun > Assert.contains(assertionCreatorOrNull: * It is a shortcut for `to contain inAny order atLeast 1 the Entries(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -171,7 +167,6 @@ infix fun > Assert.contains(entries: Entries): A * It is a shortcut for `to contain inGiven order and only value expected` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -192,7 +187,6 @@ infix fun > Assert.containsExactly(expected: E): Assertion * It is a shortcut for `to contain inGiven order and only the Values(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -219,7 +213,6 @@ infix fun > Assert.containsExactly(values: Values): Ass * or not. In case it is defined as `null`, then an entry is identified if it is `null` as well. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -245,7 +238,6 @@ infix fun > Assert.containsExactly(assertionCreator * It is a shortcut for `to contain inGiven order and only the Entries(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -268,7 +260,6 @@ infix fun > Assert.containsExactly(entries: Entries * It is a shortcut for `notTo contain value expected` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -288,7 +279,6 @@ infix fun > Assert.containsNot(expected: E): AssertionPlan * It is a shortcut for `notTo contain the Values(...)` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -312,7 +302,6 @@ infix fun > Assert.containsNot(values: Values): Asserti * It is a shortcut for `to contain inAny order atLeast 1 entry assertionCreatorOrNull` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -336,7 +325,6 @@ infix fun > Assert.any(assertionCreatorOrNull: (Ass * It is a shortcut for `notTo contain entry assertionCreatorOrNull` * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -358,7 +346,6 @@ infix fun > Assert.none(assertionCreatorOrNull: (As * in case [assertionCreatorOrNull] is defined as `null`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Suppress("DEPRECATION") @Deprecated( diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/iterableContainsInAnyOrderCreators.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/iterableContainsInAnyOrderCreators.kt index a700850b98..6e85aeb8ae 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/iterableContainsInAnyOrderCreators.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/iterableContainsInAnyOrderCreators.kt @@ -25,7 +25,6 @@ import kotlin.jvm.JvmName * @param expected The value which is expected to be contained within the [Iterable]. * * @return The [AssertionPlant] for which the assertion was built to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from api-cc-infix-en_GB to api-infix-en_GB; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -55,7 +54,6 @@ infix fun > IterableContains.CheckerOption> IterableContains.CheckerOption> IterableContains.CheckerOption> IterableContains.Builder> IterableContains.Builder> IterableContains.Builder> IterableContains.Builder> IterableContains.Builder> IterableContains.Builder> IterableContains.Builder> Assert.get(index: Index): ListGetOption * creates a feature assertion plant for the corresponding nullable element and returns the newly created plant. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the given [index] is out of bound. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/mapAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/mapAssertions.kt index 22c3898e8a..25755eb1c4 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/mapAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/mapAssertions.kt @@ -21,7 +21,6 @@ import kotlin.js.JsName * Delegates to `contains Pairs(keyValuePair)`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -40,7 +39,6 @@ infix fun > Assert.contains(keyValuePair: Pair) * a key as defined by entry's [Pair.first] with a corresponding value as defined by entry's [Pair.second]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Suppress("DEPRECATION") @Deprecated( @@ -63,7 +61,6 @@ infix fun > Assert.contains(keyValuePairs: Pairs * [KeyValue.valueAssertionCreatorOrNull] is defined as `null`. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -90,7 +87,6 @@ infix fun > Assert.contains(keyValue: KeyValue< * then both match, even though they match the same entry. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -112,7 +108,6 @@ infix fun > Assert.contains(keyValues: All Assert>.containsKey(key: K) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] does not contain the given [key]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -150,7 +144,6 @@ infix fun Assert>.containsNotKey(key: K) * assertion plant for the corresponding value and returns the newly created plant. * * @return The newly created plant for the feature - * @throws AssertionError Might throw an [AssertionError] if the given [key] does not exist. */ @Suppress("DEPRECATION") @JsName("getExisting") @@ -189,7 +182,6 @@ infix fun > Assert.getExisting(key: Key): MapG * assertion plant for the corresponding nullable value and returns the newly created plant. * * @return The newly created plant for the feature - * @throws AssertionError Might throw an [AssertionError] if the given [key] does not exist. */ @Suppress("DEPRECATION") @Deprecated( @@ -230,7 +222,6 @@ infix fun > Assert.getExisting(key: Key): MapGetNul * Makes the assertion that the [Assert.subject][SubjectProvider.subject]'s [Map.size] is [size]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Suppress("DEPRECATION") @Deprecated( @@ -249,7 +240,6 @@ infix fun > Assert.hasSize(size: Int) * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is an empty [Map]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -268,7 +258,6 @@ infix fun > Assert.toBe(@Suppress("UNUSED_PARAMETER") Empty: Em * Makes the assertion that the [Assert.subject][SubjectProvider.subject] is not an empty [Map]. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -308,8 +297,6 @@ val Assert>.keys get() : Assert> = property(Map Assert>.values get() : Assert> = property * [assertionCreator] might create. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. */ @Suppress("DEPRECATION") @Deprecated( diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/mapEntryAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/mapEntryAssertions.kt index 74875af7da..d9a875f421 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/mapEntryAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/mapEntryAssertions.kt @@ -18,7 +18,6 @@ import ch.tutteli.atrium.domain.builders.AssertImpl * if the assertion about the key fails. Moreover, it might be that reporting differs compared to using the long form. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -77,8 +76,6 @@ val Assert>.key get() : AssertionPlantNullable = property * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Suppress("DEPRECATION") @@ -139,8 +136,6 @@ val Assert>.value get() : AssertionPlantNullable = proper * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/pairAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/pairAssertions.kt index 07f47a8cce..1ee667d5db 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/pairAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/pairAssertions.kt @@ -54,8 +54,6 @@ val Assert>.first get() : AssertionPlantNullable = property(Pa * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( @@ -116,8 +114,6 @@ val Assert>.second get() : AssertionPlantNullable = property(P * [assertionCreator] might create for it. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if a created [Assertion]s (by calling [assertionCreator]) - * does not hold. * @throws IllegalArgumentException in case the given [assertionCreator] did not create a single assertion. */ @Deprecated( diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/throwableAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/throwableAssertions.kt index f12eab5e93..097dd5b0e2 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/throwableAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/throwableAssertions.kt @@ -17,7 +17,6 @@ import ch.tutteli.atrium.domain.creating.throwable.thrown.ThrowableThrown * assertion (a [Throwable] was thrown) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -38,7 +37,6 @@ inline infix fun ThrowableThrown.Builder.toThrow * @return Notice, that this assertion function cannot provide a fluent API because we assume nothing happens, * so there is nothing we could make assertions on in addition. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -60,9 +58,6 @@ fun ThrowableThrown.Builder.notToThrow(){ * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion [message][Throwable.message] is not null) holds or not. * Define subsequent assertions via the [assertionCreator] lambda. - * - * @throws AssertionError Might throw an [AssertionError] in case [message][Throwable.message] is `null` - * or if an additionally created [Assertion]s (by calling [assertionCreator]) does not hold. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -87,9 +82,6 @@ infix fun Assert.message(assertionCreator: Assert.() * * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion [message][Throwable.message] is not null) holds or not. - * - * @throws AssertionError Might throw an [AssertionError] in case [message][Throwable.message] is `null` - * or does not contain the [expected] object. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -115,9 +107,6 @@ infix fun Assert.messageContains(expected: Any) { * * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion [message][Throwable.message] is not null) holds or not. - * - * @throws AssertionError Might throw an [AssertionError] in case [message][Throwable.message] is `null` - * or does not contain all the [values]. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/typeTransformationAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/typeTransformationAssertions.kt index d5fdea006a..4819371f6b 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/typeTransformationAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-common/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/typeTransformationAssertions.kt @@ -21,7 +21,6 @@ import kotlin.jvm.JvmName * assertion ([Assert.subject][SubjectProvider.subject] is not null) holds or not. Define subsequent assertions * via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", @@ -58,7 +57,6 @@ inline infix fun AssertionPlantNullable.notToBeNull(noinli * assertion ([Assert.subject][SubjectProvider.subject] *is a* [TSub]) holds or not. Define subsequent assertions * via the [assertionCreator] lambda. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated( "Switch from Assert to Expect; will be removed with 1.0.0 -- see https://github.com/robstoll/atrium/releases/tag/v0.12.0#migration for migration hints and scripts.", diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/bigDecimalAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/bigDecimalAssertions.kt index a7cc287243..4505e48543 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/bigDecimalAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/bigDecimalAssertions.kt @@ -51,7 +51,6 @@ infix fun AssertionPlantNullable.notToBeNullBut(expected: T * - `assert(BigDecimal("10")) isNumericallyEqualTo BigDecimal("10.0")` holds. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Assert.isNumericallyEqualTo(expected: T) = addAssertion(AssertImpl.bigDecimal.isNumericallyEqualTo(this, expected)) @@ -68,7 +67,6 @@ infix fun Assert.isNumericallyEqualTo(expected: T) * - `assert(BigDecimal("10")) isNotNumericallyEqualTo BigDecimal("10.0")` does not hold. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Assert.isNotNumericallyEqualTo(expected: T) = addAssertion(AssertImpl.bigDecimal.isNotNumericallyEqualTo(this, expected)) @@ -84,7 +82,6 @@ infix fun Assert.isNotNumericallyEqualTo(expected: T) * - `assert(BigDecimal("10")) isNumericallyEqualTo BigDecimal("10.0")` holds. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Assert.isEqualIncludingScale(expected: T) = addAssertion(AssertImpl.bigDecimal.isEqualIncludingScale(this, expected, this::isNumericallyEqualTo.name)) @@ -99,7 +96,6 @@ infix fun Assert.isEqualIncludingScale(expected: T) * - `assert(BigDecimal("10")) isNotNumericallyEqualTo BigDecimal("10.0")` does not hold. * * @return This plant to support a fluent API. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ infix fun Assert.isNotEqualIncludingScale(expected: T) = addAssertion(AssertImpl.bigDecimal.isNotEqualIncludingScale(this, expected)) diff --git a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/typeTransformationDeprecatedAssertions.kt b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/typeTransformationDeprecatedAssertions.kt index 2247b2eeaf..2c92e02676 100644 --- a/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/typeTransformationDeprecatedAssertions.kt +++ b/misc/deprecated/apis/cc-infix-en_GB/atrium-api-cc-infix-en_GB-jvm/src/main/kotlin/ch/tutteli/atrium/api/cc/infix/en_GB/typeTransformationDeprecatedAssertions.kt @@ -19,7 +19,6 @@ import ch.tutteli.atrium.domain.builders.creating.PleaseUseReplacementException * @return Notice, that this assertion function cannot provide a fluent API because it depends on whether the first * assertion ([Assert.subject][SubjectProvider.subject] is not null) holds or not. * - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. */ @Deprecated("Will be removed with 1.0.0 because it is redundant in terms of `ist(expected)` without adding enough to be a legit alternative.", ReplaceWith("ist(expected)")) inline infix fun AssertionPlantNullable.notToBeNullBut(expected: T) { diff --git a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoLocalDateAssertions.kt b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoLocalDateAssertions.kt index 99164d01cb..548f3b332b 100644 --- a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoLocalDateAssertions.kt +++ b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoLocalDateAssertions.kt @@ -17,7 +17,6 @@ import java.time.chrono.ChronoLocalDate * is before the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -33,7 +32,6 @@ fun Expect.isBefore(expected: ChronoLocalDate): Expect< * is before or equal the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -50,7 +48,6 @@ fun Expect.isBeforeOrEqual(expected: ChronoLocalDate): * is after the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -66,7 +63,6 @@ fun Expect.isAfter(expected: ChronoLocalDate): Expect Expect.isAfterOrEqual(expected: ChronoLocalDate): E * is equal to the [expected] [ChronoLocalDate]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ diff --git a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoLocalDateTimeAssertions.kt b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoLocalDateTimeAssertions.kt index 5a2a780d72..db96c824d6 100644 --- a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoLocalDateTimeAssertions.kt +++ b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoLocalDateTimeAssertions.kt @@ -17,7 +17,6 @@ import java.time.chrono.ChronoLocalDateTime * is before the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -33,7 +32,6 @@ fun > Expect.isBefore(expected: * is before or equal the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -50,7 +48,6 @@ fun > Expect.isBeforeOrEqual( * is after the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -67,7 +64,6 @@ fun > Expect.isAfter( * is after or equal the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -84,7 +80,6 @@ fun > Expect.isAfterOrEqual( * is equal to the [expected] [ChronoLocalDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ diff --git a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoZonedDateTimeAssertions.kt b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoZonedDateTimeAssertions.kt index 202b97c3fd..eded2d5718 100644 --- a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoZonedDateTimeAssertions.kt +++ b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/chronoZonedDateTimeAssertions.kt @@ -17,7 +17,6 @@ import java.time.chrono.ChronoZonedDateTime * is before the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -34,7 +33,6 @@ fun > Expect.isBefore( * is before or equals the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -51,7 +49,6 @@ fun > Expect.isBeforeOrEqual( * is after the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -68,7 +65,6 @@ fun > Expect.isAfter( * is after or equal the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -85,7 +81,6 @@ fun > Expect.isAfterOrEqual( * is equal to the [expected] [ChronoZonedDateTime]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ diff --git a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/localDateAssertions.kt b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/localDateAssertions.kt index c9f3db1c7b..73178b7692 100644 --- a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/localDateAssertions.kt +++ b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/localDateAssertions.kt @@ -36,7 +36,6 @@ val Expect.year: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -68,7 +67,6 @@ val Expect.month: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -100,7 +98,6 @@ val Expect.dayOfWeek: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -133,7 +130,6 @@ val Expect.day: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ diff --git a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/localDateTimeAssertions.kt b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/localDateTimeAssertions.kt index b125575126..fec0e4c31a 100644 --- a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/localDateTimeAssertions.kt +++ b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/localDateTimeAssertions.kt @@ -36,7 +36,6 @@ val Expect.year: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -68,7 +67,6 @@ val Expect.month: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -100,7 +98,6 @@ val Expect.dayOfWeek: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -132,7 +129,6 @@ val Expect.day: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ diff --git a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/optionalAssertions.kt b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/optionalAssertions.kt index 943abbf7db..a6f965aff2 100644 --- a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/optionalAssertions.kt +++ b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/optionalAssertions.kt @@ -18,7 +18,6 @@ import java.util.* * depends on the underlying implementation though. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -36,7 +35,6 @@ fun > Expect.isEmpty(): Expect = addAssertion(ExpectImpl.o * depends on the underlying implementation though. * * @return The newly created [Expect] for the inner type [E]. - * @throws AssertionError Might throw an [AssertionError] if the given assertion is not a success. * * @since 0.9.0 */ @@ -51,7 +49,6 @@ fun > Expect.isPresent(): Expect = ExpectImpl.optional. * that it holds all assertions the given [assertionCreator] creates. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the given assertions are not success. * * @since 0.9.0 */ diff --git a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/pathAssertions.kt b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/pathAssertions.kt index d353fd6121..d729cb8900 100644 --- a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/pathAssertions.kt +++ b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/pathAssertions.kt @@ -16,7 +16,6 @@ import java.nio.file.Path * Expects that the subject of the assertion (a [Path]) starts with the [expected] [Path]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -31,7 +30,6 @@ fun Expect.startsWith(expected: Path): Expect = * Expects that the subject of the assertion (a [Path]) does not start with the [expected] [Path]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -46,7 +44,6 @@ fun Expect.startsNotWith(expected: Path): Expect = * Expects that the subject of the assertion (a [Path]) ends with the expected [Path]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -62,7 +59,6 @@ fun Expect.endsWith(expected: Path): Expect = * * @param expected The [Path] provided to the assertion * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -81,7 +77,6 @@ fun Expect.endsNotWith(expected: Path): Expect = * then the search will continue at that location. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -99,7 +94,6 @@ fun Expect.exists(): Expect = addAssertion(ExpectImpl.path.exis * then the search will continue at that location. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -132,7 +126,6 @@ val Expect.fileName: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -149,7 +142,6 @@ fun Expect.fileName(assertionCreator: Expect.() -> Unit): * so that further fluent calls are assertions about it. * * @return The newly created [Expect] for the extracted feature. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -167,7 +159,6 @@ val Expect.fileNameWithoutExtension: Expect * and returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -186,7 +177,6 @@ fun Expect.fileNameWithoutExtension(assertionCreator: Expect Expect.parent: Expect * given [assertionCreator] creates for it and returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -218,7 +207,6 @@ fun Expect.parent(assertionCreator: Expect.() -> Unit): Expe * so that further fluent calls are assertions about it. * * @return The newly created [Expect] for the extracted feature. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.10.0 */ @@ -234,7 +222,6 @@ fun Expect.resolve(other: String): Expect = * given [assertionCreator] creates for it and returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.10.0 */ @@ -259,7 +246,6 @@ fun Expect.resolve(other: String, assertionCreator: Expect.( * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -279,7 +265,6 @@ fun Expect.isReadable(): Expect = addAssertion(ExpectImpl.path. * at the location the link points at. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -302,7 +287,6 @@ fun Expect.isWritable(): Expect = addAssertion(ExpectImpl.path. * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -325,7 +309,6 @@ fun Expect.isRegularFile(): Expect = addAssertion(ExpectImpl.pa * take place. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -358,7 +341,6 @@ val Expect.extension: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -377,7 +359,6 @@ fun Expect.extension(assertionCreator: Expect.() -> Unit): * @param targetCharset target file encoding - UTF-8 per default. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ @@ -400,7 +381,6 @@ fun Expect.hasSameTextualContentAs( * as [targetPath]. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.12.0 */ diff --git a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/zonedDateTimeAssertions.kt b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/zonedDateTimeAssertions.kt index 7239c1f127..98f33a6b0d 100644 --- a/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/zonedDateTimeAssertions.kt +++ b/misc/deprecated/apis/fluent-en_GB-jdk8/atrium-api-fluent-en_GB-jdk8-jvm/src/main/kotlin/ch/tutteli/atrium/api/fluent/en_GB/jdk8/zonedDateTimeAssertions.kt @@ -36,7 +36,6 @@ val Expect.year: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -68,7 +67,6 @@ val Expect.month: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -100,7 +98,6 @@ val Expect.dayOfWeek: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ @@ -132,7 +129,6 @@ val Expect.day: Expect * returns an [Expect] for the current subject of the assertion. * * @return An [Expect] for the current subject of the assertion. - * @throws AssertionError Might throw an [AssertionError] if the assertion made is not correct. * * @since 0.9.0 */ diff --git a/misc/deprecated/atrium-assertions/src/main/kotlin/ch/tutteli/atrium/assertions/any/typetransformation/AnyTypeTransformation.kt b/misc/deprecated/atrium-assertions/src/main/kotlin/ch/tutteli/atrium/assertions/any/typetransformation/AnyTypeTransformation.kt index e7259fa8c4..696cbf9f26 100644 --- a/misc/deprecated/atrium-assertions/src/main/kotlin/ch/tutteli/atrium/assertions/any/typetransformation/AnyTypeTransformation.kt +++ b/misc/deprecated/atrium-assertions/src/main/kotlin/ch/tutteli/atrium/assertions/any/typetransformation/AnyTypeTransformation.kt @@ -45,8 +45,7 @@ interface AnyTypeTransformation { * @param assertionCreator The lambda which could have created subsequent assertions for the transformed * [AssertionPlant.subject][SubjectProvider.subject]. * - * @throws AssertionError Might throw an [AssertionError] depending on the [subjectPlant]. - */ + */ fun createAndAddAssertionToPlant( warningTransformationFailed: Translatable, subjectPlant: BaseAssertionPlant, diff --git a/misc/deprecated/atrium-assertions/src/main/kotlin/ch/tutteli/atrium/assertions/any/typetransformation/ExplanatoryTypeTransformationFailureHandler.kt b/misc/deprecated/atrium-assertions/src/main/kotlin/ch/tutteli/atrium/assertions/any/typetransformation/ExplanatoryTypeTransformationFailureHandler.kt index a1eeec6948..9d45284297 100644 --- a/misc/deprecated/atrium-assertions/src/main/kotlin/ch/tutteli/atrium/assertions/any/typetransformation/ExplanatoryTypeTransformationFailureHandler.kt +++ b/misc/deprecated/atrium-assertions/src/main/kotlin/ch/tutteli/atrium/assertions/any/typetransformation/ExplanatoryTypeTransformationFailureHandler.kt @@ -33,8 +33,7 @@ class ExplanatoryTypeTransformationFailureHandler : * @param assertionCreator The lambda which could have created subsequent assertions for the down-casted * [AssertionPlant.subject][SubjectProvider.subject]. * - * @throws AssertionError Might throw an [AssertionError] depending on the [subjectPlant]. - */ + */ override fun createAndAddAssertionToPlant( warningTransformationFailed: Translatable, subjectPlant: BaseAssertionPlant, diff --git a/misc/deprecated/domain/api/atrium-domain-api-common/src/main/kotlin/ch/tutteli/atrium/domain/creating/any/typetransformation/AnyTypeTransformation.kt b/misc/deprecated/domain/api/atrium-domain-api-common/src/main/kotlin/ch/tutteli/atrium/domain/creating/any/typetransformation/AnyTypeTransformation.kt index 2ecaf0a003..88ca3a5915 100644 --- a/misc/deprecated/domain/api/atrium-domain-api-common/src/main/kotlin/ch/tutteli/atrium/domain/creating/any/typetransformation/AnyTypeTransformation.kt +++ b/misc/deprecated/domain/api/atrium-domain-api-common/src/main/kotlin/ch/tutteli/atrium/domain/creating/any/typetransformation/AnyTypeTransformation.kt @@ -67,8 +67,7 @@ interface AnyTypeTransformation { * @param parameterObject The [ParameterObject] containing inter alia [ParameterObject.assertionCreator], the * lambda which could have created subsequent assertions for the transformed [AssertionPlant.subject][SubjectProvider.subject]. * - * @throws AssertionError Might throw an [AssertionError] depending on the [ParameterObject.subjectPlant]. - */ + */ fun createAndAddAssertionToPlant(parameterObject: ParameterObject) /** diff --git a/misc/deprecated/domain/api/atrium-domain-api-common/src/main/kotlin/ch/tutteli/atrium/domain/creating/feature/extract/FeatureExtractor.kt b/misc/deprecated/domain/api/atrium-domain-api-common/src/main/kotlin/ch/tutteli/atrium/domain/creating/feature/extract/FeatureExtractor.kt index 6f39e5b1e6..40d847fb09 100644 --- a/misc/deprecated/domain/api/atrium-domain-api-common/src/main/kotlin/ch/tutteli/atrium/domain/creating/feature/extract/FeatureExtractor.kt +++ b/misc/deprecated/domain/api/atrium-domain-api-common/src/main/kotlin/ch/tutteli/atrium/domain/creating/feature/extract/FeatureExtractor.kt @@ -158,7 +158,7 @@ interface FeatureExtractor { * @param extractionNotSuccessful Used as [AssertionGroup.representation] in case [canBeExtracted] * evaluates to false. * @param warningCannotEvaluate The [Translatable] used to explain why the extraction could not be carried out. - + * * @param canBeExtracted Indicates whether it is safe to extract the feature or not (e.g. [Map.containsKey] as * counter part to [Map.get]) * @param featureExtraction The feature extraction as such (e.g. [Map.get], [List.get] etc.)