add consumer key helpers

[yadutaf]

Following discussion with @VincentCasse on php-ovh-sms, here is a design proposal for improved consumer key helper. See Readme and test for examples. But, in a nutshell, it allows to build autorization requests for a given api endpoint prefix and and all sub-path or only the specific route.

ReadOnly is mapped to "GET". ReadWrite to all HTTP Methods.

This PR is about the design itself. If we all agree, we'll implement this in the other wrappers.

At a later time, we may consider human readable aliases for sections of /me and /auth like

• "identity"
• "billing"
• "credentials"
  ...

ping @gregdel, @VincentCasse

[PouuleT]

Typo, xdsl -> me

[yadutaf]

Fixed. Thx.

[yadutaf]

Adding @LukeMarlin to the discussion for C# wrapper

[LukeMarlin]

Cool feature. Only problem for me is that it can be too restrictive (RW contains too much). I'd add an overloaded method taking custom verbs as a String[]

[gregdel]

It's only helpers, the goal is to make the developer life easier. There is still a "AddRule" method for fine-grained right control.

[LukeMarlin]

Sure, but AddRule does not support the nice recurse param.

[yadutaf]

Only problem for me is that it can be too restrictive (RW contains too much)

Would it be better with like an intermediate ReadWriteDelete?

[VincentCasse]

yep, distinct delete could ba a good thing.. Maybe distinct write and others actions ? but i don't know how

[yadutaf]

Adding ReadWriteSafe without the Delete

[yadutaf]

v2 pushed with Typo fixes from @gregdel and @PouuleT and intermediate authorization level suggested by @LukeMarlin.

[PouuleT]

Why not do something like
AddRules([]string{"GET","POST","PUT"}, "/sms")
and
AddRecursiveRules([]string{"GET","POST","PUT", "/sms")

[yadutaf]

API could be like:

const ( 
    ReadOnly      = []string{"GET"}
    ReadWrite     = []string{"GET", "POST", "PUT", "DELETE"}
    ReadWriteSafe = []string{"GET", "POST", "PUT"}
)

func AddRule(verb, pattern string)                  {}
func AddRules(verbs []string, pattern string)       {}    
func AddRecursiveRules(verbs []string, path string) {}

Go ?

[LukeMarlin]

Exactly, +1

[yadutaf]

@cygy does is look good to you too for Swift wrapper ?

[cygy]

I have already some helpers but I can update if needed.
Seems good.

[yadutaf]

And there it is. I much prefer this new API anyway. Less code, less magic. As far as I'm concerned, we're ready to go.

[gregdel]

This should be:

ckReq.AddRecursiveRules(ovh.ReadOnly, "/xdsl")

To match the comment above

[yadutaf]

Damn it. Ur right.

[yadutaf]

Fixed.

[yadutaf]

As far as I'm concerned: Ready.

[gregdel]

Merged, thanks @yadutaf. Good work !

[yadutaf]

\o/ Starting Python version.