# Coverage for pygeodesy/interns.py : 97%

## 446 statements 431 run 15 missing 11 excluded

Hot-keys on this page

r m x p toggle line displays

j k next/prev highlighted chunk

0 (zero) top of page

1 (one) first highlighted chunk

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248 249 250 251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285 286 287 288 289 290 291 292 293 294 295 296 297 298 299 300 301 302 303 304 305 306 307 308 309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380 381 382 383 384 385 386 387 388 389 390 391 392 393 394 395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448 449 450 451 452 453 454 455 456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472 473 474 475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520 521 522 523 524 525 526 527 528 529 530 531 532 533 534 535 536 537 538 539 540 541 542 543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631 632 | # -*- coding: utf-8 -*- u'''Single-instance C{float}s and C{str}ings, C{intern}'ed across modules. Function L{pygeodesy.machine}. ''' from math import pi as PI, sqrt class _Dash(str): '''(INTERNAL) Extended C{str} for prefix_DASH_. ''' def __call__(self, *args): '''Join C{self} plus all B{C{args}} like C{str.join((self,) + B{args})}. ''' return _DASH_(self, *args) # re-callable class _Join(str): '''(INTERNAL) Extended, callable C{str}. ''' def join_(self, *args): '''Join all B{C{args}} like C{str.join(B{args})}. ''' return _Join(str.join(self, map(str, args))) # re-callable __call__ = join_ class _Prefix(_Join): '''(INTERNAL) Extended C{str} for prefix. ''' def __call__(self, *args): '''Join C{self} plus all B{C{args}} like C{str.join((self,) + B{args})}. ''' return _SPACE_.join_(self, *args) # re-callable class _Python_(str): # overwritten below '''(INTERNAL) Extended C{str} for C{Python} and version. ''' def __call__(self, sys): '''Return C{"Python <version>"}. ''' return _SPACE_(self, sys.version.split()[0]) class _Slicer(str): '''(INTERNAL) String slicer C{.fromX} or C{.tillY}. ''' def __getattr__(self, name): # .fromX, .tillY if name.startswith(_till_): i = self.find(name[len(_till_):]) if 0 < i < len(self): return _Slicer(self[:i + 1]) elif name.startswith(_from_): i = self.find(name[len(_from_):]) if 0 < (i + 1) < len(self): return _Slicer(self[i:]) else: return getattr(str, name) return self class MISSING(object): '''(INTERNAL) Singleton. ''' def toRepr(self, **unused): return self.__class__.__name__ __repr__ = toRepr __str__ = toRepr toStr = toRepr MISSING = MISSING() # PYCHOK singleton MISSING.__name__ = str(MISSING) NN = _Join('') # Nomen Nescio <https://Wiktionary.org/wiki/N.N.> # __DUNDER__-style names would get mangled in classes _0_ = '0' # PYCHOK expected _0to9_ = '0123456789' # PYCHOK expected _1_ = '1' # PYCHOK expected _2_ = '2' # PYCHOK expected _3_ = '3' # PYCHOK expected _4_ = '4' # PYCHOK expected _a_ = 'a' # PYCHOK expected _A_ = 'A' # PYCHOK expected _Airy1830_ = 'Airy1830' # PYCHOK expected _AiryModified_ = 'AiryModified' # PYCHOK expected _an_ = 'an' # PYCHOK expected _angle_ = 'angle' # PYCHOK expected _antipodal_ = 'antipodal' # PYCHOK expected _areaOf_ = 'areaOf' # PYCHOK expected _ambiguous_ = 'ambiguous' # PYCHOK expected # _AMPERSAND_ = _Join('&') # PYCHOK expected # _AND_ = _AMPERSAND_ # PYCHOK expected _and_ = 'and' # PYCHOK expected _at_ = 'at' # PYCHOK expected _AT_ = _Join('@') # PYCHOK expected _AtoZnoIO_ = _Slicer('ABCDEFGHJKLMNPQRSTUVWXYZ') # PYCHOK in C{gars}, C{mgrs} and C{wgrs} _attribute_ = 'attribute' # PYCHOK expected _azi2_ = 'azi2' # PYCHOK expected _azimuth_ = 'azimuth' # PYCHOK expected _b_ = 'b' # PYCHOK expected _B_ = 'B' # PYCHOK expected _band_ = 'band' # PYCHOK expected _BAR_ = _Join('|') # PYCHOK expected _bearing_ = 'bearing' # PYCHOK expected _Bessel1841_ = 'Bessel1841' # PYCHOK expected _by_ = 'by' # PYCHOK expected _c_ = 'c' # PYCHOK expected _C_ = 'C' # PYCHOK expected _cartesian_ = 'cartesian' # PYCHOK expected _center_ = 'center' # PYCHOK expected # _CIRCUMFLEX_ = '^' # PYCHOK expected _Clarke1866_ = 'Clarke1866' # PYCHOK expected _Clarke1880IGN_ = 'Clarke1880IGN' # PYCHOK expected _coincident_ = 'coincident' # PYCHOK expected _colinear_ = 'colinear' # PYCHOK expected _COLON_ = _Join(':') # PYCHOK expected _COLONSPACE_ = _Join(': ') # PYCHOK expected _COMMA_ = _Join(',') # PYCHOK expected _COMMASPACE_ = _Join(', ') # PYCHOK expected _concentric_ = 'concentric' # PYCHOK expected _convergence_ = _Prefix('convergence') # PYCHOK expected _conversion_ = 'conversion' # PYCHOK expected _convex_ = 'convex' # PYCHOK expected _cubic_ = 'cubic' # PYCHOK expected _d_ = 'd' # PYCHOK expected _DASH_ = _Join('-') # PYCHOK == _MINUS_ _datum_ = 'datum' # PYCHOK expected _decode3_ = 'decode3' # PYCHOK expected _deg_ = 'deg' # PYCHOK expected _DEGREE_ = '°' # PYCHOK DMS symbol _degrees_ = 'degrees' # PYCHOK expected _degrees2_ = 'degrees2' # PYCHOK SQUARED _DEQUALSPACED_ = _Join(' == ') # PYCHOK expected _distance_ = 'distance' # PYCHOK expected _distanceTo_ = 'distanceTo' # PYCHOK expected _distant_ = _Prefix('distant') # PYCHOK expected _doesn_t_exist_ = "doesn't exist" # PYCHOK expected _DOT_ = _Join('.') # PYCHOK expected _down_ = 'down' # PYCHOK expected _e_ = 'e' # PYCHOK expected _E_ = 'E' # PYCHOK expected _east_ = 'east' # PYCHOK expected _easting_ = 'easting' # PYCHOK expected _ecef_ = 'ecef' # PYCHOK expected _edge_ = 'edge' # PYCHOK expected _elevation_ = 'elevation' # PYCHOK expected _ELLIPSIS_ = _Join('...') # PYCHOK expected # _ELLIPSISPACED_ = _Join(' ... ') # PYCHOK <https://www.ThePunctuationGuide.com/ellipses.html> _ellipsoid_ = 'ellipsoid' # PYCHOK expected _ellipsoidal_ = 'ellipsoidal' # PYCHOK expected _enabled_ = 'enabled' # PYCHOK expected _encode_ = 'encode' # PYCHOK expected _end_ = 'end' # PYCHOK expected _epoch_ = 'epoch' # PYCHOK expected _EPS_ = 'EPS' # PYCHOK expected _EPS0_ = 'EPS0' # PYCHOK expected _EQUAL_ = _Join('=') # PYCHOK expected _EQUALSPACED_ = _Join(' = ') # PYCHOK expected _exceed_PI_radians_ = 'exceed PI radians' # PYCHOK expected _exceeds_ = _Prefix('exceeds') # PYCHOK expected _exists_ = 'exists' # PYCHOK expected _f_ = 'f' # PYCHOK expected _F_ = 'F' # PYCHOK expected _feet_ = 'feet' # PYCHOK expected _few_ = 'few' # PYCHOK expected _fi_ = 'fi' # PYCHOK expected _finite_ = 'finite' # PYCHOK expected _from_ = 'from' # PYCHOK expected _g_ = 'g' # PYCHOK expected _gamma_ = 'gamma' # PYCHOK expected _GRS80_ = 'GRS80' # PYCHOK expected _h_ = 'h' # PYCHOK expected _H_ = 'H' # PYCHOK expected _height_ = 'height' # PYCHOK expected _hemipole_ = 'hemipole' # PYCHOK expected _i_ = 'i' # PYCHOK expected _I_ = 'I' # PYCHOK expected _iadd_ = '+=' # PYCHOK expected _immutable_ = 'immutable' # PYCHOK expected _in_ = 'in' # PYCHOK expected _INF_ = 'INF' # PYCHOK expected _initial_ = 'initial' # PYCHOK expected _inside_ = 'inside' # PYCHOK expected _intersection_ = 'intersection' # PYCHOK expected _Intl1924_ = 'Intl1924' # PYCHOK expected _invalid_ = 'invalid' # PYCHOK expected _isclockwise_ = 'isclockwise' # PYCHOK expected _ispolar_ = 'ispolar' # PYCHOK expected _j_ = 'j' # PYCHOK expected _k0_ = 'k0' # PYCHOK expected _kind_ = 'kind' # PYCHOK expected _knots_ = 'knots' # PYCHOK expected _Krassovski1940_ = 'Krassovski1940' # PYCHOK expected _Krassowsky1940_ = 'Krassowsky1940' # PYCHOK expected #_LANGLE_ = '<' # PYCHOK expected _lam_ = 'lam' # PYCHOK expected _lat_ = 'lat' # PYCHOK expected _lat0_ = 'lat0' # PYCHOK expected _lat1_ = 'lat1' # PYCHOK expected _lat2_ = 'lat2' # PYCHOK expected _latlon_ = 'latlon' # PYCHOK expected _LatLon_ = 'LatLon' # PYCHOK expected #_LCURLY_ = '{' # PYCHOK LBRACE _len_ = 'len' # PYCHOK expected _linear_ = 'linear' # PYCHOK expected #_LPAREN_ = '(' # PYCHOK expected _lon_ = 'lon' # PYCHOK expected _lon0_ = 'lon0' # PYCHOK expected _lon2_ = 'lon2' # PYCHOK expected #_LSQUARE_ = '[' # PYCHOK LBRACK _ltp_ = 'ltp' # PYCHOK expected _m_ = 'm' # PYCHOK expected _M_ = 'M' # PYCHOK expected _mean_ = 'mean' # PYCHOK expected _meanOf_ = 'meanOf' # PYCHOK expected _meridional_ = 'meridional' # PYCHOK expected _meter_ = 'meter' # PYCHOK expected _meter2_ = 'meter2' # PYCHOK SQUARED _MGRS_ = 'MGRS' # PYCHOK expected _MINUS_ = _DASH_ # PYCHOK expected _MINUTE_ = '′' # PYCHOK DMS symbol _module_ = 'module' # PYCHOK expected _n_ = 'n' # PYCHOK expected _N_ = 'N' # PYCHOK expected _n_a_ = 'n/a' # PYCHOK expected _N_A_ = 'N/A' # PYCHOK expected _NAD27_ = 'NAD27' # PYCHOK expected _NAD83_ = 'NAD83' # PYCHOK expected _name_ = 'name' # PYCHOK expected _NAN_ = 'NAN' # PYCHOK expected _near_ = _Dash('near') # PYCHOK expected _nearestOn2_ = 'nearestOn2' # PYCHOK expected _negative_ = 'negative' # PYCHOK expected _NL_ = _Join('\n') # PYCHOK expected _NL_hash_ = _Join(_NL_ + '# ') # PYCHOK expected _NL_var_ = _Join(_NL_ + '@var ') # PYCHOK expected _NLNL_ = _Join(_NL_) # PYCHOK expected _no_ = _Prefix('no') # PYCHOK expected _north_ = 'north' # PYCHOK expected _northing_ = 'northing' # PYCHOK expected _NorthPole_ = 'NorthPole' # PYCHOK expected _not_ = _Prefix('not') # PYCHOK expected _NTF_ = 'NTF' # PYCHOK expected _null_ = 'null' # PYCHOK expected _number_ = 'number' # PYCHOK expected _numpy_ = 'numpy' # PYCHOK expected _Nv00_ = 'Nv00' # PYCHOK expected _O_ = 'O' # PYCHOK expected _OKd_ = '._-' # PYCHOK expected _on_ = 'on' # PYCHOK expected _opposite_ = 'opposite' # PYCHOK expected _or_ = 'or' # PYCHOK expected _other_ = 'other' # PYCHOK expected _outside_ = 'outside' # PYCHOK expected _overlap_ = 'overlap' # PYCHOK expected _PERCENT_ = '%' # PYCHOK expected _PERCENTDOTSTAR_ = '%.*' # PYCHOK _DOT_(_PERCENT_, _STAR_) _perimeterOf_ = 'perimeterOf' # PYCHOK expected _phi_ = 'phi' # PYCHOK expected _PLUS_ = _Join('+') # PYCHOK expected _PLUSMINUS_ = _PLUS_ + _MINUS_ # PYCHOK expected _point_ = 'point' # PYCHOK expected _points_ = 'points' # PYCHOK expected _pole_ = 'pole' # PYCHOK expected _precision_ = 'precision' # PYCHOK expected _prime_vertical_ = 'prime_vertical' # PYCHOK expected _pygeodesy_abspath_ = 'pygeodesy_abspath' # PYCHOK expected _PyPy__ = 'PyPy ' # PYCHOK + _SPACE_ _Python_ = _Python_('Python') # PYCHOK singleton _QUOTE1_ = "'" # PYCHOK expected _QUOTE2_ = '"' # PYCHOK expected # _QUOTE3_ = "'''" # PYCHOK expected # _QUOTE6_ = '"""' # PYCHOK expected _radians_ = 'radians' # PYCHOK expected _radians2_ = 'radians2' # PYCHOK SQUARED _radius_ = 'radius' # PYCHOK expected _radius1_ = 'radius1' # PYCHOK expected _radius2_ = 'radius2' # PYCHOK expected # _range_ = _Range('range') # moved down #_RANGLE_ = '>' # PYCHOK expected #_RCURLY_ = '}' # PYCHOK RBRACE _reciprocal_ = 'reciprocal' # PYCHOK expected _reframe_ = 'reframe' # PYCHOK expected _resolution_ = 'resolution' # PYCHOK expected _rIn_ = 'rIn' # PYCHOK expected #_RPAREN_ = ')' # PYCHOK expected #_RSQUARE_ = ']' # PYCHOK RBRACK _s_ = 's' # PYCHOK expected _S_ = 'S' # PYCHOK expected _scalar_ = 'scalar' # PYCHOK expected _scale_ = 'scale' # PYCHOK expected _scipy_ = 'scipy' # PYCHOK expected _SECOND_ = '″' # PYCHOK DMS symbol _semi_circular_ = 'semi-circular' # PYCHOK expected _sep_ = 'sep' # PYCHOK expected _singular_ = 'singular' # PYCHOK expected _SLASH_ = _Join('/') # PYCHOK expected _small_ = 'small' # PYCHOK expected _Sphere_ = 'Sphere' # PYCHOK expected _spherical_ = 'spherical' # PYCHOK expected _SouthPole_ = 'SouthPole' # PYCHOK expected _SPACE_ = _Join(' ') # PYCHOK expected _specified_ = 'specified' # PYCHOK expected _STAR_ = _Join('*') # PYCHOK expected _start_ = 'start' # PYCHOK expected _std_ = 'std' # PYCHOK expected _stdev_ = 'stdev' # PYCHOK expected _supported_ = 'supported' # PYCHOK expected _sx_ = 'sx' # PYCHOK expected _sy_ = 'sy' # PYCHOK expected _sz_ = 'sz' # PYCHOK expected _tbd_ = 'tbd' # PYCHOK expected _till_ = 'till' # PYCHOK expected _to_ = 'to' # PYCHOK expected _too_ = _Prefix('too') # PYCHOK expected _transform_ = 'transform' # PYCHOK expected _tx_ = 'tx' # PYCHOK expected _ty_ = 'ty' # PYCHOK expected _tz_ = 'tz' # PYCHOK expected _UNDER_ = _Join('_') # PYCHOK expected _units_ = 'units' # PYCHOK expected _up_ = 'up' # PYCHOK expected _UPS_ = 'UPS' # PYCHOK expected _utf_8_ = 'utf-8' # PYCHOK expected _UTM_ = 'UTM' # PYCHOK expected _V_ = 'V' # PYCHOK expected _valid_ = 'valid' # PYCHOK expected _value_ = 'value' # PYCHOK expected _version_ = 'version' # PYCHOK expected _vs_ = 'vs' # PYCHOK expected __vs__ = ' vs ' # PYCHOK vs-SPACED _W_ = 'W' # PYCHOK expected _WGS72_ = 'WGS72' # PYCHOK expected _WGS84_ = 'WGS84' # PYCHOK expected _width_ = 'width' # PYCHOK expected _x_ = 'x' # PYCHOK expected _X_ = 'X' # PYCHOK expected _xyz_ = 'xyz' # PYCHOK expected _y_ = 'y' # PYCHOK expected _z_ = 'z' # PYCHOK expected _zone_ = 'zone' # PYCHOK expected _EW_ = _E_ + _W_ # PYCHOK common cardinals _NE_ = _N_ + _E_ # PYCHOK expected _NS_ = _N_ + _S_ # PYCHOK expected _NSEW_ = _NS_ + _EW_ # PYCHOK expected _NW_ = _N_ + _W_ # PYCHOK expected _SE_ = _S_ + _E_ # PYCHOK expected _SW_ = _S_ + _W_ # PYCHOK negative ones _DDOT_ = _Join(_DOT_ * 2) # PYCHOK expected # _DEQUAL_ = _Join(_EQUAL_ * 2) # PYCHOK expected _DUNDER_ = _Join(_UNDER_ * 2) # PYCHOK expected class _Range(str): '''(INTERNAL) Extended C{str} for C{range} strings. ''' _Fmt = None # cached .streprs.Fmt def __call__(self, lo, hi, prec=0, lopen=False, ropen=False, join=_COMMASPACE_): '''Return the range as C{"(lo, hi)"}, C{"(lo, hi]"}, C{"[lo, hi)"} or C{"[lo, hi]"}. ''' Fmt = _Range._Fmt if Fmt is None: from pygeodesy.lazily import _ALL_MODS Fmt = _Range._Fmt = _ALL_MODS.streprs.Fmt r = NN(Fmt.f(lo, prec=prec), join, Fmt.f(hi, prec=prec)) if lopen: r = Fmt.PAREN(r) if ropen else Fmt.LOPEN(r) else: r = Fmt.ROPEN(r) if ropen else Fmt.SQUARE(r) return r _range_ = _Range('range') # PYCHOK expected def _dunder_name(inst, *dflt): '''(INTERNAL) Get the double_underscore __name__ attr. ''' try: return inst.__name__ except AttributeError: pass return dflt[0] if dflt else inst.__class__.__name__ def _float(f): # in .datums, .ellipsoids, .trf '''(INTERNAL) cache initial C{float}s. ''' f = float(f) return _floats.setdefault(f, f) # PYCHOK del _floats def _floatuple(*fs): '''(INTERNAL) Cache a tuple of C{float}s. ''' return tuple(map(_float, fs)) _floats = {} # PYCHOK floats cache, in .__main__ # _float = float # PYCHOK expected # del _floats # XXX zap floats cache never _0_0 = _float( 0) # PYCHOK expected _0_001 = _float( 0.001) # PYCHOK expected _0_01 = _float( 0.01) # PYCHOK expected _0_1 = _float( 0.1) # PYCHOK expected _0_125 = _float( 0.125) # PYCHOK expected _0_25 = _float( 0.25) # PYCHOK expected _0_26 = _float( 0.26) # PYCHOK expected _0_5 = _float( 0.5) # PYCHOK expected _1_0 = _float( 1) # PYCHOK expected _1_0_T = _1_0, # PYCHOK 1-tuple _1_5 = _float( 1.5) # PYCHOK expected _2_0 = _float( 2) # PYCHOK expected _3_0 = _float( 3) # PYCHOK expected _4_0 = _float( 4) # PYCHOK expected _5_0 = _float( 5) # PYCHOK expected _6_0 = _float( 6) # PYCHOK expected _8_0 = _float( 8) # PYCHOK expected _9_0 = _float( 9) # PYCHOK expected _10_0 = _float( 10) # PYCHOK expected _16_0 = _float( 16) # PYCHOK expected _24_0 = _float( 24) # PYCHOK expected _32_0 = _float( 32) # PYCHOK expected _60_0 = _float( 60) # PYCHOK expected _90_0 = _float( 90) # PYCHOK expected _120_0 = _float( 120) # PYCHOK expected _180_0 = _float( 180) # PYCHOK expected _270_0 = _float( 270) # PYCHOK expected _360_0 = _float( 360) # PYCHOK expected _400_0 = _float( 400) # PYCHOK expected _720_0 = _float( 720) # PYCHOK expected _1000_0 = _float(1000) # PYCHOK expected _3600_0 = _float(3600) # PYCHOK expected _N_1_0 = _float( -1) # PYCHOK expected _N_2_0 = _float( -2) # PYCHOK expected _N_90_0 = _float( -90) # PYCHOK expected _N_180_0 = _float(-180) # PYCHOK expected try: from sys import float_info as _float_info DIG = _float_info.dig # PYCHOK system's float decimal digits EPS = _float(_float_info.epsilon) # PYCHOK system's EPSilon MANT_DIG = _float_info.mant_dig # PYCHOK system's float mantissa bits MAX = _float(_float_info.max) # PYCHOK system's MAX float 1.7976931348623157e+308 MIN = _float(_float_info.min) # PYCHOK system's MIN float 2.2250738585072014e-308 except (AttributeError, ImportError): # PYCHOK no cover DIG = 15 # PYCHOK system's float decimal digits EPS = _float(2.220446049250313e-16) # PYCHOK EPSilon 2**-52, M{EPS +/- 1 != 1} MANT_DIG = 53 # PYCHOK float mantissa bits ≈ 53 (C{int}) MAX = _float(pow(_2_0, 1023) * (_2_0 - EPS)) # PYCHOK ≈ 10**308 MIN = _float(pow(_2_0, -1022)) # PYCHOK ≈ 10**-308 EPS0 = _float(EPS**2) # PYCHOK near-zero comparison 4.930381e-32, or EPS or EPS_2, see function L{isnear0} EPS02 = _float(EPS**4) # PYCHOK near-zero-squared comparison 2.430865e-63 EPS2 = _float(EPS * _2_0) # PYCHOK ≈ 4.440892098501e-16 EPS4 = _float(EPS * _4_0) # PYCHOK ≈ 8.881784197001e-16 EPS_2 = _float(EPS / _2_0) # PYCHOK ≈ 1.110223024625e-16 EPS1 = _float(_1_0 - EPS) # PYCHOK ≈ 0.9999999999999998 EPS1_2 = _float(_1_0 - EPS_2) # PYCHOK ≈ 0.9999999999999999 # _1EPS = _float(_1_0 + EPS) # PYCHOK ≈ 1.0000000000000002 _1_EPS = _float(_1_0 / EPS) # PYCHOK = 4503599627370496.0 # _2_EPS = _float(_2_0 / EPS) # PYCHOK = 9007199254740992.0 _EPS4e8 = _float(EPS4 * 1e8) # PYCHOK ≈ 8.881784197001e-08 _EPSmin = _float(sqrt(MIN)) # PYCHOK = 1.49166814624e-154 _EPSqrt = _float(sqrt(EPS)) # PYCHOK = 1.49011611938e5-08 _EPStol = _float(_EPSqrt * _0_1) # PYCHOK = 1.49011611938e5-09 == sqrt(EPS * _0_01) INF = _float( _INF_) # PYCHOK INFinity, see function L{isinf}, L{isfinite} NAN = _float( _NAN_) # PYCHOK Not-A-Number, see function L{isnan} NEG0 = float('-0.0') # PYCHOK NEGative 0.0, see function L{isneg0} PI2 = _float(PI * _2_0) # PYCHOK Two PI, M{PI * 2} aka I{Tau} PI3 = _float(PI * _3_0) # PYCHOK Three PI, M{PI * 3} PI3_2 = _float(PI * _1_5) # PYCHOK PI and a half, M{PI * 3 / 2} PI4 = _float(PI * _4_0) # PYCHOK Four PI, M{PI * 4} PI_2 = _float(PI / _2_0) # PYCHOK Half PI, M{PI / 2} PI_4 = _float(PI / _4_0) # PYCHOK Quarter PI, M{PI / 4} R_M = _float(6371008.771415) # PYCHOK mean, spherical earth radius (C{meter}) MANTIS = MANT_DIG # DEPRECATED, use C{MANT_DIG}. __all__ = ('DIG', _EPS_, _EPS0_, 'EPS02', 'EPS1', 'EPS1_2', 'EPS2', 'EPS_2', 'EPS4', 'INF', 'MANT_DIG', 'MANTIS', # DEPRECATED 'MAX', 'MIN', # not 'MISSING'! 'NAN', 'NEG0', 'NN', 'PI', 'PI2', 'PI_2', 'PI3', 'PI3_2', 'PI4', 'PI_4', 'machine') # imported by .lazily __version__ = '22.02.07' _Py2L = _Py3L = None # cached _platform2 and _pythonarchine tuples def _load_lib(name): # must startwith('lib') # macOS 11+ (aka 10.16) no longer provides direct loading of # system libraries, instead it installs the library after a # low-level dlopen(name) call where name is the library base # name. As a result, ctypes.util.find_library can not find # any library not previously dlopen'ed. from ctypes import CDLL from ctypes.util import find_library from sys import platform ns = find_library(name), name if platform[:6] == 'darwin': # and os.name == 'posix' from ctypes import _dlopen from os.path import join ns += (_DOT_(name, 'dylib'), _DOT_(name, 'framework'), join( _DOT_(name, 'framework'), name)) else: # non-macOS def _dlopen(unused): return True for n in ns: try: if n and _dlopen(n): # handle lib = CDLL(n) # == ctypes.cdll.LoadLibrary(n) if lib._name: # has a qualified name return lib except (AttributeError, OSError): pass return None # raise OSError def machine(): '''Return standard C{platform.machine}, but distinguishing Intel from Intel I{emulation} on Apple Silicon (on macOS only). @return: Machine C{'arm64'} for Apple Silicon I{native}, C{'x86_64'} for Intel I{native}, Intel C{"arm64_x86_64"} for Intel I{emulation}, etc. (C{str} with C{comma}s replaced by C{underscore}s). ''' return _platform2()[1] def _platform2(sep=NN): # get platform architecture and machine as C{2-list} or C{str} global _Py2L if _Py2L is None: import platform m = platform.machine() # ARM64, arm64, x86_64, iPhone13,2, etc. m = m.replace(_COMMA_, _UNDER_) if m.lower() == 'x86_64': # on Intel or Rosetta2 ... v = platform.mac_ver() # ... and only on macOS ... if v and _version2(v[0]) > (10, 15): # ... 11+ aka 10.16 # <https://Developer.Apple.com/forums/thread/659846> if _sysctl_uint('sysctl.proc_translated') == 1: # and \ \ # _sysctl_uint('hw.optional.arm64') == 1: # PYCHOK indent m = _UNDER_('arm64', m) # Apple Si emulating Intel x86-64 _Py2L = [platform.architecture()[0], # bits m] # arm64, arm64_x86_64, x86_64, etc. return sep.join(_Py2L) if sep else _Py2L # 2-list def _pythonarchine(sep=NN): # in test/base.py versions # get PyPy and Python versions and C{_platform2} as C{3-} or C{4-list} or C{str} global _Py3L if _Py3L is None: from sys import version # XXX shadows? _Py3L = [_SPACE_(_Python_, version.split(None, 1)[0])] + _platform2() if _PyPy__ in version: # see test/base.py _Py3L = [NN(_PyPy__, version.split(_PyPy__)[1].split()[0])] + _Py3L return sep.join(_Py3L) if sep else _Py3L # 3- or 4-list def _sysctl_uint(name): # get an unsigned int sysctl item by name, use on macOS ONLY! libc = _load_lib('libc') if libc: # <https://StackOverflow.com/questions/759892/python-ctypes-and-sysctl> from ctypes import byref, c_char_p, c_size_t, c_uint, sizeof # get_errno n = name if str is bytes else bytes(name, _utf_8_) # PYCHOK isPython2 = str is bytes u = c_uint(0) z = c_size_t(sizeof(u)) r = libc.sysctlbyname(c_char_p(n), byref(u), byref(z), None, c_size_t(0)) else: # could find or load 'libc' r = -2 return int(r if r else u.value) # -1 ENOENT error, -2 no libc def _usage(file_py): # build "usage: python ..." cmd line for module B{C{file_py}} import os, sys # PYCHOK imports p = NN('python', sys.version_info[0]) m = os.path.dirname(file_py).replace(os.getcwd(), _ELLIPSIS_).strip() if len(m.split()) > 1: m = NN(_QUOTE2_, m, _QUOTE2_) # == streprs.Fmt.QUOTE2(m) return _SPACE_('usage:', p, '-m', m.replace(os.sep, _DOT_)) def _version2(version, n=2): # split C{B{version} str} into 1-, 2- or 3-tuple of C{int}s t = (tuple(map(int, version.split(_DOT_)[:n])) if version else ()) + (0, 0, 0) return t[:n] # **) MIT License # # Copyright (C) 2016-2022 -- mrJean1 at Gmail -- All Rights Reserved. # # Permission is hereby granted, free of charge, to any person obtaining a # copy of this software and associated documentation files (the "Software"), # to deal in the Software without restriction, including without limitation # the rights to use, copy, modify, merge, publish, distribute, sublicense, # and/or sell copies of the Software, and to permit persons to whom the # Software is furnished to do so, subject to the following conditions: # # The above copyright notice and this permission notice shall be included # in all copies or substantial portions of the Software. # # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS # OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, # FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL # THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR # OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, # ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR # OTHER DEALINGS IN THE SOFTWARE.