Fails the test because of the quote style.

I have simple wrapper function to the US census library:

def state_info(state):
    """
    Given a the full name of a state, returns the corresponding abbreviation and FIPS code.

    Example:

    >>> state_info("texas")
    ("TX", "48")
    """
    abbrev = states.mapping("name", "abbr").get(state.title())
    st = states.lookup(abbrev)
    fips = st.fips
    return (abbrev, fips)

However xdoctest fails because the of quoting style:

DOCTEST PART BREAKDOWN
Failed Part:
    2 >>> state_info("texas")
DOCTEST TRACEBACK
Expected:
    ("TX", "48")
Got:
    ('TX', '48')
Repr Difference:
    got  = "('TX', '48')"
    want = '("TX", "48")'

Since the expected value matches my output, I thought the test would pass.

[Erotemic]

FWIW, the style of the expected “want” string isn’t enforced by black, and it would be more accurate to use the quoting style there that the actual Python interpreter outputs. Also, there is nothing stopping you from simply writing:

def state_info(state):
    """
    Given a the full name of a state, returns the corresponding abbreviation and FIPS code.

    Example:

    >>> assert state_info("texas") == ("TX", "48")
    """
    abbrev = states.mapping("name", "abbr").get(state.title())
    st = states.lookup(abbrev)
    fips = st.fips
    return (abbrev, fips)

And that has the advantage that it can be refactored as a unit test verbatim. The other alternative - if you simply want this for more documentation purposes, is to remove the check entirely and rely on unit tests to actually check cases:

def state_info(state):
    """
    Given a the full name of a state, returns the corresponding abbreviation and FIPS code.

    Example:

    >>> state_info("texas")  # xdoctest: +IGNORE_WANT
    ("TX", "48")
    """
    abbrev = states.mapping("name", "abbr").get(state.title())
    st = states.lookup(abbrev)
    fips = st.fips
    return (abbrev, fips)

But if you want to extend the checker, all of the logic lives here:

https://github.com/Erotemic/xdoctest/blob/main/src/xdoctest/checker.py

It probably also makes sense to add a directive:

https://github.com/Erotemic/xdoctest/blob/main/src/xdoctest/directive.py

which is disabled by default (maybe call it NORMALIZE_QUOTES?) and can be specified to enable this behavior.

[rgreinho]

Thank you very much! I did use the first alternative you suggested and it worked like a charm. 👍