6lj VSrSSKJr SSKrSSKJrJr SSKJr S Sjr S Sjr S Sjr g) aReading a printed figure as a number. The only place that does it. A figure printed in a filing carries a currency sign, thousands separators, a percent sign, a trailing multiple, or parentheses standing in for a minus. Every consumer of an answer wants the number underneath: a spreadsheet column, a comparison against a gold value, an arithmetic check. Each of those wanting its own conversion is how the same figure comes out with two different values, and the way they differ is by sign. So there is one function, and everything that needs a number calls it. It is not a model's job either: the conversion is deterministic, and a model asked for it alongside the figure returns the figure reliably and the number only most of the time, which is a hole in a column no one can predict. ) annotationsN)DecimalInvalidOperation)Optionalc`[R"SSU=(d SR55$)z@Trim and collapse whitespace, for comparing two printed figures.z\s+ )resubstripss >/home/mande/repo/quber/src/quber/playground/answers/figures.py norm_printedrs 66&#R0 11cU(dg[R"SS[U55nURS5=(a UR S5nUR S5n[R"SSU5n[R"SSU5n[R "S U5(dg[U5nU(aU*$U$![a gf=f) a=The numeric value of a printed figure, or None if it is not numeric. Parentheses mean negative, as financial statements print them. Currency signs, thousands separators, percent signs and a trailing multiple 'x' are dropped; a figure carrying a scale word keeps only its digits, so '$1.2 million' reads as 1.2 and is compared against a gold that prints the same way. A percentage keeps the magnitude it was printed with: '92.6%' is 92.6, not 0.926. Nothing here rescales a figure, because a reader checking a row against the filing is comparing it to what the page says. Nz[$,%\s]r ()z()z[xX]$z+(?i)(million|billion|thousand|mm|bn|[mbk])$z ^-?\d*\.?\d+$) r r r startswithendswithr matchrr)rtnegvs r as_numberrs  z2|A/A ,,s  / 3C  A xQA =r1EA 88$a ( ( AJA2! s2 C CCc6[U5RS5$)uWhether a printed figure is a percentage. A spreadsheet given '92.6%' stores the fraction and formats the cell as a percentage, so the figure both computes as a rate and displays as the document printed it. Given a bare 92.6 it stores ninety-two point six, which is not the rate. So an export has to know which figures keep their sign, and this is the test — a question about notation, never about magnitude. %)rrr s r is_percentr<s ? # #C ((r)r Optional[str]returnstr)rrr zOptional[Decimal])rrr bool) __doc__ __future__rr decimalrrtypingrrrrrrr(s( # -2 @ )r