danielsaidi / MockingKit

MockingKit is a Swift SDK that lets you easily mock protocols and classes in `Swift`.
MIT License
87 stars 7 forks source link

Tiny suggestion: wording `invokation` to `invocation` or `execution` #11

Closed jinuman closed 3 years ago

jinuman commented 3 years ago

Hi. First of all, I really appreciate what you've done.

Would you mind if I change the name of invokation to invocation or execution?

Because I googled the word invokation and it means nothing in real language.

If there was no intention and it was only a mistake of you, I'd be happy to create PR.

danielsaidi commented 3 years ago

Hi Kim,

Happy to hear that you like it!

Oh my 🤭 I've been blind, since invocation is invokation in Swedish. I just haven't thought of it. Thank you for noticing and letting me know!

I can absolutely rename it to invocation and deprecate the old members, but while we're having this conversation, perhaps we can find an even better name? I never liked invoke and invocation anyways and think it's just too technical. I used execute/execution in the early days, but didn't like that either.

I'm wondering if call and calls would be better? At least it's shorter. If you like call, perhaps we should go with that?

jinuman commented 3 years ago

Sounds wonderful. I didn't know that was the word used in Swedish 😅 Thank you for your kindness reply.

In my opinion, it'd be good to decide more easy and standard word to make this great solution more popular 😁

Sooner or later in my convenient time, I can rename and create PR if you are busy. Then, we can consider more after PR.

danielsaidi commented 3 years ago

Perhaps I can do the following later tonight, and send a link for you to look at?

Perhaps it's easier to discuss the call semantic once we have it in place?

I really appreciate your feedback!

jinuman commented 3 years ago

Thanks! Either would be good for me.

danielsaidi commented 3 years ago

Hi again! I went with the call name, which gives the following changes:

The old parts are still around, but deprecated. I didn't create invocation functions, since adding things and deprecating them at the same time seemed like a waste :)

I think this is a LOT better, but I'd love to hear what you think before creating a 0.9. You can check it out in master.

jinuman commented 3 years ago

Hi. Thanks for your working.

It looks like you changed Argument label as well. I'm not English-speaking native person but it sounds little unfamilliar for me so in my little opinion, I don't think argument label should be changed. Please let me know if I'm wrong.

So what I suggest is just rollback only argument label.

Other than that, It looks good to me. 👏👏

danielsaidi commented 3 years ago

I think that both to and for are correct, but they're semantically different. to implies that you will get/reset calls that have been made TO a function. for implements that you will get/reset calls FOR a certain reference.

I will give this some more thought.

I agree with the times though. Rolling back that one. 👍

jinuman commented 3 years ago

Okay! to: will be great. Thanks for explanation 👍

danielsaidi commented 3 years ago

Perfect! I'll merge and create a new minor version.

danielsaidi commented 3 years ago

@jinuman I have released this as 0.9. Thank you for pointing this out! 🥳