Overview
Comment: | Minor refactoring to centralize handling of the login cookie checks. |
---|---|
Downloads: | Tarball | ZIP archive | SQL archive |
Timelines: | family | ancestors | descendants | both | trunk |
Files: | files | file ages | folders |
SHA1: |
b2c948dd8aeb51fd9b622bc4bbbda40f |
User & Date: | mistachkin on 2024-06-14 21:58:32 |
Other Links: | manifest | tags |
Context
2024-07-13
| ||
06:27 | Update use of the 'tcl load' sub-command. Now requires Beta 55 of Eagle. check-in: 03fae306b8 user: mistachkin tags: trunk | |
2024-06-14
| ||
21:58 | Minor refactoring to centralize handling of the login cookie checks. check-in: b2c948dd8a user: mistachkin tags: trunk | |
2024-06-03
| ||
04:37 | Update docs. check-in: 96fc9afa4e user: mistachkin tags: trunk | |
Changes
Modified client/1.0/neutral/pkgd.eagle from [50ec21baae] to [f5323e45b7].
︙ | ︙ | |||
1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 | } default { error "unsupported package platform" } } } # # NOTE: This procedure issues a request to an HTTP(S) server. It returns # the raw response data verbatim. It may raise a script error. It # will always use the currently configured HTTP(S) login cookie, if # any; therefore, it should really only be used for requests to the # package file server. The uri argument is the fully qualified URI # to request. The allowHtml argument should be non-zero if raw HTML | > > > > > > > > > > > > > > > > > > > > > > > > > | 1284 1285 1286 1287 1288 1289 1290 1291 1292 1293 1294 1295 1296 1297 1298 1299 1300 1301 1302 1303 1304 1305 1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317 1318 1319 1320 1321 1322 | } default { error "unsupported package platform" } } } # # NOTE: This procedure checks the current login cookie to make sure that # it exists -AND- conforms to the correct format. # proc haveValidLoginCookie {} { variable loginCookie if {![info exists loginCookie]} then { return false } if {[isEagle] || \ ([info exists tcl_version] && $tcl_version >= 8.5)} then { if {[string is list -strict $loginCookie]} then { return false } } if {[llength $loginCookie] != 2} then { return false } return true } # # NOTE: This procedure issues a request to an HTTP(S) server. It returns # the raw response data verbatim. It may raise a script error. It # will always use the currently configured HTTP(S) login cookie, if # any; therefore, it should really only be used for requests to the # package file server. The uri argument is the fully qualified URI # to request. The allowHtml argument should be non-zero if raw HTML |
︙ | ︙ | |||
1324 1325 1326 1327 1328 1329 1330 | TestSetScriptNewWebClientCallback "" true true error] if {$code ne "Ok"} then { error [getStringFromObjectHandle $error] } } | | | | 1349 1350 1351 1352 1353 1354 1355 1356 1357 1358 1359 1360 1361 1362 1363 1364 1365 1366 1367 1368 1369 1370 1371 1372 1373 1374 1375 1376 1377 1378 1379 1380 | TestSetScriptNewWebClientCallback "" true true error] if {$code ne "Ok"} then { error [getStringFromObjectHandle $error] } } if {[haveValidLoginCookie]} then { set script [object create String { if {[methodName ToString] eq "GetWebRequest"} then { webRequest Headers.Add Cookie [join $loginCookie =] } }] set data [uri download \ -timeouttype network -inline \ -webclientdata $script -- $uri] } else { set data [uri download \ -timeouttype network -inline -- $uri] } } else { set options [list -binary true] if {[haveValidLoginCookie]} then { lappend options -headers [list Cookie [join $loginCookie =]] } set data [eval ::PackageRepository::getFileViaHttp \ [list $uri] [list 20] [list stdout] [list $quiet] $options] } |
︙ | ︙ | |||
1413 1414 1415 1416 1417 1418 1419 | proc maybeResetCookieAndLoginSimple {} { variable loginCookie # # NOTE: Attempt to verify that we are currently logged in. If so, do # nothing; otherwise, attempt to login. # | | | 1438 1439 1440 1441 1442 1443 1444 1445 1446 1447 1448 1449 1450 1451 1452 | proc maybeResetCookieAndLoginSimple {} { variable loginCookie # # NOTE: Attempt to verify that we are currently logged in. If so, do # nothing; otherwise, attempt to login. # if {![haveValidLoginCookie]} then { resetCookieAndLoginSimple } } # # NOTE: This procedure resets the currently configured login cookie, if # any, and then attempts to login using the specified user name and |
︙ | ︙ | |||
1491 1492 1493 1494 1495 1496 1497 | variable loginCookie variable logoutUri variable logoutUrn # # NOTE: Attempt to verify that we are currently logged in. # | | | 1516 1517 1518 1519 1520 1521 1522 1523 1524 1525 1526 1527 1528 1529 1530 | variable loginCookie variable logoutUri variable logoutUrn # # NOTE: Attempt to verify that we are currently logged in. # if {![haveValidLoginCookie]} then { error "missing or invalid login cookie" } # # NOTE: Build the full URI for the logout request, performing any # applicable substitutions in the URI prior to using it as # the basis for logging out of the repository. |
︙ | ︙ |
Modified client/1.0/neutral/pkgd.eagle.asc from [b76dc737a2] to [2e5f347713].
1 2 3 4 | -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 Comment: Eagle Package Repository | | | | | | | | | | | | | | | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 Comment: Eagle Package Repository iQIcBAABCAAGBQJmbLygAAoJEFAslq9JXcLZQ7IP/2DjWkWybtaM0JOYcLXkC/la 4qqYI/3T3EWLvwrIww2GGQYts9+KKAGjXQ60DXvOwdJd4rnRpG1NIdYMVSU3YfNp Jpw5+dQxB09oMp7vYwKidbcAhKANjm3UsKJid7YFuzaUYAmkzhGWgE5dh3M2a31b MzUt9i4X7vNti+t4nVLQVn0Zgw4evRdkCSYg2seDVz1788ipaIW7ndVGC8gisxrN DzW7mxnAlre7hzkxEKT76lfpOhpwJc3GNWyqCOJXamPAncsYo2eq0J29o95RiRoe pSNKgnm5WR1N0CBRxy5P2mtdQOmpSR5RknFctlHzidV39XxVgVUG3MDz/8eUogG4 N8mSIbTQ5CAxE0F6bk6zTYpukUVVPUJH8mg8pFhjokEPRdwPVSPUOHk92BnTIwVi UWtxKIixkghvK2u0Khemu4h8DMV9Iv5UK1jvM+BcTcC5Ka8HkOHtphKm7nV7oDab UanomRftfT58EtQSxLg7NG41mQ2WIs7NgHo03yKuz2htllpET1NpzFniQvhPhVLV iPFDrYYoeCtuya8F5Ymf1fJ+qe7wewQ7qPF2Px2vVEXIki3JIXyEmuLRy7pefoaC do6bfd4oFbRnKcgiH3/qq/EH6oJASzo/wm42GmZGFFcOF8m+0Tsh5n3UdQBcm0Qb AQO28k8+k1+2ImXXIVtV =RhPm -----END PGP SIGNATURE----- |
Modified client/1.0/neutral/pkgd.eagle.harpy from [7a63ef98fe] to [8d96478328].
︙ | ︙ | |||
17 18 19 20 21 22 23 | THE ASSOCIATED SOFTWARE MAY NOT WORK PROPERLY IF THIS FILE IS ALTERED. --> <Certificate xmlns="https://eagle.to/2011/harpy" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <Protocol>None</Protocol> <Vendor>Mistachkin Systems</Vendor> | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 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 | THE ASSOCIATED SOFTWARE MAY NOT WORK PROPERLY IF THIS FILE IS ALTERED. --> <Certificate xmlns="https://eagle.to/2011/harpy" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema"> <Protocol>None</Protocol> <Vendor>Mistachkin Systems</Vendor> <Id>4ff99c42-6423-48cc-affc-8cf628e83ace</Id> <HashAlgorithm>SHA512</HashAlgorithm> <EntityType>Script</EntityType> <TimeStamp>2024-06-14T21:56:34.0847234Z</TimeStamp> <Duration>-1.00:00:00</Duration> <Key>0x9559f6017247e3e2</Key> <Signature> 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 </Signature> </Certificate> |
Modified client/1.0/neutral/pkgd.eagle.harpy.asc from [e04d6d98aa] to [768621003f].
1 2 3 4 | -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 Comment: Eagle Package Repository | | | | | | | | | | | | | | | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 Comment: Eagle Package Repository iQIcBAABCAAGBQJmbLyhAAoJEFAslq9JXcLZI8YQALaC4xZWgogT2Lk7ZgrcNBZA V4NI9LMjbb/QEkS4SoIAsl1scPo/tgSxRDxed8N6nPv8l8AIaYC996vPYENst3ml PJ86tOchJbZY0Q53saZudbA34YF1OFac0Ici7g4Hh28oKdiTzdyms57LIGuS6gQt r3fesoLbcPQsCmzd23vpi9aGt3bs9geVLRPk0C2b1JeY4x0hS4JOnpDUilZs1Tgl moSPyx+FddB44oYFMkh5hLZeBJ1n+twLgs5OcP5X/F7Jiq+4WfGsby1B5C0BotzB Gkn0AXUvioB/qGpr1uB/OpzxhYUoqhn4XJ52bwPkymZE4E9hqnTRX6SRu0uQHBU6 P3T7+Bpmkvuxp6hWP35gN4GdO4HMkhJoXuf4+hFxz5H5OxLeeBHZQklRaaFOB/wL a1v+RPktYL78wEUjAmx/M/mw6KoRxlH3GVQBlGnuMWCEGpx2ocYWlbDD/o6LIBqz JwNsZM5mIFO5XAbSyXIhykA/yUpb/p16sjWbDGdbL4tnzyAoVZu0DmK9g1MmEsRI sAIE+x2v/tidt5JM2/tkPCHQ2stDc+/wxCSfRhj5PjGc544K97HevEwWdNcJxqTl HPENJ8itWvehKsaam0L08sbQa4YbGFlzrQm2vghMfyox0mEwpvJqRZSX+dlBLTnt SzASWPgex0pYMuij6cNv =/uXR -----END PGP SIGNATURE----- |
Modified doc/v1.html from [2a9b14679c] to [f91b600e55].
1 2 | <div class="fossil-doc" data-title="Package Client Toolset API v1"><br> | | | 1 2 3 4 5 6 7 8 9 10 | <div class="fossil-doc" data-title="Package Client Toolset API v1"><br> <big><big><span style="font-family: monospace;">Generated [2024-06-14 @ 21:57:18 UTC] from checkout [96fc9afa4e9742bef71ef5d6070f1d6736948fc9 2024-06-03 04:37:38 UTC]</span></big></big><br><br><hr><br> <big><big><span style="font-family: monospace;">Public API Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/common.tcl&ln=272">::Eagle::Tools::Common::getFileViaHttp</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/common.tcl">common.tcl</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "uri"</span></big><br> |
︙ | ︙ | |||
126 127 128 129 130 131 132 | <blockquote style="font-family: monospace;"><br> This procedure modifies the version variables used by the package<br> downloader client so that a specific version will be used. The<br> versionId argument must consist only of hexadecimal characters.<br> </blockquote><br><hr><br> | | | | | | 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 | <blockquote style="font-family: monospace;"><br> This procedure modifies the version variables used by the package<br> downloader client so that a specific version will be used. The<br> versionId argument must consist only of hexadecimal characters.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Public API Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1411">::PackageDownloader::resetCookieAndLoginSimple</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <blockquote style="font-family: monospace;"><br> This procedure resets the currently configured login cookie, if<br> any, and then attempts to login using the configured package<br> repository server API key -OR- using the public access account.<br> Upon success, it will set the login cookie to the one from the<br> raw response data. Upon failure, a script error will be raised.<br> There are no arguments.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Public API Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1461">::PackageDownloader::resetCookieAndLogin</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "userName"</span></big><br> <big><span style="font-family: monospace;"> Required argument "password"</span></big><br> <blockquote style="font-family: monospace;"><br> This procedure resets the currently configured login cookie, if<br> any, and then attempts to login using the specified user name and<br> password. Upon success, it will set the login cookie to the one<br> from the raw response data. Upon failure, a script error will be<br> raised. The userName argument must be the name of a package file<br> server user with at least Fossil Check-Out (o) permissions on the<br> package file server. The password argument must be the plaintext<br> password that is associated with the specified user name.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Public API Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1514">::PackageDownloader::logoutAndResetCookie</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <blockquote style="font-family: monospace;"><br> This procedure attempts to logout using the currently configured<br> login cookie, if any, and then resets the login cookie. There<br> are no arguments. This procedure may raise a script error.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Public API Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1747">::PackageDownloader::checkForHigherVersion</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "language"</span></big><br> <big><span style="font-family: monospace;"> Required argument "version"</span></big><br> <big><span style="font-family: monospace;"> Required argument "platform"</span></big><br> |
︙ | ︙ | |||
193 194 195 196 197 198 199 | not require a specific platform. The packageName argument is a<br> directory name relative to the language and version-specific<br> directory on the package file server and may be an empty string.<br> The usePgp argument should be non-zero when an OpenPGP signature<br> file needs to be downloaded and verified for the downloaded file.<br> </blockquote><br><hr><br> | | | 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 | not require a specific platform. The packageName argument is a<br> directory name relative to the language and version-specific<br> directory on the package file server and may be an empty string.<br> The usePgp argument should be non-zero when an OpenPGP signature<br> file needs to be downloaded and verified for the downloaded file.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Public API Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=2055">::PackageDownloader::downloadFiles</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "language"</span></big><br> <big><span style="font-family: monospace;"> Required argument "version"</span></big><br> <big><span style="font-family: monospace;"> Required argument "platform"</span></big><br> |
︙ | ︙ | |||
231 232 233 234 235 236 237 | for each downloaded file. The -useAutoPath option should be<br> non-zero to modify the auto-path to include the temporary or<br> persistent directories containing the downloaded files. The<br> -allowUpdate option should be non-zero to allow existing package<br> files to be overwritten.<br> </blockquote><br><hr><br> | | | 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 | for each downloaded file. The -useAutoPath option should be<br> non-zero to modify the auto-path to include the temporary or<br> persistent directories containing the downloaded files. The<br> -allowUpdate option should be non-zero to allow existing package<br> files to be overwritten.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Public API Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=2281">::PackageDownloader::maybeAddTemporaryPackagesToAutoPath</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "language"</span></big><br> <big><span style="font-family: monospace;"> Required argument "options"</span></big><br> <big><span style="font-family: monospace;"> Optional argument "pattern" with default value ""</span></big><br> |
︙ | ︙ | |||
357 358 359 360 361 362 363 | entity does not require a specific platform. The varName argument<br> is the name of a variable in the context of the immediate caller<br> that will receive a modified platform name, if applicable. Upon<br> failure, a script error will be raised. The return value is<br> undefined.<br> </blockquote><br><hr><br> | | | 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 | entity does not require a specific platform. The varName argument<br> is the name of a variable in the context of the immediate caller<br> that will receive a modified platform name, if applicable. Upon<br> failure, a script error will be raised. The return value is<br> undefined.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Internal API Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1438">::PackageDownloader::maybeResetCookieAndLoginSimple</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <blockquote style="font-family: monospace;"><br> This procedure attempts to login using the configured package<br> repository server API key -OR- using the public access account,<br> if not already logged in. Upon success, it will set the login<br> cookie to the one from the raw response data. Upon failure, a<br> script error will be raised. There are no arguments.<br> |
︙ | ︙ | |||
583 584 585 586 587 588 589 | This procedure attempts to verify that some runtime is available to<br> run CLR applications locally (e.g. the .NET Framework or Mono JIT).<br> There are no arguments. The return value is non-zero if it appears<br> that CLR applications should be runnable locally; otherwise, the<br> return value is zero.<br> </blockquote><br><hr><br> | > > > > > > > | | | | | | | | | 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 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664 665 666 667 668 669 670 671 672 673 674 675 676 677 678 679 680 681 682 683 684 685 686 687 688 689 690 691 692 693 694 695 696 697 698 699 700 | This procedure attempts to verify that some runtime is available to<br> run CLR applications locally (e.g. the .NET Framework or Mono JIT).<br> There are no arguments. The return value is non-zero if it appears<br> that CLR applications should be runnable locally; otherwise, the<br> return value is zero.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Private Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1295">::PackageDownloader::haveValidLoginCookie</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <blockquote style="font-family: monospace;"><br> This procedure checks the current login cookie to make sure that<br> it exists -AND- conforms to the correct format.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Private Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1325">::PackageDownloader::getPackageFile</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "uri"</span></big><br> <big><span style="font-family: monospace;"> Optional argument "allowHtml" with default value "false"</span></big><br> <blockquote style="font-family: monospace;"><br> This procedure issues a request to an HTTP(S) server. It returns<br> the raw response data verbatim. It may raise a script error. It<br> will always use the currently configured HTTP(S) login cookie, if<br> any; therefore, it should really only be used for requests to the<br> package file server. The uri argument is the fully qualified URI<br> to request. The allowHtml argument should be non-zero if raw HTML<br> should be allowed in the response data.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Private Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1398">::PackageDownloader::getDownloadVarNamePrefix</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <blockquote style="font-family: monospace;"><br> This procedure returns the prefix for fully qualified variable<br> names that MAY be present in the global namespace. There are<br> no arguments.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Private Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1568">::PackageDownloader::getUniqueTempDirectory</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Optional argument "prefix" with default value ""</span></big><br> <blockquote style="font-family: monospace;"><br> This procedure returns a unique temporary directory where one or<br> more files may be saved. The prefix argument is a prefix for the<br> directory name and it may be an empty string. There is no attempt<br> to actually create the resulting directory.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Private Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1598">::PackageDownloader::createInterp</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "varName"</span></big><br> <blockquote style="font-family: monospace;"><br> This procedure creates a new interpreter, which may be "safe", and<br> places a reference to it in a variable in the context of the caller<br> identified by the varName argument. The created interpreter has a<br> fully functioning [package] command ensemble; all other commands do<br> nothing and return nothing. This procedure may raise script errors.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Private Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1675">::PackageDownloader::getIfNeededVersions</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "interp"</span></big><br> <big><span style="font-family: monospace;"> Required argument "fileName"</span></big><br> <blockquote style="font-family: monospace;"><br> This procedure evaluates a script file and attempts to determine the<br> list of new [package ifneeded] scripts added by it. When successful<br> it returns a list-of-lists. Each element of the outer list contains<br> a package name and the list of its versions in descending order; in<br> the event of failure, empty lists may be returned for the outer list<br> or for a list of versions. The interp argument is the interp to use<br> when evaluating the file specified by the fileName argument. This<br> procedure may raise script errors.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Private Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1698">::PackageDownloader::extractVersionsFromFile</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "fileName"</span></big><br> <blockquote style="font-family: monospace;"><br> This procedure attempts to extract a package version information<br> from the specified file. The fileName argument is the local file<br> name to read. This procedure may raise script errors.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Private Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1810">::PackageDownloader::guessPackageNameFromFileNames</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "language"</span></big><br> <big><span style="font-family: monospace;"> Required argument "fileNames"</span></big><br> <blockquote style="font-family: monospace;"><br> This procedure attempts to guess a package name based on a list of<br> its files. It relies upon the fact that all packages must include<br> a package index file. The language argument must be one of the<br> literal strings "eagle", "tcl", or "client". The fileNames argument<br> must be the list of file names to be downloaded. The package name,<br> if one can be detected, is returned; otherwise, an empty string will<br> be returned.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Private Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1844">::PackageDownloader::downloadAllPlatforms</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "language"</span></big><br> <big><span style="font-family: monospace;"> Required argument "version"</span></big><br> <big><span style="font-family: monospace;"> Required argument "packageName"</span></big><br> |
︙ | ︙ | |||
707 708 709 710 711 712 713 | is a directory name relative to the language and version-specific<br> directory on the package file server and may be an empty string.<br> The fileNames argument is the list of file names to be downloaded.<br> The usePgp argument should be non-zero when an OpenPGP signature<br> needs to be verified for the downloaded file.<br> </blockquote><br><hr><br> | | | | 714 715 716 717 718 719 720 721 722 723 724 725 726 727 728 729 730 731 732 733 734 735 736 737 738 739 740 741 742 743 744 745 746 747 748 | is a directory name relative to the language and version-specific<br> directory on the package file server and may be an empty string.<br> The fileNames argument is the list of file names to be downloaded.<br> The usePgp argument should be non-zero when an OpenPGP signature<br> needs to be verified for the downloaded file.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Private Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1948">::PackageDownloader::downloadOneUriToFile</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "localFileName"</span></big><br> <big><span style="font-family: monospace;"> Required argument "uri"</span></big><br> <big><span style="font-family: monospace;"> Required argument "usePgp"</span></big><br> <big><span style="font-family: monospace;"> Required argument "forcePgp"</span></big><br> <blockquote style="font-family: monospace;"><br> This procedure downloads a single URI from the package file server<br> and writes the result to a local file. The localFileName argument<br> is the file name where the downloaded file should be written. The<br> The uri argument is the URI to download. The usePgp argument should<br> be non-zero when the OpenPGP signature file needs to be verified for<br> the downloaded file. The return value is undefined.<br> </blockquote><br><hr><br> <big><big><span style="font-family: monospace;">Private Procedure "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle&ln=1989">::PackageDownloader::downloadOneFile</a>" (from "<a href="$ROOT/artifact?ci=trunk&filename=client/1.0/neutral/pkgd.eagle">pkgd.eagle</a>")</span></big></big><br> <br> <big><span style="font-family: monospace;"> Required argument "language"</span></big><br> <big><span style="font-family: monospace;"> Required argument "version"</span></big><br> <big><span style="font-family: monospace;"> Required argument "platform"</span></big><br> |
︙ | ︙ |
Modified doc/v1.html.asc from [275f91f9f2] to [efdc277652].
1 2 3 4 | -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 Comment: Eagle Package Repository | | | | | | | | | | | | | | | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | -----BEGIN PGP SIGNATURE----- Version: GnuPG v2 Comment: Eagle Package Repository iQIcBAABCAAGBQJmbLzjAAoJEFAslq9JXcLZEswQAKFGfjYOIVJkv/xTNXKIt/pX s6T5eUf+wkLUuCzvaekgpdBfxHwlGifkk+O2N/Yd7PfOe5yGjXIOL2yDqd3/uDHn IOwDrDlVXg1Bs/TH3tJeXyVPWlomW1cQgc30Zg1iNqfN2wScTvTY71/JgKjFiosd 6IN3ZatcCxNCUOH1AL7qGyejNeABQATQAhBlEjpz6HFjpP4I+aLVYeKniZnx7jWO wpzEk7WOJfgbLvJ4K/YxiAVXifIvkoDJ+NSIJisnRvutb+3Qgsf7NNNqFdOwJ3xF kkStUZ6pPA0YCVJ6zj7Vuaizkx/7NJrTY+poJPGMEC0dl3hSCmJOXQ0D6A0pGDXw ZJaREMKxsFaXKJHHVCMt9YoYC7RbNNb10O99aqbK5lKAV171+8WyGDSLKidPLZkG 9WowM0pXqaVEfcyaqRJQoohWaXIP6UjP12F09SwBru2eQZQO1hEF3bGa4MqRlshh 44f/nb+HpWLw+uhQxNQ4qnraE8CTutA6ZqM3mVr698j1ocpEBGkoe8udiwT8V6zM VwcNGrmXdtMZu1CoNy8ZVJt5QTHJXTLI3L5BSqTscKPvAe2r74fa/x4zMrXoh3VI zy8Q6Nydef4ozazD+l77Jr13j5Pk7nLO6vZt83fiTfZTeQlXrfmZ/Z/J4vKF1/1H LPiWMlDpO73Z6IzC5qo5 =MArJ -----END PGP SIGNATURE----- |