add samples for optionalExpectations of api-fluent

[robstoll]

Code related feature

With this issue we want to add samples for optionalExpectations.kt of api-fluent

Following the things you need to do:

api-fluent

• create OptionalExpectationSamples in apis/fluent-en_GB/atrium-api-fluent-en_GB-jvm/src/test/kotlin/ch/tutteli/atrium/api/fluent/en_GB/samples
• add one function per function in optionalExpectations.kt (see ListExpectationSamples)
  • for functions having two overloads where one expects an assertionCreator in addition -- add the suffix Feature to the function name of the one not expecting assertionCreator (see ListExpectationSamples)
• refer to the sample in the KDoc of the corresponding function in optionalExpectations.kt via @sample (check out toEqual in anyExpectations.kt to see how you have to refer to the sample)

Your first contribution?

• Write a comment I'll work on this if you would like to take this issue over.
  This way we get the chance to revise the description in case things have changed in the meantime, we might give you additional hints and we can assign the task to you, so that others do not start as well.
• See Your first code contribution for guidelines.
• Do not hesitate to ask questions here or to contact us via Atrium's slack channel if you need help
  (Invite yourself in case you do not have an account yet).

[ghost]

I'll work on this.But i have no idea ,how this gonna happen.But i want to try this once

[ghost]

can u tell me how to start....i m new to github...and opensource too

[robstoll]

See above, the link your first contribution

[ghost]

unable to find ListExpectationSamples

[robstoll]

Have you forked and cloned the project? You should find it easily via search function of your IDE

[ghost]

yes i forked and cloned it.and also foundListExpectationSamples.Now what to do next..i mean what r the function to be made?

[robstoll]

See the description of this issue. it's more or less a one to one step description. Have you created the OptionalExpectationSamples? Once done you do the next step etc.

[ghost]

Yes i made it ....i will try to do it ....and communicate further...if i would not able to do that ...

…

On Tue, 25 May 2021, 1:17 pm Robert Stoll, ***@***.***> wrote: See the description of this issue. it's more or less a one to one step description. Have you created the OptionalExpectationSamples? Once done you do the next step etc. — You are receiving this because you were assigned. Reply to this email directly, view it on GitHub <#917 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AO22KDEXCRVZQ3LGVXZBRKLTPNIYZANCNFSM45K64ADA> .

[robstoll]

In case you run into another problem, then create a draft PR please. This way I see what you have already done and thus better understand what next step you try to achieve.

[robstoll]

@ArcaneOP do you need help?

[ghost]

I have exams....i will start after 10th..sorry for inconvenience..

…

On Mon, 7 Jun 2021, 2:01 pm Robert Stoll, ***@***.***> wrote: @ArcaneOP <https://github.com/ArcaneOP> do you need help? — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#917 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AO22KDB6R2I3EJS5R23NPZDTRR7U7ANCNFSM45K64ADA> .

[robstoll]

No problem at all, no rush, just wanted to be sure you don't have obstacles on the way 🙂

[ghost]

Thank you! For giving me time🙂

…

On Mon, 7 Jun 2021, 2:23 pm Robert Stoll, ***@***.***> wrote: No problem at all, no rush, just wanted to be sure you don't have obstacles on the way 🙂 — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#917 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/AO22KDDWXLFNYVMZDZVPNWTTRSCHDANCNFSM45K64ADA> .

[timacosta]

I'll work on this, seems like the previous person's account got deleted. Assign it if OK.

[robstoll]

@timacosta do you need help with this?

[timacosta]

@robstoll just didn't manage to take over on this yet. Will do this week if there is no rush! If any I'll let you know.

[robstoll]

No rush at all

[timacosta]

@robstoll I've started slowly on this one (didn't have any time until now) and I was wondering how complex you expect these samples to be. I was just dealing a bit with the different functions in optionalSamples.kt and think I got the point. Just asking before going deeper, cause you can actually do it as complex as possible with Optionals.

Let me know and clarify if needed, what kind of use cases are you expecting and I can elaborate from there.

Here is what I did just messing around, simple.

@Test
    fun toBeEmpty() {
        val empty: String? = null
        val opt = Optional.ofNullable(empty)

        expect(opt).toBeEmpty()
    }

    @Test
    fun toBePresent() {
        val notEmpty: String? = "toBePresent"
        val opt = Optional.ofNullable(notEmpty)

        expect(opt).toBePresent()
    }

[robstoll]

Rather simple, take a look at other examples. It's always good to have a passing and a failing sample.

[timacosta]

@robstoll PR - #1031

Comment in the PR if anything is missing or need any re-do. Examples are rather simple but I hope it does the job. Thx