1# -*- coding: utf-8 -*-

2

3 u'''Single C{str}ing constants, C{intern}'ed across C{pygeodesy}

4 modules and function L{pygeodesy.machine}.

5'''

6 import sys as _sys

7 try:

8 _intern = intern # PYCHOK in .lazily, .trf

9 except NameError: # Python 3+

10 _intern = _sys.intern

11

12_COMMASPACE_ = ', ' # overriden below

13_sub_packages = 'auxilats', 'deprecated', 'geodesicx', 'rhumb' # PYCHOK in .lazily,

14# ... make._dist, MANIFEST, setup.setup, test.bases, test.testModules

15

16

17 class _Dash(str):

18 '''(INTERNAL) Extended C{str} for prefix_DASH_.

19 '''

20 def __call__(self, *args):

21 '''Join C{self} plus all B{C{args}} like C{'-'.join((self,) + B{args})}.

22 '''

23 return _DASH_(self, *args) # re-callable

24

25

26 class _Int(int):

27 '''(INTERNAL) Unique C{int}.

28 '''

29 pass

30

31

32 class Str_(str):

33 '''Extended, I{callable} C{str} class, not nameable.

34

35 @see: Nameable and callable class L{pygeodesy.Str}.

36 '''

37 def join_(self, *args):

38 '''Join all positional B{C{args}} like C{self.join(B{args})}.

39

40 @return: All B{C{args}} joined by this instance (L{Str_}).

41

42 @note: An other L{Str_} instance is returned to make the

43 result re-callable.

44 '''

45 return Str_(str.join(self, map(str, args))) # re-callable

46

47 __call__ = join_

48

49 NN = Str_('') # PYCHOK Nomen Nescio <https://Wiktionary.org/wiki/N.N.>

50

51

52 class _Prefix(Str_):

53 '''(INTERNAL) Extended C{str} for prefix.

54 '''

55 def __call__(self, *args):

56 '''Join C{self} plus all B{C{args}} like C{" ".join((self,) + B{args})}.

57 '''

58 return _SPACE_.join_(self, *args) # re-callable

59

60

61 class _PyPy__(str): # overwritten by singleton below

62 '''(INTERNAL) Extended C{str} for C{"PyPy"} and version.

63 '''

64 def __call__(self, version=NN):

65 '''Return C{"PyPy <version>"} or C{NN}.

66 '''

67 v = version or _sys.version

68 if _PyPy__ in v:

69 v = v.split(_PyPy__)[1].split(None, 1)[0] # == _DOT_.join(_sys.pypy_version_info[:3])

70 return NN(_PyPy__, v)

71 else:

72 return NN

73

74

75 class _Python_(str): # overwritten by singleton below

76 '''(INTERNAL) Extended C{str} for C{"Python"} and version.

77 '''

78 def __call__(self, version=NN):

79 '''Return C{"Python <version>"}.

80 '''

81 v = version or _sys.version

82 return _SPACE_(self, v.split(None, 1)[0])

83

84

85 class _Range(str):

86 '''(INTERNAL) Extended C{str} for C{range} strings.

87 '''

88 def __call__(self, lo, hi, lopen=False, ropen=False,

89 prec=0, sep=_COMMASPACE_):

90 '''Return the range as C{"(lo, hi)"}, C{"(lo, hi]"},

91 C{"[lo, hi)"} or C{"[lo, hi]"}.

92 '''

93 from pygeodesy.streprs import Fmt

94 r = NN(Fmt.f(lo, prec=prec), sep,

95 Fmt.f(hi, prec=prec))

96 f = (Fmt.PAREN if ropen else Fmt.LOPEN) if lopen else \

97 (Fmt.ROPEN if ropen else Fmt.SQUARE)

98 return f(r)

99

100

101 class _Slicer(str):

102 '''(INTERNAL) String slicer C{.fromX} or C{.tillY}.

103 '''

104 def __getattr__(self, name): # .fromX, .tillY

105 n = len(name) - 4

106 if n > 0:

107 # assert len('till') == len(_from_) == 4

108 if name.startswith('till'):

109 i = self.find(name[4:])

110 return self if i < 0 else _Slicer(self[:i + n])

111 elif name.startswith(_from_):

112 i = self.find(name[4:])

113 return self if i < 0 else _Slicer(self[i:])

114 return str.__getattr__(self, name) # PYCHOK no cover

115

116

117 class MISSING(object):

118 '''(INTERNAL) Singleton C{str}.

119 '''

120 def toRepr(self, **unused):

121 return self.__class__.__name__

122

123 __repr__ = __str__ = toStr = toRepr

124

125 MISSING = MISSING() # PYCHOK singleton

126 MISSING.__name__ = str(MISSING)

127

128# __DUNDER__-style names would get mangled in classes

129_0_ = '0' # PYCHOK 'zero'

130_0to9_ = '0123456789' # PYCHOK OK

131_1_ = '1' # PYCHOK OK

132_2_ = '2' # PYCHOK OK

133_3_ = '3' # PYCHOK OK

134_4_ = '4' # PYCHOK OK

135_a_ = 'a' # PYCHOK OK

136_A_ = 'A' # PYCHOK OK

137_a12_ = 'a12' # PYCHOK OK

138_area_ = 'area' # PYCHOK OK

139_Airy1830_ = 'Airy1830' # PYCHOK OK

140_AiryModified_ = 'AiryModified' # PYCHOK OK

141_ambiguous_ = 'ambiguous' # PYCHOK OK

142_AMPERSAND_ = Str_('&') # PYCHOK OK

143_an_ = 'an' # PYCHOK OK

144_and_ = 'and' # PYCHOK OK

145# _AND_ = _AMPERSAND_ # PYCHOK OK

146_angle_ = 'angle' # PYCHOK OK

147_antipodal_ = 'antipodal' # PYCHOK OK

148_areaOf_ = 'areaOf' # PYCHOK OK

149_arg_ = 'arg' # PYCHOK OK

150# _ASTERISK_ = _STAR_ # PYCHOK OK

151_AT_ = Str_('@') # PYCHOK OK

152_AtoZnoIO_ = _Slicer('ABCDEFGHJKLMNPQRSTUVWXYZ') # PYCHOK in .gars, .mgrs and .wgrs

153_attribute_ = 'attribute' # PYCHOK OK

154_azi1_ = 'azi1' # PYCHOK OK

155_azi12_ = 'azi12' # PYCHOK OK

156_azi2_ = 'azi2' # PYCHOK OK

157_azimuth_ = 'azimuth' # PYCHOK OK

158_b_ = 'b' # PYCHOK OK

159_B_ = 'B' # PYCHOK OK

160_BACKSLASH_ = Str_('\\') # PYCHOK OK

161_band_ = 'band' # PYCHOK OK

162_BANG_ = Str_('!') # PYCHOK OK

163_BAR_ = Str_('|') # PYCHOK OK

164_bearing_ = 'bearing' # PYCHOK OK

165_Bessel1841_ = 'Bessel1841' # PYCHOK OK

166_beta_ = 'beta' # PYCHOK OK

167_by_ = 'by' # PYCHOK OK

168_c_ = 'c' # PYCHOK OK

169_C_ = 'C' # PYCHOK OK

170_cartesian_ = 'cartesian' # PYCHOK OK

171_center_ = 'center' # PYCHOK OK

172# _CIRCUMFLEX_ = Str_('^') # PYCHOK OK

173_Clarke1866_ = 'Clarke1866' # PYCHOK OK

174_Clarke1880IGN_ = 'Clarke1880IGN' # PYCHOK OK

175_clip_ = 'clip' # PYCHOK OK

176_clipid_ = 'clipid' # PYCHOK OK

177_coincident_ = 'coincident' # PYCHOK OK

178_colinear_ = 'colinear' # PYCHOK OK

179_COLON_ = Str_(':') # PYCHOK OK

180_COLONSPACE_ = Str_(': ') # PYCHOK OK

181_COMMA_ = Str_(',') # PYCHOK OK

182_COMMASPACE_ = Str_(_COMMASPACE_) # PYCHOK OK

183_composite_ = 'composite' # PYCHOK OK

184_concentric_ = 'concentric' # PYCHOK OK

185_convergence_ = _Prefix('convergence') # PYCHOK OK

186_conversion_ = 'conversion' # PYCHOK OK

187_convex_ = 'convex' # PYCHOK OK

188_cubic_ = 'cubic' # PYCHOK OK

189_d_ = 'd' # PYCHOK OK

190_D_ = 'D' # PYCHOK OK

191_DASH_ = Str_('-') # PYCHOK == _MINUS_

192_datum_ = 'datum' # PYCHOK OK

193_decode3_ = 'decode3' # PYCHOK OK

194_deg_ = 'deg' # PYCHOK OK

195_degrees_ = 'degrees' # PYCHOK OK

196_degrees2_ = 'degrees2' # PYCHOK SQUARED

197_delta_ = 'delta' # PYCHOK OK

198_DEPRECATED_ = 'DEPRECATED' # PYCHOK OK

199_DEQUALSPACED_ = Str_(' == ') # PYCHOK OK

200_distance_ = 'distance' # PYCHOK OK

201_distant_ = _Prefix('distant') # PYCHOK OK

202_doesn_t_exist_ = "doesn't exist" # PYCHOK OK

203_DOT_ = Str_('.') # PYCHOK OK

204_down_ = 'down' # PYCHOK OK

205_e_ = 'e' # PYCHOK OK

206_E_ = 'E' # PYCHOK OK

207_earth_ = 'earth' # PYCHOK OK

208_east_ = 'east' # PYCHOK OK

209_easting_ = 'easting' # PYCHOK OK

210_ecef_ = 'ecef' # PYCHOK OK

211_edge_ = 'edge' # PYCHOK OK

212_elevation_ = 'elevation' # PYCHOK OK

213_ELLIPSIS_ = Str_('...') # PYCHOK OK

214_ELLIPSIS4_ = Str_('....') # PYCHOK OK

215# _ELLIPSISPACED_ = Str_(' ... ') # PYCHOK <https://www.ThePunctuationGuide.com/ellipses.html>

216_ellipsoid_ = 'ellipsoid' # PYCHOK OK

217_ellipsoidal_ = 'ellipsoidal' # PYCHOK OK

218_enabled_ = 'enabled' # PYCHOK OK

219_encode_ = 'encode' # PYCHOK OK

220_end_ = 'end' # PYCHOK OK

221_epoch_ = 'epoch' # PYCHOK OK

222_eps_ = 'eps' # PYCHOK OK

223_EQUAL_ = Str_('=') # PYCHOK OK

224_EQUALSPACED_ = Str_(' = ') # PYCHOK OK

225_Error_ = 'Error' # PYCHOK OK

226_exceed_PI_radians_ = 'exceed PI radians' # PYCHOK OK

227_exceeds_ = _Prefix('exceeds') # PYCHOK OK

228# _EXCLAMATION_ = _BANG_ # PYCHOK OK

229_exists_ = 'exists' # PYCHOK OK

230_f_ = 'f' # PYCHOK OK

231_F_ = 'F' # PYCHOK OK

232_feet_ = 'feet' # PYCHOK OK

233_few_ = 'few' # PYCHOK OK

234_fi_ = 'fi' # PYCHOK OK

235_finite_ = 'finite' # PYCHOK OK

236_from_ = 'from' # PYCHOK OK

237_g_ = 'g' # PYCHOK OK

238_gamma_ = 'gamma' # PYCHOK OK

239_GRS80_ = 'GRS80' # PYCHOK OK

240_h_ = 'h' # PYCHOK OK

241_H_ = 'H' # PYCHOK OK

242_HASH_ = '#' # PYCHOK OK

243_height_ = 'height' # PYCHOK OK

244_hemipole_ = 'hemipole' # PYCHOK OK

245_i_ = 'i' # PYCHOK OK

246_immutable_ = 'immutable' # PYCHOK OK

247_in_ = 'in' # PYCHOK OK

248_incompatible_ = 'incompatible' # PYCHOK OK

249_INF_ = 'INF' # PYCHOK OK

250_infinite_ = 'infinite' # PYCHOK _not_finite_

251_initial_ = 'initial' # PYCHOK OK

252_inside_ = 'inside' # PYCHOK OK

253_insufficient_ = 'insufficient' # PYCHOK OK

254_intersection_ = 'intersection' # PYCHOK OK

255_Intl1924_ = 'Intl1924' # PYCHOK OK

256_invalid_ = 'invalid' # PYCHOK OK

257_invokation_ = 'invokation' # PYCHOK OK

258_isclockwise_ = 'isclockwise' # PYCHOK OK

259_ispolar_ = 'ispolar' # PYCHOK OK

260_j_ = 'j' # PYCHOK OK

261_k0_ = 'k0' # PYCHOK OK

262_kind_ = 'kind' # PYCHOK OK

263_knots_ = 'knots' # PYCHOK OK

264_Krassovski1940_ = 'Krassovski1940' # PYCHOK OK

265_Krassowsky1940_ = 'Krassowsky1940' # PYCHOK OK

266_LANGLE_ = '<' # PYCHOK OK

267_lam_ = 'lam' # PYCHOK OK

268_lat_ = 'lat' # PYCHOK OK

269_lat0_ = 'lat0' # PYCHOK OK

270_lat1_ = 'lat1' # PYCHOK OK

271_lat2_ = 'lat2' # PYCHOK OK

272_latlon_ = 'latlon' # PYCHOK OK

273_LatLon_ = 'LatLon' # PYCHOK OK

274_LCURLY_ = '{' # PYCHOK LBRACE

275_len_ = 'len' # PYCHOK OK

276_limit_ = 'limit' # PYCHOK OK

277_line_ = 'line' # PYCHOK OK

278_linear_ = 'linear' # PYCHOK OK

279_LPAREN_ = '(' # PYCHOK OK

280_lon_ = 'lon' # PYCHOK OK

281_lon0_ = 'lon0' # PYCHOK OK

282_lon1_ = 'lon1' # PYCHOK OK

283_lon2_ = 'lon2' # PYCHOK OK

284_low_ = 'low' # PYCHOK OK

285_LSQUARE_ = '[' # PYCHOK LBRACK

286_ltp_ = 'ltp' # PYCHOK OK

287_m_ = 'm' # PYCHOK OK

288_M_ = 'M' # PYCHOK OK

289_m12_ = 'm12' # PYCHOK OK

290_M12_ = 'M12' # PYCHOK OK

291_M21_ = 'M21' # PYCHOK OK

292_MANT_DIG_ = 'MANT_DIG' # PYCHOK OK

293_MAX_ = 'MAX' # PYCHOK OK

294_mean_ = 'mean' # PYCHOK OK

295_meanOf_ = 'meanOf' # PYCHOK OK

296_meridional_ = 'meridional' # PYCHOK OK

297_meter_ = 'meter' # PYCHOK OK

298_meter2_ = 'meter2' # PYCHOK SQUARED

299_MGRS_ = 'MGRS' # PYCHOK OK

300_MIN_ = 'MIN' # PYCHOK OK

301_MINUS_ = _DASH_ # PYCHOK OK

302_module_ = 'module' # PYCHOK OK

303_n_ = 'n' # PYCHOK OK

304_N_ = 'N' # PYCHOK OK

305_n_a_ = 'n/a' # PYCHOK OK

306_N_A_ = 'N/A' # PYCHOK OK

307_NAD27_ = 'NAD27' # PYCHOK OK

308_NAD83_ = 'NAD83' # PYCHOK OK

309_name_ = 'name' # PYCHOK OK

310_NAN_ = 'NAN' # PYCHOK OK

311_near_ = _Dash('near') # PYCHOK OK

312_nearestOn2_ = 'nearestOn2' # PYCHOK OK

313_negative_ = 'negative' # PYCHOK OK

314_NL_ = Str_('\n') # PYCHOK OK

315_NLATvar_ = Str_(_NL_ + '@var ') # PYCHOK OK

316_NLHASH_ = Str_(_NL_ + '# ') # PYCHOK OK

317# _NLNL_ = _DNL_ # PYCHOK OK

318_NN_ = 'NN' # PYCHOK OK

319_no_ = _Prefix('no') # PYCHOK OK

320_north_ = 'north' # PYCHOK OK

321_northing_ = 'northing' # PYCHOK OK

322_NorthPole_ = 'NorthPole' # PYCHOK OK

323_not_ = _Prefix('not') # PYCHOK OK

324_NOTEQUAL_ = _BANG_ + _EQUAL_ # PYCHOK OK

325_not_finite_ = 'not finite' # PYCHOK _not_(_finite_), _infinite_

326_not_scalar_ = 'not scalar' # PYCHOK _not_(_scalar_)

327_NTF_ = 'NTF' # PYCHOK OK

328_null_ = 'null' # PYCHOK OK

329_number_ = 'number' # PYCHOK OK

330_numpy_ = 'numpy' # PYCHOK OK

331_Nv00_ = 'Nv00' # PYCHOK OK

332_odd_ = 'odd' # PYCHOK OK

333_of_ = 'of' # PYCHOK OK

334_on_ = 'on' # PYCHOK OK

335_opposite_ = 'opposite' # PYCHOK OK

336_or_ = 'or' # PYCHOK OK

337_other_ = 'other' # PYCHOK OK

338_outside_ = 'outside' # PYCHOK OK

339_overlap_ = 'overlap' # PYCHOK OK

340_parallel_ = 'parallel' # PYCHOK OK

341_PERCENT_ = '%' # PYCHOK OK

342_PERCENTDOTSTAR_ = '%.*' # PYCHOK _DOT_(_PERCENT_, _STAR_)

343_phi_ = 'phi' # PYCHOK OK

344_PLUS_ = Str_('+') # PYCHOK OK

345_PLUSMINUS_ = _PLUS_ + _MINUS_ # PYCHOK OK

346_point_ = 'point' # PYCHOK OK

347_points_ = 'points' # PYCHOK OK

348_pole_ = 'pole' # PYCHOK OK

349_precision_ = 'precision' # PYCHOK OK

350_prime_vertical_ = 'prime_vertical' # PYCHOK OK

351_pygeodesy_ = 'pygeodesy' # PYCHOK OK

352_pygeodesy_abspath_ = 'pygeodesy_abspath' # PYCHOK OK

353_PyPy__ = _PyPy__('PyPy ') # PYCHOK + _SPACE_

354_Python_ = _Python_('Python') # PYCHOK singleton

355_python_ = 'python' # PYCHOK OK

356_QUOTE1_ = "'" # PYCHOK OK

357_QUOTE2_ = '"' # PYCHOK OK

358# _QUOTE3_ = "'''" # PYCHOK OK

359# _QUOTE6_ = '"""' # PYCHOK OK

360_R_ = 'R' # PYCHOK OK

361_radians_ = 'radians' # PYCHOK OK

362_radians2_ = 'radians2' # PYCHOK SQUARED

363_radius_ = 'radius' # PYCHOK OK

364_radius1_ = 'radius1' # PYCHOK OK

365_radius2_ = 'radius2' # PYCHOK OK

366_range_ = _Range('range') # PYCHOK OK

367_RANGLE_ = '>' # PYCHOK OK

368_RCURLY_ = '}' # PYCHOK RBRACE

369_reciprocal_ = 'reciprocal' # PYCHOK OK

370_reframe_ = 'reframe' # PYCHOK OK

371_resolution_ = 'resolution' # PYCHOK OK

372_rIn_ = 'rIn' # PYCHOK OK

373_RPAREN_ = ')' # PYCHOK OK

374_RSQUARE_ = ']' # PYCHOK RBRACK

375_s_ = 's' # PYCHOK OK

376_S_ = 'S' # PYCHOK OK

377_s12_ = 's12' # PYCHOK OK

378_S12_ = 'S12' # PYCHOK OK

379_scalar_ = 'scalar' # PYCHOK OK

380_scale_ = 'scale' # PYCHOK OK

381_scale0_ = 'scale0' # PYCHOK OK

382_scipy_ = 'scipy' # PYCHOK OK

383_semi_circular_ = 'semi-circular' # PYCHOK OK

384_sep_ = 'sep' # PYCHOK OK

385_singular_ = 'singular' # PYCHOK OK

386_SLASH_ = Str_('/') # PYCHOK OK

387_small_ = 'small' # PYCHOK OK

388_Sphere_ = 'Sphere' # PYCHOK OK

389_spherical_ = 'spherical' # PYCHOK OK

390_SouthPole_ = 'SouthPole' # PYCHOK OK

391_SPACE_ = Str_(' ') # PYCHOK OK

392_specified_ = 'specified' # PYCHOK OK

393_STAR_ = Str_('*') # PYCHOK OK

394_start_ = 'start' # PYCHOK OK

395_std_ = 'std' # PYCHOK OK

396_stdev_ = 'stdev' # PYCHOK OK

397_supported_ = 'supported' # PYCHOK OK

398_tbd_ = 'tbd' # PYCHOK OK

399_TILDE_ = '~' # PYCHOK OK

400_to_ = 'to' # PYCHOK OK

401_tolerance_ = _Prefix('tolerance') # PYCHOK OK

402_too_ = _Prefix('too') # PYCHOK OK

403_transform_ = 'transform' # PYCHOK OK

404_UNDER_ = Str_('_') # PYCHOK OK

405_units_ = 'units' # PYCHOK OK

406_UNUSED_ = 'UNUSED' # PYCHOK OK

407_up_ = 'up' # PYCHOK OK

408_UPS_ = 'UPS' # PYCHOK OK

409_utf_8_ = 'utf-8' # PYCHOK OK

410_UTM_ = 'UTM' # PYCHOK OK

411_V_ = 'V' # PYCHOK OK

412_valid_ = 'valid' # PYCHOK OK

413_value_ = 'value' # PYCHOK OK

414_version_ = 'version' # PYCHOK OK

415_vs_ = 'vs' # PYCHOK OK

416_W_ = 'W' # PYCHOK OK

417_WGS72_ = 'WGS72' # PYCHOK OK

418_WGS84_ = 'WGS84' # PYCHOK OK

419_width_ = 'width' # PYCHOK OK

420_with_ = 'with' # PYCHOK OK

421_x_ = 'x' # PYCHOK OK

422_X_ = 'X' # PYCHOK OK

423_xyz_ = 'xyz' # PYCHOK OK

424_y_ = 'y' # PYCHOK OK

425_Y_ = 'Y' # PYCHOK OK

426_z_ = 'z' # PYCHOK OK

427_Z_ = 'Z' # PYCHOK OK

428_zone_ = 'zone' # PYCHOK OK

429

430_EW_ = _E_ + _W_ # PYCHOK common cardinals

431_NE_ = _N_ + _E_ # PYCHOK positive ones

432_NS_ = _N_ + _S_ # PYCHOK OK

433_NSEW_ = _NS_ + _EW_ # PYCHOK OK

434_NW_ = _N_ + _W_ # PYCHOK OK

435_SE_ = _S_ + _E_ # PYCHOK OK

436_SW_ = _S_ + _W_ # PYCHOK negative ones

437# _NESW_ = _NE_ + _SW_ # PYCHOK clockwise

438

439_DDOT_ = Str_(_DOT_ * 2) # PYCHOK OK

440# _DEQUAL_ = Str_(_EQUAL_ * 2) # PYCHOK OK

441_DNL_ = Str_(_NL_ * 2) # PYCHOK OK

442# _DSLASH_ = Str_(_SLASH_ * 2) # PYCHOK OK

443# _DSTAR_ = Str_(_STAR_ * 2) # PYCHOK OK

444_DUNDER_ = Str_(_UNDER_ * 2) # PYCHOK OK

445

446_LR_PAIRS = {_LANGLE_: _RANGLE_,

447 _LCURLY_: _RCURLY_,

448 _LPAREN_: _RPAREN_,

449 _LSQUARE_: _RSQUARE_} # PYCHOK OK

450

451__all__ = (_NN_, # NOT MISSING!

452 Str_.__name__) # classes

453__version__ = '24.05.13'

454

455 if __name__ == '__main__':

456

457 from pygeodesy import itemsorted, printf

458

459 t = b = 0

460 for n, v in itemsorted(locals(), asorted=False, reverse=True):

461 if n.endswith(_UNDER_) and n.startswith(_UNDER_) and \

462 not n.startswith(_DUNDER_):

463 t += 1

464 b += len(v)

465 m = n[1:-1]

466 if m != v and m.replace(_UNDER_, _SPACE_) != v:

467 printf('%4d: %s = %r', t, n, v)

468 n = len(locals())

469 printf('%4d (%d) names, %s chars total, %.2f chars avg', t, n, b, float(b) / t, nl=1)

470

471# **) MIT License

472#

473# Copyright (C) 2016-2024 -- mrJean1 at Gmail -- All Rights Reserved.

474#

475# Permission is hereby granted, free of charge, to any person obtaining a

476# copy of this software and associated documentation files (the "Software"),

477# to deal in the Software without restriction, including without limitation

478# the rights to use, copy, modify, merge, publish, distribute, sublicense,

479# and/or sell copies of the Software, and to permit persons to whom the

480# Software is furnished to do so, subject to the following conditions:

481#

482# The above copyright notice and this permission notice shall be included

483# in all copies or substantial portions of the Software.

484#

485# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS

486# OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,

487# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL

488# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR

489# OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,

490# ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR

491# OTHER DEALINGS IN THE SOFTWARE.