[Bug 32125] Should support auth using captcha

[bugzilla-daemon at freedesktop.org]

https://bugs.freedesktop.org/show_bug.cgi?id=32125

--- Comment #2 from Simon McVittie <simon.mcvittie at collabora.co.uk> 2012-01-25 09:21:30 PST ---
Sketch of an ocr-only interface for this:

property CanRefreshCaptcha: b, readable, immutable

property CaptchaStatus: u, readable, change notification
    enum { Local_Pending, Remote_Pending, Succeeded, Try_Again, Failed }

property CaptchaError: s, DBus_Error_Name
    "" in all states except Try_Again and Failed.
    Typical values: "", Cancelled, AuthenticationFailed, NotAvailable.

property CaptchaErrorDetails: a{sv}
    Just like for Connection.ConnectionError.

GetCaptcha() -> ay, s
    Callable in state Local_Pending or Try_Again only. Return a captcha.
    State changes to Local_Pending, error changes to nothing.
    If called repeatedly, fails with NotAvailable unless CanRefreshCaptcha.

    [Rationale for not being a property: not immutable, because
    some captcha implementations let you try another if you can't
    read the first.]

AnswerCaptcha(s) -> nothing
    Callable in state Local_Pending only. State changes to Remote_Pending.

CancelCaptcha(u: enum { User_Cancelled, Not_Supported }) -> nothing
    Cancel. State changes to Failed with error NotAvailable or Cancelled
    if it isn't already Failed. All you can do now is to close the channel.

Channel.Close() does the equivalent of CancelCaptcha(Not_Supported) if not
already Failed, then closes the channel.

-- 
Configure bugmail: https://bugs.freedesktop.org/userprefs.cgi?tab=email
------- You are receiving this mail because: -------
You are the QA Contact for the bug.
You are the assignee for the bug.