From 47b32fc687e392867f979ad7507347af88fa18fc Mon Sep 17 00:00:00 2001 From: Rohit Goswami Date: Mon, 16 Nov 2026 17:54:48 +0000 Subject: [PATCH 1/4] docs: build the site from Org pages, with the API from the code The site was the README's text as one Sphinx page, with COMPAT.md and RELEASING.md beside it. It had no tutorial and no task-sized guides, and nothing in the code could be linked by name. The documentation template builds it now. Org pages under docs/orgmode/ are exported to reStructuredText and built by Sphinx with warnings and unresolved names as errors. docs/tools/zig_api.zig writes the API pages from the doc comments of src/main.zig and the files it imports, and zig build docs installs the Zig autodoc site, from a compile of its own so that the binary is not built with -femit-docs. check_site.py checks the internal links and anchors, and that no page names a site; lychee checks the external links. pixi.lock pins the tools, so dependabot no longer watches docs/requirements.txt. The first pages are the tutorial, "Keep a failed build's logs", run with EasyBuild 5.4.2 as the page says; the how-to on calling eb-keep-logs from a build pipeline; the explanation of how failed finds a build's log; and the compatibility table. The contributing page says how to record a change and run the tests, and links RELEASING.md. The docs workflow replaces pages.yml: it builds the site as docbld does, checks the external links, also weekly, and publishes from main. --- .github/dependabot.yml | 8 - .github/workflows/docs.yml | 64 + .github/workflows/pages.yml | 39 - .gitignore | 14 + build.zig | 11 + changelog.d/+docs-site.doc.md | 1 + docs/compat.md | 2 - docs/conf.py | 69 - docs/export.el | 208 + docs/index.md | 27 - docs/orgmode/changelog.org | 10 + docs/orgmode/contributing.org | 79 + docs/orgmode/explanation/index.org | 15 + docs/orgmode/explanation/why-eb-last-log.org | 70 + docs/orgmode/howto/call-from-a-pipeline.org | 90 + docs/orgmode/howto/index.org | 15 + docs/orgmode/index.org | 53 + docs/orgmode/reference/api.org | 18 + docs/orgmode/reference/compatibility.org | 9 + docs/orgmode/reference/index.org | 16 + docs/orgmode/tutorials/index.org | 15 + .../tutorials/keep-a-failed-build-log.org | 188 + .../keep-a-failed-build-log/Example-1.0.eb | 21 + .../keep-a-failed-build-log/example.c | 7 + docs/releasing.md | 2 - docs/requirements.txt | 4 - docs/source/_ext/zig_domain.py | 280 ++ docs/{ => source}/_static/favicon.svg | 0 docs/{ => source}/_static/logo-dark.svg | 0 docs/{ => source}/_static/logo-light.svg | 0 docs/{ => source}/_static/mark-dark.svg | 0 docs/{ => source}/_static/mark.svg | 0 docs/source/_static/stackhands.css | 23 + docs/source/conf.py | 254 ++ docs/tools/check_site.py | 177 + docs/tools/zig_api.zig | 615 +++ lychee.toml | 31 + pixi.lock | 3859 +++++++++++++++++ pixi.toml | 42 + 39 files changed, 6185 insertions(+), 151 deletions(-) create mode 100644 .github/workflows/docs.yml delete mode 100644 .github/workflows/pages.yml create mode 100644 changelog.d/+docs-site.doc.md delete mode 100644 docs/compat.md delete mode 100644 docs/conf.py create mode 100644 docs/export.el delete mode 100644 docs/index.md create mode 100644 docs/orgmode/changelog.org create mode 100644 docs/orgmode/contributing.org create mode 100644 docs/orgmode/explanation/index.org create mode 100644 docs/orgmode/explanation/why-eb-last-log.org create mode 100644 docs/orgmode/howto/call-from-a-pipeline.org create mode 100644 docs/orgmode/howto/index.org create mode 100644 docs/orgmode/index.org create mode 100644 docs/orgmode/reference/api.org create mode 100644 docs/orgmode/reference/compatibility.org create mode 100644 docs/orgmode/reference/index.org create mode 100644 docs/orgmode/tutorials/index.org create mode 100644 docs/orgmode/tutorials/keep-a-failed-build-log.org create mode 100644 docs/orgmode/tutorials/keep-a-failed-build-log/Example-1.0.eb create mode 100644 docs/orgmode/tutorials/keep-a-failed-build-log/example.c delete mode 100644 docs/releasing.md delete mode 100644 docs/requirements.txt create mode 100644 docs/source/_ext/zig_domain.py rename docs/{ => source}/_static/favicon.svg (100%) rename docs/{ => source}/_static/logo-dark.svg (100%) rename docs/{ => source}/_static/logo-light.svg (100%) rename docs/{ => source}/_static/mark-dark.svg (100%) rename docs/{ => source}/_static/mark.svg (100%) create mode 100644 docs/source/_static/stackhands.css create mode 100644 docs/source/conf.py create mode 100644 docs/tools/check_site.py create mode 100644 docs/tools/zig_api.zig create mode 100644 lychee.toml create mode 100644 pixi.lock create mode 100644 pixi.toml diff --git a/.github/dependabot.yml b/.github/dependabot.yml index fb2bce8..db69680 100644 --- a/.github/dependabot.yml +++ b/.github/dependabot.yml @@ -8,11 +8,3 @@ updates: dependencies: patterns: - "*" - - package-ecosystem: pip - directory: /docs - schedule: - interval: monthly - groups: - docs: - patterns: - - "*" diff --git a/.github/workflows/docs.yml b/.github/workflows/docs.yml new file mode 100644 index 0000000..409e807 --- /dev/null +++ b/.github/workflows/docs.yml @@ -0,0 +1,64 @@ +# Build the documentation the way `pixi run -e docs docbld` does: Org export, +# API pages from the code, Sphinx with warnings and unresolved references as +# errors, the Zig autodoc site, and the internal link check. External links +# are checked in their own step. On main the site is published to +# https://stackhands.github.io/eb-keep-logs/. +name: docs + +on: + push: + branches: [main] + pull_request: + workflow_dispatch: + schedule: + # Weekly, so a link that went dead elsewhere is noticed. + - cron: "17 5 * * 1" + +permissions: + contents: read + +concurrency: + group: docs-${{ github.ref }} + cancel-in-progress: true + +jobs: + build: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@3d3c42e5aac5ba805825da76410c181273ba90b1 # v7.0.1 + with: + persist-credentials: false + + - uses: prefix-dev/setup-pixi@9936258fee697aff89b3fed6ca1f80a382ef694e # v0.11.3 + with: + environments: docs + cache: true + locked: true + + - name: Build + run: pixi run -e docs docbld + env: + DOCS_SOURCE_REF: ${{ github.sha }} + + - name: External links + run: pixi run -e docs linkcheck + env: + GITHUB_TOKEN: ${{ github.token }} + + - uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v5.0.0 + with: + path: docs/build/html + + deploy: + if: github.event_name == 'push' && github.ref == 'refs/heads/main' + needs: build + runs-on: ubuntu-latest + permissions: + pages: write + id-token: write + environment: + name: github-pages + url: ${{ steps.deployment.outputs.page_url }} + steps: + - id: deployment + uses: actions/deploy-pages@368f82528645a54fb793d4d04e342629a3f51346 # v5.0.1 diff --git a/.github/workflows/pages.yml b/.github/workflows/pages.yml deleted file mode 100644 index 02a4dd5..0000000 --- a/.github/workflows/pages.yml +++ /dev/null @@ -1,39 +0,0 @@ -name: pages -# Build the documentation with warnings as errors; on main, publish it to -# https://stackhands.github.io/eb-keep-logs/ -on: - push: - branches: [main] - pull_request: -permissions: - contents: read -concurrency: - group: pages-${{ github.ref }} - cancel-in-progress: true -jobs: - build: - runs-on: ubuntu-latest - steps: - - uses: actions/checkout@v7 - - uses: actions/setup-python@v7 - with: - python-version: "3.12" - - run: python -m pip install -r docs/requirements.txt - - run: python -m sphinx -W -b html docs docs/_build/html - - uses: actions/upload-pages-artifact@v5 - if: github.event_name == 'push' && github.ref == 'refs/heads/main' - with: - path: docs/_build/html - deploy: - if: github.event_name == 'push' && github.ref == 'refs/heads/main' - needs: build - runs-on: ubuntu-latest - permissions: - pages: write - id-token: write - environment: - name: github-pages - url: ${{ steps.deployment.outputs.page_url }} - steps: - - id: deployment - uses: actions/deploy-pages@v5 diff --git a/.gitignore b/.gitignore index 3389c86..f574a91 100644 --- a/.gitignore +++ b/.gitignore @@ -1,2 +1,16 @@ .zig-cache/ zig-out/ +zig-pkg/ + +# Documentation build (docs-plan template): generated, never committed. +/docs/build/ +/docs/source/**/*.rst +/docs/source/reference/api/ +/docs/source/**/*.png +/docs/source/**/*.svg +/docs/source/**/*.jpg +/docs/source/**/*.webp +!/docs/source/_static/** +/docs/**/__pycache__/ +/.pixi/ +/.lycheecache diff --git a/build.zig b/build.zig index 9679584..7b1d6da 100644 --- a/build.zig +++ b/build.zig @@ -25,6 +25,17 @@ pub fn build(b: *std.Build) void { const exe = b.addExecutable(.{ .name = "eb-keep-logs", .root_module = mod, .linkage = .static }); b.installArtifact(exe); + // The Zig autodoc site, into /docs (pixi task autodoc). A compile + // of its own: asking the installed one for docs would add -femit-docs to + // every build of the binary. + const doc_exe = b.addExecutable(.{ .name = "eb-keep-logs", .root_module = mod }); + const docs = b.addInstallDirectory(.{ + .source_dir = doc_exe.getEmittedDocs(), + .install_dir = .prefix, + .install_subdir = "docs", + }); + b.step("docs", "Generate the API reference").dependOn(&docs.step); + const unit = b.addTest(.{ .root_module = mod }); b.step("unit", "Run the unit tests").dependOn(&b.addRunArtifact(unit).step); diff --git a/changelog.d/+docs-site.doc.md b/changelog.d/+docs-site.doc.md new file mode 100644 index 0000000..94e88fb --- /dev/null +++ b/changelog.d/+docs-site.doc.md @@ -0,0 +1 @@ +The documentation site is built from Org pages in `docs/orgmode/` with Sphinx, in four parts: the tutorial "Keep a failed build's logs", how-to guides, explanation and reference. The API pages are generated from the doc comments of `src/main.zig` and the files it imports, and `zig build docs` installs the Zig autodoc site. `pixi run -e docs docbld` builds it as CI does and fails on a warning, an unresolved name or a dead internal link; `pixi run -e docs linkcheck` checks the external links. The `docs` workflow publishes the site to GitHub Pages; `docs/requirements.txt` and `pages.yml` are gone. diff --git a/docs/compat.md b/docs/compat.md deleted file mode 100644 index 694fca1..0000000 --- a/docs/compat.md +++ /dev/null @@ -1,2 +0,0 @@ -```{include} ../COMPAT.md -``` diff --git a/docs/conf.py b/docs/conf.py deleted file mode 100644 index 1cf777a..0000000 --- a/docs/conf.py +++ /dev/null @@ -1,69 +0,0 @@ -"""Sphinx configuration for the eb-keep-logs documentation.""" - -project = "eb-keep-logs" -author = "eb-keep-logs developers" -copyright = "Copyright (c) eb-keep-logs developers" - -extensions = ["myst_parser", "sphinx_copybutton"] -myst_enable_extensions = ["colon_fence", "deflist"] -myst_heading_anchors = 3 -exclude_patterns = ["_build"] - -html_theme = "shibuya" -html_title = "eb-keep-logs" -html_static_path = ["_static"] -html_favicon = "_static/favicon.svg" -html_baseurl = "https://stackhands.github.io/eb-keep-logs/" -html_theme_options = { - "github_url": "https://github.com/stackhands/eb-keep-logs", - "accent_color": "teal", - "dark_code": True, - "light_logo": "_static/logo-light.svg", - "dark_logo": "_static/logo-dark.svg", - "nav_links": [ - # stackhands:begin (generated by stackhands/.github branding/sync.py) - { - "title": "stackhands", - "children": [ - { - "title": "eb-stack", - "url": "https://eb-stack.rgoswami.me/", - "summary": "Solve, shard and plan an EasyBuild build list; admit builds under a scratch inode budget", - }, - { - "title": "eb-staged-rebuild", - "url": "https://stackhands.github.io/eb-staged-rebuild/", - "summary": "Rebuild an installation in a staged tree and swap it in, so running jobs keep their paths", - }, - { - "title": "eessi-arch-guard", - "url": "https://stackhands.github.io/eessi-arch-guard/", - "summary": "Reload EESSI in a Slurm task that inherited it for another CPU or GPU", - }, - { - "title": "eb-local", - "url": "https://stackhands.github.io/eb-local/", - "summary": "Install software with EasyBuild on top of EESSI into a directory a user or project owns", - }, - { - "title": "rfc9162", - "url": "https://stackhands.github.io/rfc9162/", - "summary": "Append-only Merkle logs hashed as RFC 9162, with tiled storage and signed checkpoints", - }, - { - "title": "zig-common", - "url": "https://stackhands.github.io/zig-common/", - "summary": "The shared Zig library under the Zig tools: system calls, checked files, child processes", - }, - ], - }, - # stackhands:end - ], -} -html_context = { - "source_type": "github", - "source_user": "stackhands", - "source_repo": "eb-keep-logs", - "source_version": "main", - "source_docs_path": "/docs/", -} diff --git a/docs/export.el b/docs/export.el new file mode 100644 index 0000000..3253546 --- /dev/null +++ b/docs/export.el @@ -0,0 +1,208 @@ +;;; export.el --- Publish docs/orgmode to docs/source -*- lexical-binding: t; -*- + +;; Run from docs/: emacs -Q --batch --load export.el +;; +;; Every .org page under orgmode/ becomes a .rst page under source/ at the +;; same path; images are copied beside them. A page that fails to export +;; fails the run. +;; +;; ox-rst is GPL-2+ and is not stored in the tree. The pinned upstream +;; commit is fetched into a cache outside it ($STACKHANDS_OX_RST_CACHE, else +;; $XDG_CACHE_HOME/stackhands-docs/ox-rst//), its sha256 checked, and +;; that file loaded. +;; +;; Org 9.7 stores the text of ~code~ and =verbatim= as a deferred value, +;; which ox-rst passes to replace-regexp-in-string; deferred values are +;; resolved on the parse tree before any transcoder runs. +;; +;; Links between pages are written as Org file links and come out as :doc: +;; roles. These link types write the other Sphinx roles: +;; +;; [[zig:zig_common.proc.run]] :zig:obj:`zig_common.proc.run` +;; [[autodoc:zig_common.proc]] :zig:autodoc:`zig_common.proc` +;; [[autodoc:/][Zig autodoc]] the autodoc site's front page +;; [[py:eessi_arch_guard.decide]] :py:obj:`eessi_arch_guard.decide` +;; [[rust:struct:eb_stack::Plan]] :rust:struct:`eb_stack::Plan` +;; [[site:eb-local:howto/index]] :external+eb-local:doc:`howto/index` +;; [[man:bwrap(1)]] :manpage:`bwrap(1)` +;; [[term:EESSI]] :term:`EESSI` +;; +;; A description, [[zig:zig_common.proc.run][run]], becomes the link text. + +(require 'org) +(require 'ox-publish) + +(defconst stackhands-ox-rst-revision + "b73eff187eebac24b457688bfd27f09eff434860") +(defconst stackhands-ox-rst-sha256 + "17ac300861f22e62166785a8ac1b97d32bb8a131ee5ba1b7a9db8977b07e7ede") +(defconst stackhands-ox-rst-url + (concat "https://raw.githubusercontent.com/msnoigrs/ox-rst/" + stackhands-ox-rst-revision + "/ox-rst.el")) + +(defvar stackhands-export-failures nil + "Alist of (file . message) for pages that failed to publish.") + +(defun stackhands-export-fail (format-string &rest args) + "Print FORMAT-STRING with ARGS and exit non-zero." + (apply #'message format-string args) + (kill-emacs 1)) + +(defun stackhands-ox-rst-cache-file () + "Absolute path of the pinned ox-rst source, outside the repository." + (expand-file-name + (concat stackhands-ox-rst-revision "/ox-rst.el") + (or (getenv "STACKHANDS_OX_RST_CACHE") + (expand-file-name + "stackhands-docs/ox-rst" + (or (getenv "XDG_CACHE_HOME") + (expand-file-name ".cache" + (or (getenv "HOME") + temporary-file-directory))))))) + +(defun stackhands-file-sha256 (file) + "Return the sha256 hex digest of FILE." + (with-temp-buffer + (set-buffer-multibyte nil) + (insert-file-contents-literally file) + (secure-hash 'sha256 (current-buffer)))) + +(defun stackhands-fetch-ox-rst (dest) + "Download the pinned ox-rst to DEST, or exit non-zero." + (let ((part (concat dest ".partial"))) + (make-directory (file-name-directory dest) t) + (when (file-exists-p part) + (delete-file part)) + (message "export: fetching ox-rst %s" stackhands-ox-rst-revision) + (let ((status (call-process "curl" nil nil nil + "-fsSL" "--retry" "3" "--retry-delay" "1" + "-o" part stackhands-ox-rst-url))) + (unless (and (eq status 0) (file-readable-p part)) + (when (file-exists-p part) + (delete-file part)) + (stackhands-export-fail "export failed: could not fetch %s (curl exited %s)" + stackhands-ox-rst-url status))) + (let ((got (stackhands-file-sha256 part))) + (unless (string= got stackhands-ox-rst-sha256) + (delete-file part) + (stackhands-export-fail "export failed: ox-rst checksum mismatch (expected %s, got %s)" + stackhands-ox-rst-sha256 got))) + (rename-file part dest t))) + +(let ((dest (stackhands-ox-rst-cache-file))) + (unless (and (file-readable-p dest) + (string= (stackhands-file-sha256 dest) stackhands-ox-rst-sha256)) + (stackhands-fetch-ox-rst dest)) + ;; NOSUFFIX, so a stale ox-rst.elc beside it is never loaded. + (load dest nil nil t)) + +(message "export: Org %s; ox-rst %s" (org-version) stackhands-ox-rst-revision) + +;; Source blocks are shown, never run. +(setq org-export-use-babel nil) +;; x86_64 and EESSI_USER_INSTALL are names, not subscripts; only _{...} and +;; ^{...} are. +(setq org-export-with-sub-superscripts '{}) + +(defun stackhands-resolve-deferred (tree _backend _info) + "Replace deferred properties in TREE with their values." + (when (fboundp 'org-element-properties-resolve) + (org-element-map tree t + (lambda (node) + (unless (stringp node) + (org-element-properties-resolve node t))))) + tree) + +(add-to-list 'org-export-filter-parse-tree-functions #'stackhands-resolve-deferred) + +;; ox-rst writes a link to another Org page as a link to its .rst file, and +;; leaves a link to a generated .md page as it is; Sphinx needs a :doc: role +;; to reach either rendered page. +(defun stackhands-doc-link-filter (text backend _info) + (if (org-export-derived-backend-p backend 'rst) + (replace-regexp-in-string + "`\\([^`]+\\) <\\([^>:]+\\)\\.\\(rst\\|md\\)>`_" + ":doc:`\\1 <\\2>`" + text) + text)) + +(add-to-list 'org-export-filter-link-functions #'stackhands-doc-link-filter) + +(defun stackhands-role (role target desc) + "The Sphinx ROLE for TARGET, with DESC as its text when given." + (if (and desc (not (string-empty-p desc)) (not (string= desc target))) + (format ":%s:`%s <%s>`" role desc target) + (format ":%s:`%s`" role target))) + +(defun stackhands-define-role-link (type role-fn) + "Make Org links of TYPE export to the role ROLE-FN returns for their path." + (org-link-set-parameters + type + :export (lambda (path desc backend &optional _info) + (if (org-export-derived-backend-p backend 'rst) + (let ((role-target (funcall role-fn path))) + (stackhands-role (car role-target) (cdr role-target) desc)) + (or desc path))))) + +(stackhands-define-role-link "zig" (lambda (path) (cons "zig:obj" path))) +(stackhands-define-role-link "autodoc" (lambda (path) (cons "zig:autodoc" path))) +(stackhands-define-role-link "py" (lambda (path) (cons "py:obj" path))) +(stackhands-define-role-link "man" (lambda (path) (cons "manpage" path))) +(stackhands-define-role-link "term" (lambda (path) (cons "term" path))) +;; A heading on another page, by the CUSTOM_ID ox-rst writes as its label. +(stackhands-define-role-link "ref" (lambda (path) (cons "ref" path))) +(stackhands-define-role-link + "rust" (lambda (path) + ;; rust:struct:a::B names the role; rust:anyhow::Error does not. + (if (string-match "\\`\\([a-z]+\\):\\([^:].*\\)\\'" path) + (cons (concat "rust:" (match-string 1 path)) (match-string 2 path)) + (cons "rust:any" path)))) +(stackhands-define-role-link + "site" (lambda (path) + (unless (string-match "\\`\\([^:]+\\):\\(.+\\)\\'" path) + (error "site link needs SITE:PAGE, got %s" path)) + (cons (format "external+%s:doc" (match-string 1 path)) (match-string 2 path)))) + +(setq org-publish-project-alist + '(("sphinx-rst" + :base-directory "./orgmode/" + :base-extension "org" + :publishing-directory "./source/" + :publishing-function org-rst-publish-to-rst + :recursive t + :headline-levels 4 + :with-toc nil + :section-numbers nil) + ("sphinx-images" + :base-directory "./orgmode/" + :base-extension "svg\\|png\\|jpg\\|jpeg\\|webp" + :publishing-directory "./source/" + :publishing-function org-publish-attachment + :recursive t) + ("sphinx" :components ("sphinx-rst" "sphinx-images")))) + +(defun stackhands-publish-file (orig filename &optional project no-cache) + "Call ORIG to publish FILENAME, recording a failure instead of stopping." + (condition-case err + (funcall orig filename project no-cache) + (error + (let ((msg (error-message-string err))) + (message "export failed: %s: %s" filename msg) + (push (cons filename msg) stackhands-export-failures) + nil)))) + +(advice-add 'org-publish-file :around #'stackhands-publish-file) + +;; Every .rst under source/ is an export, so one whose page was renamed or +;; deleted would otherwise stay in the build. +(dolist (stale (directory-files-recursively "./source/" "\\.rst\\'")) + (delete-file stale)) + +(org-publish "sphinx" t) + +(when stackhands-export-failures + (message "export: %d page(s) failed" (length stackhands-export-failures)) + (dolist (fail (nreverse stackhands-export-failures)) + (message "export failed: %s: %s" (car fail) (cdr fail))) + (kill-emacs 1)) diff --git a/docs/index.md b/docs/index.md deleted file mode 100644 index 2b4b041..0000000 --- a/docs/index.md +++ /dev/null @@ -1,27 +0,0 @@ -# eb-keep-logs - -```{image} _static/logo-light.svg -:alt: eb-keep-logs -:width: 420px -:class: light-only -``` - -```{image} _static/logo-dark.svg -:alt: eb-keep-logs -:width: 420px -:class: dark-only -``` - -```{include} ../README.md -:start-after: -:end-before: -``` - -```{toctree} -:hidden: -:maxdepth: 1 - -compat -releasing -``` - diff --git a/docs/orgmode/changelog.org b/docs/orgmode/changelog.org new file mode 100644 index 0000000..157f055 --- /dev/null +++ b/docs/orgmode/changelog.org @@ -0,0 +1,10 @@ +#+TITLE: Changelog +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil + +# CHANGELOG.md at the top of the repository is the one changelog; this page +# shows it. + +#+begin_export rst +.. include:: ../../CHANGELOG.md + :parser: myst_parser.sphinx_ +#+end_export diff --git a/docs/orgmode/contributing.org b/docs/orgmode/contributing.org new file mode 100644 index 0000000..a41d580 --- /dev/null +++ b/docs/orgmode/contributing.org @@ -0,0 +1,79 @@ +#+TITLE: Contributing +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* Contributing + +Changes come as pull requests to [[https://github.com/stackhands/eb-keep-logs][stackhands/eb-keep-logs]]. +A change to behaviour changes the page that describes it in the same pull request. + +** Record the change + +Every change adds a news fragment, =changelog.d/+SLUG.TYPE.md=, with a short slug for the change and one of the types =towncrier.toml= configures: + +| Type | Section of the release notes | +|-----------+------------------------------| +| =feature= | Features | +| =bugfix= | Fixes | +| =doc= | Documentation | +| =removal= | Removals | +| =misc= | Miscellaneous | + +A fragment is one paragraph in the present tense that names the commands, options and files it is about in backticks, as the entries in the [[file:changelog.org][changelog]] do. +=towncrier build --draft --version 0.2.2= shows the release notes the fragments make, and fails on a fragment whose type is not configured. +The release commit gathers them into =CHANGELOG.md=; [[https://github.com/stackhands/eb-keep-logs/blob/main/RELEASING.md][RELEASING.md]] has the rest of a release. + +** Run the tests + +With Zig 0.17.1, from the top of the repository: + +#+begin_src bash +zig build test +#+end_src + +This runs the unit tests, the command-line suite =tests/test_eb_keep_logs.sh= against the binary, and =tests/differential.sh=, which runs the shell script and the binary on the same invocations. +=bash tests/test_eb_keep_logs.sh= runs the suite against the shell script. +A deliberate difference between the two has its row in =COMPAT.md=, which [[file:reference/compatibility.org][Compatibility]] shows, and its label in =tests/differential.sh=. + +** Build the documentation + +The documentation toolchain is pinned in =pixi.lock=: Emacs, Sphinx, lychee, and the tools that read the code. +With [[https://pixi.sh][pixi]] installed, from the top of the repository: + +#+begin_src bash +pixi run -e docs docbld +#+end_src + +The site is in =docs/build/html/=; open =docs/build/html/index.html=. +The build fails on any Sphinx warning, any cross-reference that does not resolve, any internal link or anchor that does not exist, and, outside the changelog, any name of a real site's machines or paths. +The first build needs the network, to fetch the other stackhands sites' inventories; later builds reuse them for 30 days. + +External links are checked separately, as they need the network: + +#+begin_src bash +pixi run -e docs linkcheck +#+end_src + +=pixi run -e docs docdel= removes everything the build generated. + +** Where things are + +| Path | What it holds | +|----------------------------+----------------------------------------------------| +| =docs/orgmode/= | the pages, in Org: edit these | +| =docs/export.el= | the Org to reStructuredText export | +| =docs/source/conf.py= | the Sphinx configuration | +| =docs/source/_ext/= | the Sphinx domain for Zig declarations | +| =docs/tools/zig_api.zig= | writes the Zig API pages from the doc comments | +| =docs/tools/check_site.py= | checks internal links, anchors and forbidden names | + +The =.rst= files under =docs/source/= and everything under =docs/source/reference/api/= are generated and not committed. + +** Write a page + +A page belongs to exactly one quadrant: a tutorial teaches by doing, a how-to guide gets one task done, an explanation says why, and a reference page lists what there is. +Start from the skeleton for its quadrant in =docs-kit/skeletons/= of [[https://github.com/stackhands/.github][stackhands/.github]], add it to the =toctree= of the quadrant's =index.org=, and follow =docs-kit/STYLE.md= there. +Examples use the neutral example site (=example.org=, =/opt/site=, =/home/alice=), never a real one. + +API documentation is written in the code, and the first sentence of each comment is the summary shown in lists. +In Zig it is a =///= comment above each =pub= declaration and a =//!= comment at the top of each file. diff --git a/docs/orgmode/explanation/index.org b/docs/orgmode/explanation/index.org new file mode 100644 index 0000000..26390be --- /dev/null +++ b/docs/orgmode/explanation/index.org @@ -0,0 +1,15 @@ +#+TITLE: Explanation +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* Explanation + +These pages say why eb-keep-logs works the way it does: the model behind it, the choices made and the ones turned down. +Nothing here is a step to follow. + +#+begin_export rst +.. toctree:: + :maxdepth: 1 + + why-eb-last-log +#+end_export diff --git a/docs/orgmode/explanation/why-eb-last-log.org b/docs/orgmode/explanation/why-eb-last-log.org new file mode 100644 index 0000000..52f7cca --- /dev/null +++ b/docs/orgmode/explanation/why-eb-last-log.org @@ -0,0 +1,70 @@ +#+TITLE: Finding a failed build's log +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* Finding a failed build's log + +Why does =eb-keep-logs failed= ask =eb --last-log= where the log is, instead of reading the path from what the build printed, and why does it copy a failed command's output from one place only? + +** The problem + +A build pipeline runs =eb= in a batch job, and EasyBuild keeps what explains a failure in temporary places. +During a run, EasyBuild writes everything it does to a temporary log, the session log, and removes it when the run succeeds; a build that fails leaves it behind. +EasyBuild 5 also saves the output of each command it runs to a file of its own, =run-shell-cmd-output/COMMAND-RANDOM/out.txt= under its temporary directory, and prints that path, not the output, when the command fails. +The compiler's error, or the test that failed, is in those two files, and when the job ends its temporary directories are cleaned, the two files with them. + +What the build prints does not lead to the session log reliably. +The line =Results of the build can be found in the log file(s) PATH= names the shorter log of the one easyconfig, and it can arrive in pieces: EasyBuild 5.3 and later, printing through the Python package =rich=, fold long lines at the terminal width, 80 columns when the output goes to a pipe or a file. + +** How eb-keep-logs handles it + +The pipeline gives each build a log directory of its own, and =failed= asks EasyBuild which log in it is the build's. + +1. The pipeline runs =eb --tmp-logdir=DIR=, with =DIR= under the run directory, =LOGDIR/easybuild-logs/NAME=, on a file system the end of the job leaves alone. + EasyBuild writes the session log there. +2. =failed= runs =eb --last-log --tmp-logdir=DIR --output-style=basic= and takes the last line it prints as the session log's path. + The basic output style prints the path whole. + An =eb= older than 4.5 has no =--output-style= and refuses it, but does not fold either, so when that call fails or prints nothing, =failed= asks again without the option. +3. =failed= copies the session log next to the build's output, =LOGDIR/NAME.stdout.log=, as =NAME.failed.ebout.log=. +4. For the command's output, =failed= takes the last =run-shell-cmd-output= path that =NAME.stdout.log= names, which is the command whose error EasyBuild printed. + When the build's output names none, it takes the last one the session log names, unless the session log records that command as completed successfully: a build that fails its sanity check fails after its last command worked, and that command's output is not the diagnosis. + It copies =out.txt=, and =err.txt= beside it when EasyBuild kept the command's stderr apart. +5. When the session log shows a =meson test -C DIR= command, =failed= also copies =DIR/meson-logs/testlog.txt=, unless its summary shows every test passing: meson prints only the last 100 lines of a failing test. + +[[zig:eb-keep-logs.scan.lastCommandOutput]] and [[zig:eb-keep-logs.scan.failedCommandOutput]] are the two searches for the command's output. + +=eb --last-log= gets a deadline. +When it has not returned after 300 seconds, its process group is stopped with =SIGTERM= and then =SIGKILL=, and =failed= keeps nothing, so a stalled file system holds the pipeline for 5 minutes, not for good. + +The command output's path is text the build printed, and the software's own build system writes part of that text. +So =failed= copies only what EasyBuild itself could have written for this account: a regular file under =EASYBUILD_TMPDIR=, compared with both paths resolved, that belongs to the user running =failed=. +It opens the file without following a symbolic link at the last component, and checks the file it opened, not the path. +A file elsewhere, or another user's, is reported and left where it is; a symbolic link is not opened. + +Without =TMP_LOGDIR=, =eb --last-log= names the newest log in EasyBuild's default place, which can be another build's: one the pipeline ran after the failure, or one running beside it. +A log that shows EasyBuild processing an easyconfig and never names =NAME.eb= is taken for such a log: =failed= keeps nothing from it, says so, and keeps the command output that =NAME.stdout.log= names. + +** What was considered and turned down + +- /Reading the log's path from the build's output./ + It names the easyconfig's log, not the session log, and arrives folded. +- /Keeping the easyconfig's own log./ + The session log covers the whole =eb= run, including what EasyBuild did before it reached the easyconfig that failed. +- /Keeping the last command's output whatever its outcome./ + After a sanity check fails, that is the output of a command that worked. +- /Waiting for =eb --last-log= without a limit./ + The shell script does; the binary does not, as [[file:../reference/compatibility.org][Compatibility]] records. + +** Limits + +- =failed= needs =eb= on the =PATH= it runs with. + Without it, nothing is kept, not even the command's output, which needs no =eb=. +- A session log larger than 1 GiB is copied but not read: =failed= does not check whether it is another build's, and finds no command output or meson test log in it. +- The command output is found only through EasyBuild 5's =run-shell-cmd-output= paths; with an =eb= that writes none, =failed= keeps the session log alone. +- Without =TMP_LOGDIR=, a log of an =eb= run that processed no easyconfig cannot be told from the build's own, and is kept. + +** Further reading + +- [[file:../howto/call-from-a-pipeline.org][Call eb-keep-logs from a build pipeline]] +- EasyBuild's pages on [[https://docs.easybuild.io/log-files/][log files]] and on [[https://docs.easybuild.io/easybuild-v5/run_shell_cmd/][run_shell_cmd]], which saves each command's output. +- [[site:zig-common:explanation/process-groups-and-deadlines][Process groups and deadlines]], how the deadline stops =eb= and whatever it started. diff --git a/docs/orgmode/howto/call-from-a-pipeline.org b/docs/orgmode/howto/call-from-a-pipeline.org new file mode 100644 index 0000000..d325e30 --- /dev/null +++ b/docs/orgmode/howto/call-from-a-pipeline.org @@ -0,0 +1,90 @@ +#+TITLE: Call eb-keep-logs from a build pipeline +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* Call eb-keep-logs from a build pipeline + +Use this when a script builds each easyconfig of a build list with =eb=, in a batch job whose temporary directories are cleaned when it ends. +The script keeps each failed build's logs next to its output and, at the end of the run, compresses and removes old runs. +[[https://github.com/stackhands/eb-pipeline][eb-pipeline]] makes the same calls itself, as its site file's =[logs]= table sets. + +** Before you start + +- =eb= and =eb-keep-logs= on the job's =PATH=. + [[file:../tutorials/keep-a-failed-build-log.org][Keep a failed build's logs]] installs =eb-keep-logs=. +- =bash= to run the script: it reads the exit status of =eb= from =PIPESTATUS=. +- A directory for the logs of every run, here =~/build-logs=, that the build account can write and the end of a job leaves alone. +- A build list, here =zen4.list=, with one easyconfig per line. + +** Steps + +1. Start the run: make its log directory, named by the date and time, and choose EasyBuild's temporary directory. + + #+begin_src bash + LOGDIR=~/build-logs/$(date +%Y%m%d_%H%M%S) + mkdir -p "$LOGDIR" + export EASYBUILD_TMPDIR=/tmp/$USER/easybuild + #+end_src + + =eb-keep-logs rotate= tells a run's age from its name, =YYYYMMDD_HHMMSS=, and =eb-keep-logs failed= copies a failed command's output only from under =EASYBUILD_TMPDIR=. +2. Build each easyconfig with its own =--tmp-logdir= and output file, and call =eb-keep-logs failed= after it: + + #+begin_src bash + mapfile -t easyconfigs < zen4.list + for ec in "${easyconfigs[@]}"; do + name=$(basename "$ec" .eb) + eb "$ec" --robot --tmp-logdir="$LOGDIR/easybuild-logs/$name" 2>&1 \ + | tee "$LOGDIR/$name.stdout.log" + status=${PIPESTATUS[0]} + eb-keep-logs failed "$status" "$name" "$LOGDIR" "$LOGDIR/easybuild-logs/$name" \ + || echo "eb-keep-logs failed exited $? for $name" >&2 + done + #+end_src + + =failed= reads =LOGDIR/NAME.stdout.log= and asks =eb= for the newest log in the =--tmp-logdir= it is given, so the name and the directory must be the ones the build used. + After a build that succeeded, it keeps and changes nothing. + When it refuses its arguments, the loop reports that and goes on with the next build. +3. End the run by rotating the log tree, with rotate's own output in this run's directory: + + #+begin_src bash + eb-keep-logs rotate ~/build-logs --compress-after 30 --delete-after 365 \ + > "$LOGDIR/rotate.log" 2>&1 + #+end_src + + =rotate= leaves alone the run that holds its output, so this run stays as it is however long it took, and a later run's =rotate= compresses it once it is old enough. + +** Check that it worked + +List the run's directory and read rotate's summary. +Here the list held one easyconfig, the tutorial's, whose build fails: + +#+begin_src bash +ls "$LOGDIR" +cat "$LOGDIR/rotate.log" +#+end_src + +#+begin_example +Example-1.0.failed.command-out.txt +Example-1.0.failed.ebout.log +Example-1.0.stdout.log +easybuild-logs +rotate.log +eb-keep-logs rotate: 0 files compressed, 0 runs deleted under /home/alice/build-logs +#+end_example + +Each build has =NAME.stdout.log= and its =--tmp-logdir= under =easybuild-logs/=; a failed build also has =NAME.failed.ebout.log= and, when its last command failed, =NAME.failed.command-out.txt=. + +** If it fails + +| Message | Cause | What to do | +|--------------------------------------------------------------------------+--------------------------------------------------------------------------------------+------------------------------------------------------------------| +| =No EasyBuild log to keep for NAME: eb is not on PATH.= | =eb= is not on the =PATH= =failed= runs with. | Make =eb= available before the loop, for =failed= as for =eb=. | +| =No EasyBuild log to keep for NAME.= | =eb= wrote no log to the =--tmp-logdir= given to =failed=. | Give =eb= and =failed= the same directory. | +| =Failed command output not kept: EASYBUILD_TMPDIR is not set.= | =EASYBUILD_TMPDIR= is not in the environment of =failed=. | Export it at the start of the run. | +| =Failed command output not kept: PATH is not under EASYBUILD_TMPDIR.= | =eb= used another temporary directory, as when =--tmpdir= is on its command line. | Set EasyBuild's temporary directory with =EASYBUILD_TMPDIR= only. | +| =eb-keep-logs: LOGDIR PATH is not a directory= | The run's directory was not made. | Make it at the start of the run. | + +** Related + +- [[file:../explanation/why-eb-last-log.org][Finding a failed build's log]] +- [[file:../tutorials/keep-a-failed-build-log.org][Keep a failed build's logs]] diff --git a/docs/orgmode/howto/index.org b/docs/orgmode/howto/index.org new file mode 100644 index 0000000..ffe3918 --- /dev/null +++ b/docs/orgmode/howto/index.org @@ -0,0 +1,15 @@ +#+TITLE: How-to guides +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* How-to guides + +Each guide gets one task done for a reader who already knows what they want. +The title names the task. + +#+begin_export rst +.. toctree:: + :maxdepth: 1 + + call-from-a-pipeline +#+end_export diff --git a/docs/orgmode/index.org b/docs/orgmode/index.org new file mode 100644 index 0000000..aba5930 --- /dev/null +++ b/docs/orgmode/index.org @@ -0,0 +1,53 @@ +#+TITLE: eb-keep-logs +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* eb-keep-logs + +Keep the logs of EasyBuild builds that a build pipeline would otherwise lose, and keep the pipeline's log tree bounded. +After a failed build, =eb-keep-logs failed= copies the EasyBuild log and the failing command's own output next to the build's output, where the end of the job does not take them, and closes the copies to other users, because a failed compile line of licensed software can print the licence number. +=eb-keep-logs rotate= compresses the logs of old runs and removes the oldest runs. +Each release is one static binary per architecture that needs nothing but =eb=; the shell script it was ported from stays in the repository as the same tool. + +New here? +[[file:tutorials/keep-a-failed-build-log.org][Keep a failed build's logs]] runs an EasyBuild build that fails and ends with its log and the compiler's error kept in a directory of your own. + +| You want to | Read | +|----------------------------------+---------------------------------------------| +| learn by doing, start to finish | [[file:tutorials/index.org][Tutorials]] | +| get one task done | [[file:howto/index.org][How-to guides]] | +| understand why it works this way | [[file:explanation/index.org][Explanation]] | +| look up a command, file or API | [[file:reference/index.org][Reference]] | + +#+begin_export rst +.. toctree:: + :hidden: + :caption: Tutorials + + tutorials/index + +.. toctree:: + :hidden: + :caption: How-to guides + + howto/index + +.. toctree:: + :hidden: + :caption: Explanation + + explanation/index + +.. toctree:: + :hidden: + :caption: Reference + + reference/index + +.. toctree:: + :hidden: + :caption: Project + + contributing + changelog +#+end_export diff --git a/docs/orgmode/reference/api.org b/docs/orgmode/reference/api.org new file mode 100644 index 0000000..1b57d09 --- /dev/null +++ b/docs/orgmode/reference/api.org @@ -0,0 +1,18 @@ +#+TITLE: API +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* API + +The API pages are generated from the code on every build, so they match the commit the site was built from. +A declaration's doc comment is its description. + +- [[file:api/zig/index.md][Zig API]]: every =pub= declaration, one page per source file, read with the compiler's own parser by =docs/tools/zig_api.zig=, each linked to its source line at that commit. +- [[autodoc:/][Zig autodoc]]: the same declarations in the browser =zig build docs= makes, with search and source views. + +#+begin_export rst +.. toctree:: + :hidden: + + api/zig/index +#+end_export diff --git a/docs/orgmode/reference/compatibility.org b/docs/orgmode/reference/compatibility.org new file mode 100644 index 0000000..914279a --- /dev/null +++ b/docs/orgmode/reference/compatibility.org @@ -0,0 +1,9 @@ +#+TITLE: Compatibility +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil + +# COMPAT.md at the top of the repository is the one record; this page shows it. + +#+begin_export rst +.. include:: ../../../COMPAT.md + :parser: myst_parser.sphinx_ +#+end_export diff --git a/docs/orgmode/reference/index.org b/docs/orgmode/reference/index.org new file mode 100644 index 0000000..e657b89 --- /dev/null +++ b/docs/orgmode/reference/index.org @@ -0,0 +1,16 @@ +#+TITLE: Reference +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* Reference + +Descriptions of what there is: commands, options, files, environment variables, exit codes and the API. +Each page states facts in the order the thing itself has them. + +#+begin_export rst +.. toctree:: + :maxdepth: 1 + + compatibility + api +#+end_export diff --git a/docs/orgmode/tutorials/index.org b/docs/orgmode/tutorials/index.org new file mode 100644 index 0000000..9e67af3 --- /dev/null +++ b/docs/orgmode/tutorials/index.org @@ -0,0 +1,15 @@ +#+TITLE: Tutorials +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* Tutorials + +A tutorial is a lesson: follow it from the top on a machine like the one it names and it ends with something working. +It explains only what the next step needs; [[file:../explanation/index.org][Explanation]] has the reasons. + +#+begin_export rst +.. toctree:: + :maxdepth: 1 + + keep-a-failed-build-log +#+end_export diff --git a/docs/orgmode/tutorials/keep-a-failed-build-log.org b/docs/orgmode/tutorials/keep-a-failed-build-log.org new file mode 100644 index 0000000..07964a9 --- /dev/null +++ b/docs/orgmode/tutorials/keep-a-failed-build-log.org @@ -0,0 +1,188 @@ +#+TITLE: Keep a failed build's logs +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* Keep a failed build's logs + +By the end of this tutorial you will have an EasyBuild build that failed, with its EasyBuild log and the compiler's error kept in a directory of your own and closed to other users. +Every command runs as an ordinary user on a Linux machine with EasyBuild 5. + +** What you will need + +- A Linux machine with =curl= and a C compiler, =cc=. +- EasyBuild 5, with Lmod for its modules: + + #+begin_src bash + eb --version + #+end_src + + #+begin_example + This is EasyBuild 5.4.2 (framework: 5.4.2, easyblocks: 5.4.2) on host login1. + #+end_example + + If =eb= is not found, follow EasyBuild's [[https://docs.easybuild.io/installation/][installation guide]] first. +- =~/.local/bin= on your =PATH=. + +** Install eb-keep-logs + +# The 0.2.1 release binary keeps no log when EasyBuild 5.3 or later folds the +# path eb --last-log prints, which later commits fix. Install the release +# binary here once a release after 0.2.1 is out, and run the tutorial again. +Download =eb-keep-logs=, the shell script, at a fixed commit into =~/.local/bin=, and make it executable: + +#+begin_src bash +curl -sSfL -o ~/.local/bin/eb-keep-logs \ + https://raw.githubusercontent.com/stackhands/eb-keep-logs/5ceaead6b7f1ab7a0f5ddcc0fad14f6d3a51f5cc/eb-keep-logs +chmod 0755 ~/.local/bin/eb-keep-logs +command -v eb-keep-logs +#+end_src + +#+begin_example +/home/alice/.local/bin/eb-keep-logs +#+end_example + +** Make a directory for this run's logs + +Name it by the date and time, =YYYYMMDD_HHMMSS=, which is how =eb-keep-logs rotate= tells how old a run is: + +#+begin_src bash +LOGDIR=~/build-logs/$(date +%Y%m%d_%H%M%S) +mkdir -p "$LOGDIR" +echo "$LOGDIR" +#+end_src + +#+begin_example +/home/alice/build-logs/20261116_175326 +#+end_example + +** Choose EasyBuild's temporary directory + +EasyBuild saves the output of every command it runs under its temporary directory, and =eb-keep-logs= copies a failed command's output only from inside it, so give both the same one: + +#+begin_src bash +export EASYBUILD_TMPDIR=/tmp/$USER/easybuild +#+end_src + +** Write a build that fails + +Save this easyconfig in your home directory as =Example-1.0.eb=. +It compiles one C file with =cc= into its installation directory: + +#+INCLUDE: "keep-a-failed-build-log/Example-1.0.eb" src python + +Save the C file next to it as =example.c=. +It prints a variable that it never declares, so the compiler stops with an error: + +#+INCLUDE: "keep-a-failed-build-log/example.c" src c + +** Run the build + +Run =eb= with =--tmp-logdir= in the run directory, so that EasyBuild writes its log there and not to a temporary place, and copy everything it prints into =Example-1.0.stdout.log= with =tee=. +The second line saves the exit status of =eb=, the first command of the pipeline: + +#+begin_src bash +eb Example-1.0.eb --tmp-logdir="$LOGDIR/easybuild-logs/Example-1.0" 2>&1 | tee "$LOGDIR/Example-1.0.stdout.log" +status=${PIPESTATUS[0]} +#+end_src + +#+begin_example +ERROR: Shell command failed! + full command -> cc example.c -o /home/alice/.local/easybuild/software/Example/1.0/example + exit code -> 1 +... + output (stdout + stderr) -> /tmp/alice/easybuild/eb-ak_95u_p/run-shell-cmd-output/cc-maxoyd5r/out.txt +... +== Temporary log file in case of crash /home/alice/build-logs/20261116_175326/easybuild-logs/Example-1.0/easybuild-id6ffdi2.log +... +== FAILED: Installation ended unsuccessfully: shell command 'cc ...' failed with exit code 1 in install step for Example-1.0.eb (took 0 secs) +== Results of the build can be found in the log file(s) /home/alice/build-logs/20261116_175326/easybuild-logs/Example-1.0/easybuild-Example-1.0-20261116.175326.iEeXN.log +== Summary: + * [FAILED] Example/1.0 +#+end_example + +The error comes first: =eb= writes it to stderr at once, while its progress lines on stdout wait in a buffer, as stdout is a pipe. +=eb= exited with 18, EasyBuild's status for a failed installation step: + +#+begin_src bash +echo "$status" +#+end_src + +#+begin_example +18 +#+end_example + +** Keep its logs + +Give =eb-keep-logs failed= the status, the easyconfig's name without =.eb=, the run directory and the =--tmp-logdir=: + +#+begin_src bash +eb-keep-logs failed "$status" Example-1.0 "$LOGDIR" "$LOGDIR/easybuild-logs/Example-1.0" +#+end_src + +#+begin_example +Failed build log: /home/alice/build-logs/20261116_175326/Example-1.0.failed.ebout.log +Failed command output: /home/alice/build-logs/20261116_175326/Example-1.0.failed.command-out.txt +#+end_example + +** Look at what it kept + +#+begin_src bash +ls -l "$LOGDIR" +#+end_src + +#+begin_example +total 56 +-rw------- 1 alice alice 145 Nov 16 17:53 Example-1.0.failed.command-out.txt +-rw------- 1 alice alice 44794 Nov 16 17:53 Example-1.0.failed.ebout.log +-rw-rw---- 1 alice alice 2475 Nov 16 17:53 Example-1.0.stdout.log +drwxrwxr-x 3 alice alice 4096 Nov 16 17:53 easybuild-logs +#+end_example + +The two copies and the build's output are closed to other users, and so is the =--tmp-logdir=, with EasyBuild's logs in it: + +#+begin_src bash +ls -ld "$LOGDIR/easybuild-logs/Example-1.0" +#+end_src + +#+begin_example +drwxrwx--- 3 alice alice 4096 Nov 16 17:53 /home/alice/build-logs/20261116_175326/easybuild-logs/Example-1.0 +#+end_example + +The command output is the compiler's error, of which the build printed only the path: + +#+begin_src bash +cat "$LOGDIR/Example-1.0.failed.command-out.txt" +#+end_src + +#+begin_example +example.c:5:20: error: use of undeclared identifier 'answer' + 5 | printf("%d\n", answer); + | ^ +1 error generated. +#+end_example + +=.licensed-logs= in the run directory names the copies: + +#+begin_src bash +cat "$LOGDIR/.licensed-logs" +#+end_src + +#+begin_example +/home/alice/build-logs/20261116_175326/Example-1.0.failed.ebout.log +/home/alice/build-logs/20261116_175326/Example-1.0.failed.command-out.txt +#+end_example + +** What just happened + +1. =failed= asked =eb --last-log= which log the build wrote to the =--tmp-logdir=, instead of reading the path from the build's output, and copied that log, the session log of the whole =eb= run. + [[file:../explanation/why-eb-last-log.org][Finding a failed build's log]] says why. +2. The build's output named the file that holds the failed command's output. + It lay under =EASYBUILD_TMPDIR= and belonged to you, so =failed= copied it. +3. A failed compile line of licensed software can print the licence number, so =failed= closed both copies, the build's output and the =--tmp-logdir= to other users, and listed the copies in =.licensed-logs=. +4. The run directory's name holds its date, from which =eb-keep-logs rotate= later decides to compress the run's logs and then to remove the run. + +** Next steps + +- [[file:../howto/call-from-a-pipeline.org][Call eb-keep-logs from a build pipeline]] + +Checked with EasyBuild 5.4.2, Lmod 8.6.19 and eb-keep-logs at commit 5ceaead on 2026-11-16. diff --git a/docs/orgmode/tutorials/keep-a-failed-build-log/Example-1.0.eb b/docs/orgmode/tutorials/keep-a-failed-build-log/Example-1.0.eb new file mode 100644 index 0000000..99bc643 --- /dev/null +++ b/docs/orgmode/tutorials/keep-a-failed-build-log/Example-1.0.eb @@ -0,0 +1,21 @@ +easyblock = 'Binary' + +name = 'Example' +version = '1.0' + +homepage = 'https://example.org' +description = "A program whose build fails, to show what eb-keep-logs keeps." + +toolchain = SYSTEM + +sources = ['example.c'] +checksums = ['6f3d50a25fc7773d3eb35ec1da673acd588e5af0c610acfb4c81918fe4c87231'] + +install_cmd = "cc example.c -o %(installdir)s/example" + +sanity_check_paths = { + 'files': ['example'], + 'dirs': [], +} + +moduleclass = 'tools' diff --git a/docs/orgmode/tutorials/keep-a-failed-build-log/example.c b/docs/orgmode/tutorials/keep-a-failed-build-log/example.c new file mode 100644 index 0000000..99c259b --- /dev/null +++ b/docs/orgmode/tutorials/keep-a-failed-build-log/example.c @@ -0,0 +1,7 @@ +#include + +int main(void) +{ + printf("%d\n", answer); + return 0; +} diff --git a/docs/releasing.md b/docs/releasing.md deleted file mode 100644 index 2d2f9c8..0000000 --- a/docs/releasing.md +++ /dev/null @@ -1,2 +0,0 @@ -```{include} ../RELEASING.md -``` diff --git a/docs/requirements.txt b/docs/requirements.txt deleted file mode 100644 index f14828e..0000000 --- a/docs/requirements.txt +++ /dev/null @@ -1,4 +0,0 @@ -Sphinx==8.2.3 -myst-parser==5.1.0 -shibuya==2025.12.13 -sphinx-copybutton==0.5.2 diff --git a/docs/source/_ext/zig_domain.py b/docs/source/_ext/zig_domain.py new file mode 100644 index 0000000..3b2f143 --- /dev/null +++ b/docs/source/_ext/zig_domain.py @@ -0,0 +1,280 @@ +"""A Sphinx domain for Zig declarations. + +docs/tools/zig_api.zig writes one ``zig:`` directive per public declaration:: + + :::{zig:function} zig_common.proc.run + :signature: pub fn run(gpa: Allocator, argv: []const []const u8, ...) Error!Result + :source: https://github.com/stackhands/zig-common/blob//src/proc.zig#L120 + + The doc comment, as Markdown. + ::: + +The argument is the fully qualified name; it is the HTML anchor and the +key for cross-references and for the objects.inv inventory, so other +stackhands sites reach it through intersphinx. Roles: ``zig:mod``, +``zig:type``, ``zig:fn``, ``zig:const``, ``zig:var``, ``zig:field``, +``zig:err``, and ``zig:obj`` for any kind. A target matches a full name, or +failing that a unique dotted suffix (``proc.run``); ``~`` before the target +shows only its last part. ``zig:autodoc`` links into the autodoc site at +``zig_autodoc_root``, which every directive also links to. +""" + +from __future__ import annotations + +import posixpath +import re +from typing import Any, ClassVar, Iterable + +from docutils import nodes +from docutils.nodes import Element, Node +from docutils.parsers.rst import directives +from sphinx import addnodes +from sphinx.addnodes import desc_signature, pending_xref +from sphinx.application import Sphinx +from sphinx.builders import Builder +from sphinx.directives import ObjectDescription +from sphinx.domains import Domain, ObjType +from sphinx.environment import BuildEnvironment +from sphinx.roles import XRefRole +from sphinx.util import logging +from sphinx.util.docutils import SphinxRole +from sphinx.util.nodes import make_refnode, split_explicit_title + +logger = logging.getLogger(__name__) + +LABELS = { + "module": "module", + "type": "type", + "errorset": "error set", + "function": "function", + "constant": "constant", + "variable": "variable", + "field": "field", + "error": "error", +} + + +def autodoc_href(env: BuildEnvironment, fqn: str) -> str | None: + """The autodoc URL of *fqn*, relative to the page being read.""" + root = env.config.zig_autodoc_root + if not root: + return None + up = posixpath.relpath(".", posixpath.dirname(env.docname) or ".") + base = posixpath.normpath(posixpath.join(up, root)) + "/" + fqn = fqn.strip("/") + return base + ("#" + fqn if fqn else "") + + +def link(text: str, href: str, cls: str) -> nodes.reference: + ref = nodes.reference("", "", internal=False, refuri=href, classes=[cls]) + ref += nodes.inline(text, text) + return ref + + +class ZigObject(ObjectDescription[str]): + """One declaration; its argument is the fully qualified name.""" + + has_content = True + required_arguments = 1 + final_argument_whitespace = False + option_spec: ClassVar[dict[str, Any]] = { + "signature": directives.unchanged, + "source": directives.unchanged, + "file": directives.unchanged, + "no-autodoc": directives.flag, + "no-index": directives.flag, + "no-index-entry": directives.flag, + "no-contents-entry": directives.flag, + } + + def handle_signature(self, sig: str, signode: desc_signature) -> str: + fqn = sig.strip() + short = fqn.rsplit(".", 1)[-1] + text = self.options.get("signature") or ("module " + fqn if self.objtype == "module" else short) + signode["fullname"] = fqn + match = re.search(r"(? None: + # The page title of a module named like a slug ("eb-local") already + # owns the bare id. Sphinx writes anchors into href attributes + # unescaped, so a quote or space would cut the link short. + anchor = re.sub(r"[^\w.\-]", "-", name) + if self.objtype == "module": + anchor = "module-" + anchor + signode["ids"].append(anchor) + self.state.document.note_explicit_target(signode) + domain: ZigDomain = self.env.domains["zig"] # type: ignore[assignment] + domain.note_object(name, self.objtype, anchor, location=signode) + if "no-index-entry" not in self.options: + label = LABELS[self.objtype] + self.indexnode["entries"].append(("single", f"{name} (Zig {label})", anchor, "", None)) + + def _object_hierarchy_parts(self, sig_node: desc_signature) -> tuple[str, ...]: + if self.objtype == "module" or "fullname" not in sig_node: + return () + return tuple(sig_node["fullname"].split(".")) + + def _toc_entry_name(self, sig_node: desc_signature) -> str: + parts = sig_node.get("_toc_parts") + if not parts: + return "" + parens = "()" if self.objtype == "function" and self.config.add_function_parentheses else "" + show = self.config.toc_object_entries_show_parents + if show == "all": + return ".".join(parts) + parens + return parts[-1] + parens + + +class ZigXRefRole(XRefRole): + def process_link( + self, env: BuildEnvironment, refnode: Element, has_explicit_title: bool, title: str, target: str + ) -> tuple[str, str]: + target = target.lstrip("~") + if not has_explicit_title: + title = title.lstrip(".") + if title.startswith("~"): + title = title[1:].rsplit(".", 1)[-1] + return title, target.lstrip(".") + + +class ZigAutodocRole(SphinxRole): + """``:zig:autodoc:`zig_common.proc```, or ``:zig:autodoc:`text ``` for the front page.""" + + def run(self) -> tuple[list[Node], list[nodes.system_message]]: + explicit, title, target = split_explicit_title(self.text) + target = target.strip() + href = autodoc_href(self.env, target) + if href is None: + return [nodes.Text(title)], [] + return [link(title if explicit else (target or "Zig autodoc"), href, "zig-autodoc-link")], [] + + +class ZigDomain(Domain): + name = "zig" + label = "Zig" + object_types: ClassVar[dict[str, ObjType]] = { + "module": ObjType("module", "mod", "obj"), + "type": ObjType("type", "type", "obj"), + "errorset": ObjType("error set", "err", "type", "obj"), + "function": ObjType("function", "fn", "func", "obj"), + "constant": ObjType("constant", "const", "obj"), + "variable": ObjType("variable", "var", "obj"), + "field": ObjType("field", "field", "obj"), + "error": ObjType("error", "err", "obj"), + } + directives: ClassVar[dict[str, type[ObjectDescription]]] = {k: ZigObject for k in object_types} + roles: ClassVar[dict[str, Any]] = { + **{r: ZigXRefRole() for r in ("mod", "type", "err", "fn", "func", "const", "var", "field", "obj")}, + "autodoc": ZigAutodocRole(), + } + initial_data: ClassVar[dict[str, Any]] = {"objects": {}} + data_version = 1 + + @property + def objects(self) -> dict[str, tuple[str, str, str]]: + """Full name -> (docname, anchor, object type).""" + return self.data.setdefault("objects", {}) + + def note_object(self, fqn: str, objtype: str, anchor: str, location: Any = None) -> None: + if fqn in self.objects: + other = self.objects[fqn][0] + logger.warning("duplicate Zig object %s, also in %s", fqn, other, location=location, type="zig", subtype="duplicate") + self.objects[fqn] = (self.env.docname, anchor, objtype) + + def clear_doc(self, docname: str) -> None: + for fqn, (doc, _anchor, _objtype) in list(self.objects.items()): + if doc == docname: + del self.objects[fqn] + + def merge_domaindata(self, docnames: Iterable[str], otherdata: dict[str, Any]) -> None: + for fqn, entry in otherdata["objects"].items(): + if entry[0] in docnames: + self.objects[fqn] = entry + + def find(self, target: str, objtypes: Iterable[str] | None) -> list[tuple[str, tuple[str, str, str]]]: + wanted = set(objtypes) if objtypes is not None else None + + def ok(entry: tuple[str, str, str]) -> bool: + return wanted is None or entry[2] in wanted + + entry = self.objects.get(target) + if entry is not None and ok(entry): + return [(target, entry)] + suffix = "." + target + return [(fqn, e) for fqn, e in self.objects.items() if fqn.endswith(suffix) and ok(e)] + + def resolve_xref( + self, + env: BuildEnvironment, + fromdocname: str, + builder: Builder, + typ: str, + target: str, + node: pending_xref, + contnode: Element, + ) -> nodes.reference | None: + matches = self.find(target, self.objtypes_for_role(typ)) + if not matches: + return None + if len(matches) > 1: + logger.warning( + "more than one Zig object matches %r: %s", + target, + ", ".join(sorted(m[0] for m in matches)), + location=node, + type="ref", + subtype="zig", + ) + fqn, (docname, anchor, _objtype) = matches[0] + return make_refnode(builder, fromdocname, docname, anchor, contnode, fqn) + + def resolve_any_xref( + self, + env: BuildEnvironment, + fromdocname: str, + builder: Builder, + target: str, + node: pending_xref, + contnode: Element, + ) -> list[tuple[str, nodes.reference]]: + results = [] + for fqn, (docname, anchor, objtype) in self.find(target, None): + role = self.role_for_objtype(objtype) or "obj" + results.append((f"zig:{role}", make_refnode(builder, fromdocname, docname, anchor, contnode, fqn))) + return results + + def get_objects(self) -> Iterable[tuple[str, str, str, str, str, int]]: + for fqn, (docname, anchor, objtype) in self.objects.items(): + yield fqn, fqn, objtype, docname, anchor, 1 + + def get_full_qualified_name(self, node: Element) -> str | None: + return node.get("reftarget") + + +def setup(app: Sphinx) -> dict[str, Any]: + app.add_config_value("zig_autodoc_root", "", "env", types=frozenset({str})) + app.add_domain(ZigDomain) + return {"version": "1", "env_version": 1, "parallel_read_safe": True, "parallel_write_safe": True} diff --git a/docs/_static/favicon.svg b/docs/source/_static/favicon.svg similarity index 100% rename from docs/_static/favicon.svg rename to docs/source/_static/favicon.svg diff --git a/docs/_static/logo-dark.svg b/docs/source/_static/logo-dark.svg similarity index 100% rename from docs/_static/logo-dark.svg rename to docs/source/_static/logo-dark.svg diff --git a/docs/_static/logo-light.svg b/docs/source/_static/logo-light.svg similarity index 100% rename from docs/_static/logo-light.svg rename to docs/source/_static/logo-light.svg diff --git a/docs/_static/mark-dark.svg b/docs/source/_static/mark-dark.svg similarity index 100% rename from docs/_static/mark-dark.svg rename to docs/source/_static/mark-dark.svg diff --git a/docs/_static/mark.svg b/docs/source/_static/mark.svg similarity index 100% rename from docs/_static/mark.svg rename to docs/source/_static/mark.svg diff --git a/docs/source/_static/stackhands.css b/docs/source/_static/stackhands.css new file mode 100644 index 0000000..9573490 --- /dev/null +++ b/docs/source/_static/stackhands.css @@ -0,0 +1,23 @@ +/* Zig API pages: keep long signatures readable and the links to source + and autodoc out of the way. */ +dl.zig > dt.sig { + flex-wrap: wrap; + row-gap: 0.25rem; +} + +dl.zig > dt.sig .zig-sig-rest { + white-space: pre-wrap; +} + +dl.zig > dt.sig .zig-source-link, +dl.zig > dt.sig .zig-autodoc-link { + margin-left: 0.75rem; + font-family: var(--sy-f-text, inherit); + font-size: 0.8em; + font-weight: normal; +} + +dl.zig.field > dt.sig, +dl.zig.error > dt.sig { + font-size: 0.95em; +} diff --git a/docs/source/conf.py b/docs/source/conf.py new file mode 100644 index 0000000..fdb2afc --- /dev/null +++ b/docs/source/conf.py @@ -0,0 +1,254 @@ +"""Sphinx configuration for the eb-keep-logs documentation. + +The pages are Org files under docs/orgmode/, exported here as reStructuredText +by docs/export.el. The API reference under reference/api/ is generated from +the code. Neither is committed: `pixi run -e docs docbld` makes both. +""" + +import os +import re +import sys + +from docutils import nodes + +_here = os.path.dirname(os.path.abspath(__file__)) +_repo = os.path.abspath(os.path.join(_here, "..", "..")) +sys.path.insert(0, os.path.join(_here, "_ext")) + +project = "eb-keep-logs" +author = "stackhands developers" +copyright = "stackhands developers" + + +def _release(): + """The version the build files declare: build.zig.zon, pyproject.toml or Cargo.toml.""" + for name, pattern in ( + ("build.zig.zon", r'^\s*\.version\s*=\s*"([^"]+)"'), + ("pyproject.toml", r'^version\s*=\s*"([^"]+)"'), + ("Cargo.toml", r'^version\s*=\s*"([^"]+)"'), + ): + path = os.path.join(_repo, name) + if os.path.isfile(path): + found = re.search(pattern, open(path, encoding="utf-8").read(), re.M) + if found: + return found.group(1) + return "" + + +release = version = _release() + +extensions = [ + "myst_parser", + "sphinx.ext.intersphinx", + "sphinx_copybutton", + "sphinx_design", + "sphinx_sitemap", + "zig_domain", +] + +# Generated API pages are MyST Markdown, as doc comments are Markdown; the +# exported Org pages are reStructuredText. +source_suffix = {".rst": "restructuredtext", ".md": "markdown"} +myst_enable_extensions = ["colon_fence", "deflist", "fieldlist"] +exclude_patterns = [] +templates_path = ["_templates"] + +# Every cross-reference must resolve: sphinx-build runs with -W -n. +nitpicky = True +nitpick_ignore = [] +manpages_url = "https://man7.org/linux/man-pages/man{section}/{page}.{section}.html" +# Doc comments and docstrings name flags in plain text: --strict stays two +# hyphens. +smartquotes_action = "qe" + +# -- API reference ----------------------------------------------------------- +# Zig: docs/tools/zig_api.zig writes reference/api/zig/ (pixi task mkapi), and +# `zig build docs` puts the autodoc site at api/ (pixi task autodoc). +zig_autodoc_root = "api/" + +# Python: sphinx-autoapi reads the packages listed here, without importing +# them, into reference/api/python/. +PYTHON_PACKAGES = [] +if PYTHON_PACKAGES: + extensions.append("autoapi.extension") + autoapi_type = "python" + autoapi_dirs = [os.path.join(_repo, p) for p in PYTHON_PACKAGES] + autoapi_root = "reference/api/python" + autoapi_add_toctree_entry = False + autoapi_keep_files = False + autoapi_member_order = "groupwise" + # undoc-members: a module or class without a docstring is still listed, + # so the reference is complete and the gap shows. + autoapi_options = [ + "members", + "undoc-members", + "show-inheritance", + "show-module-summary", + "special-members", + "imported-members", + ] + autoapi_ignore = ["*/tests/*", "*/test_*.py", "*/conftest.py"] + +# Rust: sphinx-rustdocgen reads each crate listed here (crate name: its +# directory) into reference/api/rust//, for sphinxcontrib-rust. +RUST_CRATES = {} +if RUST_CRATES: + extensions.append("sphinxcontrib_rust") + rust_crates = {name: os.path.join(_repo, path) for name, path in RUST_CRATES.items()} + rust_doc_dir = os.path.join(_here, "reference", "api", "rust") + # Doc comments are Markdown, read by myst_parser. + rust_rustdoc_fmt = "md" + rust_generate_mode = "always" + # A rustdoc link to an item named like its module ([`gap`] in gap) also + # matches that module's page; MyST links the page, which lists the item. + suppress_warnings = ["myst.xref_ambiguous"] + # A type from std, core or another crate has no page here; a name in + # these crates that does not resolve still fails the build. + nitpick_ignore_regex = [ + (r"rust:.*", r"(?!(?:%s)(?:::|$)).*" % "|".join(RUST_CRATES)), + ("myst", r"\w+(?:::\w+)+"), + ] + +# -- Links to other sites ---------------------------------------------------- +# A link to another stackhands site resolves through that site's objects.inv, +# so a page or API name that does not exist there fails the build. A local +# build keeps the inventories it fetched for 30 days and works offline in +# that time; CI starts clean and always fetches them. +# stackhands-intersphinx:begin (written by docs-plan/template/apply.py) +intersphinx_mapping = { + "eb-staged-rebuild": ("https://stackhands.github.io/eb-staged-rebuild/", None), + "eessi-arch-guard": ("https://stackhands.github.io/eessi-arch-guard/", None), + "eb-local": ("https://stackhands.github.io/eb-local/", None), + "zig-common": ("https://stackhands.github.io/zig-common/", None), +} +# stackhands-intersphinx:end +intersphinx_mapping["python"] = ("https://docs.python.org/3", None) +intersphinx_cache_limit = 30 +intersphinx_timeout = 30 + +# -- HTML ---------------------------------------------------------------------- +html_theme = "shibuya" +html_title = "eb-keep-logs" +html_baseurl = "https://stackhands.github.io/eb-keep-logs/" +html_static_path = ["_static"] +html_css_files = ["stackhands.css"] +# The logos come from stackhands/.github branding (apply.py copies them). +_logos = { + name: "_static/" + name + for name in ("favicon.svg", "logo-light.svg", "logo-dark.svg") + if os.path.isfile(os.path.join(_here, "_static", name)) +} +html_favicon = _logos.get("favicon.svg") +html_copy_source = False +html_show_sourcelink = False +sitemap_url_scheme = "{link}" + +html_context = { + "source_type": "github", + "source_user": "stackhands", + "source_repo": "eb-keep-logs", + "source_version": "main", + "source_docs_path": "/docs/orgmode/", +} + +html_theme_options = { + "github_url": "https://github.com/stackhands/eb-keep-logs", + "accent_color": "teal", + "dark_code": True, + # Its "Copy page" menu links chat services, which check_site.py rejects. + "show_ai_links": False, + "globaltoc_expand_depth": 1, + "nav_links": [ + {"title": "Tutorial", "url": "tutorials/index"}, + {"title": "How-to", "url": "howto/index"}, + {"title": "Explanation", "url": "explanation/index"}, + {"title": "Reference", "url": "reference/index"}, + # stackhands:begin (generated by stackhands/.github branding/sync.py) + { + "title": "stackhands", + "children": [ + { + "title": "eb-stack", + "url": "https://eb-stack.rgoswami.me/", + "summary": "Solve, shard and plan an EasyBuild build list; admit builds under a scratch inode budget", + }, + { + "title": "eb-pipeline", + "url": "https://github.com/stackhands/eb-pipeline#readme", + "summary": "Drive an EasyBuild pipeline from one per-site TOML file, calling the other tools as subprocesses", + }, + { + "title": "eb-staged-rebuild", + "url": "https://stackhands.github.io/eb-staged-rebuild/", + "summary": "Rebuild an installation in a staged tree and swap it in, so running jobs keep their paths", + }, + { + "title": "eessi-arch-guard", + "url": "https://stackhands.github.io/eessi-arch-guard/", + "summary": "Reload EESSI in a Slurm task that inherited it for another CPU or GPU", + }, + { + "title": "eb-local", + "url": "https://stackhands.github.io/eb-local/", + "summary": "Install software with EasyBuild on top of EESSI into a directory a user or project owns", + }, + { + "title": "rfc9162", + "url": "https://stackhands.github.io/rfc9162/", + "summary": "Append-only Merkle logs hashed as RFC 9162, with tiled storage and signed checkpoints", + }, + { + "title": "zig-common", + "url": "https://stackhands.github.io/zig-common/", + "summary": "The shared Zig library under the Zig tools: system calls, checked files, child processes", + }, + ], + }, + # stackhands:end + ], +} +if "logo-light.svg" in _logos and "logo-dark.svg" in _logos: + html_theme_options["light_logo"] = _logos["logo-light.svg"] + html_theme_options["dark_logo"] = _logos["logo-dark.svg"] + +html_sidebars = { + "**": [ + "sidebars/localtoc.html", + "sidebars/repo-stats.html", + "sidebars/edit-this-page.html", + ], +} + + +def _edit_link(app, pagename, templatename, context, doctree): + """Point "edit this page" at the Org source; generated pages have none.""" + if pagename.startswith("reference/api/"): + context["page_source_suffix"] = None + else: + context["page_source_suffix"] = ".org" + + +def _unlink_rust_paths(app, doctree, docname): + """A rustdoc link to an item outside these crates stays as code, unlinked.""" + if not docname.startswith("reference/api/rust/"): + return + for ref in list(doctree.findall(nodes.reference)): + if re.fullmatch(r"\w+(?:::\w+)+", ref.get("refid", "")): + ref.replace_self(ref.children) + + +def setup(app): + app.connect("html-page-context", _edit_link) + if RUST_CRATES: + app.connect("doctree-resolved", _unlink_rust_paths) + if "local_setup" in globals(): + globals()["local_setup"](app) + + +# -- This repository ----------------------------------------------------------- +# apply.py rewrites everything above and keeps what is between these markers: +# the place for settings only this repository has, such as the Rust crates +# for sphinxcontrib-rust or a nitpick_ignore entry. Event hooks go in a +# function local_setup(app), which setup() calls. +# local:begin +# local:end diff --git a/docs/tools/check_site.py b/docs/tools/check_site.py new file mode 100644 index 0000000..186611b --- /dev/null +++ b/docs/tools/check_site.py @@ -0,0 +1,177 @@ +#!/usr/bin/env python3 +"""Check a built site: internal links, anchors and forbidden names. + + python docs/tools/check_site.py docs/build/html [--sources docs/orgmode] + [--forbid REGEX]... [--no-default-forbid] [--exempt PAGE]... + +Every relative href and src in every HTML page must name a file in the site, +and a #fragment on a page Sphinx made must name an id on that page. Under +api/, the Zig autodoc site, only files are checked: its anchors are made by +script. External links are lychee's job (pixi task linkcheck). + +A page may not link to a generated .rst file (the edit links go to the Org +sources), and no page's text or link targets, and no Org source, may carry +a forbidden pattern: by default the names and paths of one real site, as +the pages describe a neutral example site, and links to AI chat services. +--exempt names a built page, such as changelog.html, that records history: +its text and link targets are not checked for forbidden names, but its +links must still resolve. + +Exit status: 0 when clean, 1 when anything is wrong, 2 on a usage error. +""" + +import argparse +import html.parser +import os +import re +import sys +import urllib.parse + +# The repositories' CI greps the whole tree for these names, this file +# included, so each keeps one letter in a class: the pattern matches the +# name, and its own text does not. +DEFAULT_FORBID = [ + r"snelli[u]s", + r"sne[l]-", + r"surf\.nl", + r"surfsara", + r"/gp[f]s/", + r"/project[s]/0", + r"rg\.terra", + r"scratch-shar[e]d", + r"scratch-nod[e]", + r"eblocalinstal[l]", + r"chatgpt\.com", + r"claude\.ai", + r"perplexity\.ai", +] + +SCRIPTED_ANCHORS = ("api/",) + + +class Page(html.parser.HTMLParser): + def __init__(self): + super().__init__(convert_charrefs=True) + self.ids = set() + self.links = [] + self.text = [] + self._skip = 0 + + def handle_starttag(self, tag, attrs): + attrs = dict(attrs) + for key in ("id", "name"): + if attrs.get(key) and (key == "id" or tag == "a"): + self.ids.add(attrs[key]) + for key in ("href", "src"): + value = attrs.get(key) + if value is not None and not (tag == "link" and attrs.get("rel") in ("preconnect", "dns-prefetch")): + self.links.append((value, self.getpos()[0])) + if tag in ("script", "style"): + self._skip += 1 + + def handle_endtag(self, tag): + if tag in ("script", "style") and self._skip: + self._skip -= 1 + + def handle_data(self, data): + if not self._skip: + self.text.append(data) + + +def parse(path): + page = Page() + with open(path, encoding="utf-8", errors="replace") as handle: + page.feed(handle.read()) + return page + + +def check_site(root, forbid, exempt=()): + errors = [] + pages = {} + for dirpath, _dirs, files in os.walk(root): + for name in files: + if name.endswith(".html"): + path = os.path.join(dirpath, name) + pages[os.path.relpath(path, root)] = parse(path) + + for rel, page in sorted(pages.items()): + scripted = rel.startswith(SCRIPTED_ANCHORS) + for href, line in page.links: + where = f"{rel}:{line}" + if re.search(r"\.rst(?:[?#]|$)", href.split("?")[0]): + errors.append(f"{where}: link to a generated .rst file: {href}") + parts = urllib.parse.urlsplit(href) + if parts.scheme or href.startswith("//") or href.startswith(("mailto:", "data:", "javascript:")): + continue + target_rel = rel if not parts.path else os.path.normpath( + os.path.join(os.path.dirname(rel), urllib.parse.unquote(parts.path)) + ) + if target_rel.startswith(".."): + errors.append(f"{where}: link leaves the site: {href}") + continue + target = os.path.join(root, target_rel) + if os.path.isdir(target): + target_rel = os.path.join(target_rel, "index.html") + target = os.path.join(root, target_rel) + if not os.path.isfile(target): + errors.append(f"{where}: no such file: {href}") + continue + fragment = urllib.parse.unquote(parts.fragment) + if not fragment or scripted or target_rel.startswith(SCRIPTED_ANCHORS): + continue + target_page = pages.get(os.path.normpath(target_rel)) + if target_page is not None and fragment not in target_page.ids: + errors.append(f"{where}: no anchor #{fragment} in {target_rel}") + if not scripted and rel not in exempt: + text = " ".join(page.text) + for pattern in forbid: + found = pattern.search(text) + if found: + errors.append(f"{rel}: forbidden text {found.group(0)!r} (pattern {pattern.pattern})") + for href, line in page.links: + if pattern.search(href): + errors.append(f"{rel}:{line}: forbidden link {href} (pattern {pattern.pattern})") + return errors, len(pages) + + +def check_sources(roots, forbid): + errors = [] + for top in roots: + for dirpath, _dirs, files in os.walk(top): + for name in sorted(files): + if not name.endswith((".org", ".md", ".rst", ".py", ".el")): + continue + path = os.path.join(dirpath, name) + with open(path, encoding="utf-8", errors="replace") as handle: + for number, line in enumerate(handle, 1): + for pattern in forbid: + found = pattern.search(line) + if found: + errors.append(f"{path}:{number}: forbidden text {found.group(0)!r}") + return errors + + +def main(argv): + parser = argparse.ArgumentParser(description=__doc__.split("\n", 1)[0]) + parser.add_argument("site", help="the built HTML directory") + parser.add_argument("--sources", action="append", default=[], help="a source tree to scan for forbidden text") + parser.add_argument("--forbid", action="append", default=[], help="another forbidden regular expression") + parser.add_argument("--no-default-forbid", action="store_true", help="drop the default forbidden patterns") + parser.add_argument("--exempt", action="append", default=[], metavar="PAGE", + help="a built page, relative to the site, whose text is not checked for forbidden names") + args = parser.parse_args(argv) + if not os.path.isfile(os.path.join(args.site, "index.html")): + print(f"check_site: no index.html in {args.site}", file=sys.stderr) + return 2 + patterns = ([] if args.no_default_forbid else DEFAULT_FORBID) + args.forbid + forbid = [re.compile(p, re.I) for p in patterns] + errors, count = check_site(args.site, forbid, set(args.exempt)) + errors += check_sources(args.sources, forbid) + for error in errors: + print(error) + print(f"check_site: {count} pages, {len(errors)} problem(s)", file=sys.stderr) + return 1 if errors else 0 + + +if __name__ == "__main__": + sys.exit(main(sys.argv[1:])) diff --git a/docs/tools/zig_api.zig b/docs/tools/zig_api.zig new file mode 100644 index 0000000..0ff5715 --- /dev/null +++ b/docs/tools/zig_api.zig @@ -0,0 +1,615 @@ +//! Write the API reference of a Zig module as MyST pages for Sphinx. +//! +//! zig run docs/tools/zig_api.zig -- --module NAME --root FILE --out DIR +//! [--source-url URL] [--title TEXT] [--follow-private-imports] +//! +//! The parser is std.zig.Ast, the one the compiler uses. From the root file +//! it follows every `@import("x.zig")` bound to a `pub` declaration (and to +//! any declaration with --follow-private-imports, which an executable needs: +//! its files are rarely imported as `pub`). Each file becomes one page, +//! `.md`, holding its `//!` comment and one `zig:` directive +//! per `pub` declaration, with its `///` comment as the body. Fields of a +//! container and the `pub` declarations inside it are nested under it. A +//! file imported along several paths takes the shortest of `pub` imports, +//! or of any imports when there is none. `index.md` lists the pages. An import of another package, such as +//! `@import("zig_common")`, is not followed; intersphinx links to that +//! package's own site. +//! +//! `{ref}` in the source URL becomes $DOCS_SOURCE_REF, else $GITHUB_SHA, +//! else `main`, so a page built in CI links to the commit it was built from. +//! DIR is emptied first: it holds only generated pages. +const std = @import("std"); +const Ast = std.zig.Ast; +const Allocator = std.mem.Allocator; +const Io = std.Io; +const Writer = std.Io.Writer; + +const usage = + \\usage: zig_api --module NAME --root FILE --out DIR [--source-url URL] + \\ [--title TEXT] [--follow-private-imports] + \\ +; + +const Options = struct { + module: []const u8 = "", + root: []const u8 = "", + out: []const u8 = "", + source_url: []const u8 = "", + title: []const u8 = "", + follow_private: bool = false, +}; + +const Kind = enum { + module, + type, + errorset, + function, + constant, + variable, + + fn directive(k: Kind) []const u8 { + return switch (k) { + .module => "zig:module", + .type => "zig:type", + .errorset => "zig:errorset", + .function => "zig:function", + .constant => "zig:constant", + .variable => "zig:variable", + }; + } + + fn heading(k: Kind) []const u8 { + return switch (k) { + .module => "Modules", + .type => "Types", + .errorset => "Error sets", + .function => "Functions", + .constant => "Constants", + .variable => "Variables", + }; + } +}; + +/// One file to document: the dotted name it is published under and its path. +const Page = struct { + fqn: []const u8, + path: []const u8, + summary: []const u8 = "", + /// Reached from the root through `pub` imports alone, so the autodoc + /// site, which shows only those, has its declarations. + public: bool = false, +}; + +const Ctx = struct { + gpa: Allocator, + io: Io, + opts: Options, + pages: std.ArrayList(Page) = .empty, + seen: std.StringHashMapUnmanaged(void) = .empty, +}; + +fn fail(comptime fmt: []const u8, args: anytype) noreturn { + std.debug.print("zig_api: " ++ fmt ++ "\n", args); + std.process.exit(2); +} + +pub fn main(init: std.process.Init) !void { + const arena = init.arena.allocator(); + const args = try init.minimal.args.toSlice(arena); + var opts: Options = .{}; + var i: usize = 1; + while (i < args.len) : (i += 1) { + const a = args[i]; + if (std.mem.eql(u8, a, "--follow-private-imports")) { + opts.follow_private = true; + continue; + } + if (std.mem.eql(u8, a, "-h") or std.mem.eql(u8, a, "--help")) { + std.debug.print("{s}", .{usage}); + return; + } + if (i + 1 >= args.len) fail("{s} needs a value\n{s}", .{ a, usage }); + const v = args[i + 1]; + i += 1; + if (std.mem.eql(u8, a, "--module")) { + opts.module = v; + } else if (std.mem.eql(u8, a, "--root")) { + opts.root = v; + } else if (std.mem.eql(u8, a, "--out")) { + opts.out = v; + } else if (std.mem.eql(u8, a, "--source-url")) { + opts.source_url = v; + } else if (std.mem.eql(u8, a, "--title")) { + opts.title = v; + } else { + fail("unknown option {s}\n{s}", .{ a, usage }); + } + } + if (opts.module.len == 0 or opts.root.len == 0 or opts.out.len == 0) fail("{s}", .{usage}); + const ref = init.environ_map.get("DOCS_SOURCE_REF") orelse init.environ_map.get("GITHUB_SHA") orelse "main"; + opts.source_url = try std.mem.replaceOwned(u8, arena, opts.source_url, "{ref}", ref); + + var ctx: Ctx = .{ .gpa = arena, .io = init.io, .opts = opts }; + try Io.Dir.cwd().deleteTree(init.io, opts.out); + try Io.Dir.cwd().createDirPath(init.io, opts.out); + try collect(&ctx); + for (ctx.pages.items) |*page| try writePage(&ctx, page); + try writeIndex(&ctx); +} + +fn readSource(ctx: *Ctx, path: []const u8) ![:0]const u8 { + return Io.Dir.cwd().readFileAllocOptions(ctx.io, path, ctx.gpa, .limited(64 << 20), .of(u8), 0) catch |err| + fail("cannot read {s}: {s}", .{ path, @errorName(err) }); +} + +fn parse(ctx: *Ctx, path: []const u8) !Ast { + const source = try readSource(ctx, path); + const tree = try Ast.parse(ctx.gpa, source, .{}); + if (tree.errors.len != 0) { + const e = tree.errors[0]; + const loc = tree.tokenLocation(0, e.token); + fail("{s}:{d}:{d}: does not parse ({s})", .{ path, loc.line + 1, loc.column + 1, @tagName(e.tag) }); + } + return tree; +} + +/// Find the files to document, breadth first, so each gets its shortest +/// name: through `pub` imports when it has one, which is the name the +/// autodoc knows, else through any import. +fn collect(ctx: *Ctx) !void { + try addPage(ctx, ctx.opts.module, ctx.opts.root, true); + try walk(ctx, true); + if (ctx.opts.follow_private) try walk(ctx, false); +} + +/// Add the files imported by the pages found so far, and by the pages +/// added meanwhile: by `pub` declarations of public pages, or by any +/// declaration of any page. +fn walk(ctx: *Ctx, public: bool) !void { + var i: usize = 0; + while (i < ctx.pages.items.len) : (i += 1) { + const page = ctx.pages.items[i]; + if (public and !page.public) continue; + var tree = try parse(ctx, page.path); + for (tree.rootDecls()) |decl| { + const vd = tree.fullVarDecl(decl) orelse continue; + if (public and vd.visib_token == null) continue; + const target = importPath(&tree, vd) orelse continue; + const name = tree.tokenSlice(vd.ast.mut_token + 1); + const fqn = try std.fmt.allocPrint(ctx.gpa, "{s}.{s}", .{ page.fqn, name }); + try addPage(ctx, fqn, try importedFile(ctx, page.path, target), public); + } + } +} + +fn addPage(ctx: *Ctx, fqn: []const u8, path: []const u8, public: bool) !void { + const gop = try ctx.seen.getOrPut(ctx.gpa, path); + if (gop.found_existing) return; + var tree = try parse(ctx, path); + try ctx.pages.append(ctx.gpa, .{ + .fqn = fqn, + .path = path, + .summary = try firstSentence(ctx.gpa, try containerDoc(ctx.gpa, &tree)), + .public = public, + }); +} + +/// The path of the file that `@import(target)` in the file `from` names. +fn importedFile(ctx: *Ctx, from: []const u8, target: []const u8) ![]const u8 { + return std.fs.path.join(ctx.gpa, &.{ std.fs.path.dirname(from) orelse ".", target }); +} + +/// The dotted name of the page for the file `@import(target)` in the file +/// `from` names; another path to that file may have given it its name. +fn pageOf(ctx: *Ctx, from: []const u8, target: []const u8) ![]const u8 { + const path = try importedFile(ctx, from, target); + for (ctx.pages.items) |page| { + if (std.mem.eql(u8, page.path, path)) return page.fqn; + } + fail("{s} imports {s}, which has no page", .{ from, path }); +} + +/// The file a declaration `@import`s, when it names a `.zig` file. +fn importPath(tree: *const Ast, vd: Ast.full.VarDecl) ?[]const u8 { + const init_node = vd.ast.init_node.unwrap() orelse return null; + switch (tree.nodeTag(init_node)) { + .builtin_call_two, .builtin_call_two_comma, .builtin_call, .builtin_call_comma => {}, + else => return null, + } + if (!std.mem.eql(u8, tree.tokenSlice(tree.nodeMainToken(init_node)), "@import")) return null; + var buf: [2]Ast.Node.Index = undefined; + const params = tree.builtinCallParams(&buf, init_node) orelse return null; + if (params.len != 1 or tree.nodeTag(params[0]) != .string_literal) return null; + const lit = tree.tokenSlice(tree.nodeMainToken(params[0])); + if (lit.len < 2) return null; + const name = lit[1 .. lit.len - 1]; + if (!std.mem.endsWith(u8, name, ".zig")) return null; + return name; +} + +/// The `//!` lines at the top of a file, without the marker. +fn containerDoc(gpa: Allocator, tree: *const Ast) ![]const u8 { + var out: Writer.Allocating = .init(gpa); + var tok: Ast.TokenIndex = 0; + while (tok < tree.tokens.len and tree.tokenTag(tok) == .container_doc_comment) : (tok += 1) { + try out.writer.print("{s}\n", .{stripMarker(tree.tokenSlice(tok))}); + } + return out.written(); +} + +/// The `///` lines directly above the token, without the marker. +fn docComment(gpa: Allocator, tree: *const Ast, first: Ast.TokenIndex) ![]const u8 { + var start = first; + while (start > 0 and tree.tokenTag(start - 1) == .doc_comment) start -= 1; + var out: Writer.Allocating = .init(gpa); + var tok = start; + while (tok < first) : (tok += 1) { + try out.writer.print("{s}\n", .{stripMarker(tree.tokenSlice(tok))}); + } + return out.written(); +} + +/// The name an identifier token spells: `@"rename-fallback"` is +/// rename-fallback. Anchors and cross-references use this form; the +/// signature keeps the source's. +fn identName(token: []const u8) []const u8 { + if (token.len >= 3 and std.mem.startsWith(u8, token, "@\"") and token[token.len - 1] == '"') + return token[2 .. token.len - 1]; + return token; +} + +fn stripMarker(line: []const u8) []const u8 { + var s = line[3..]; + if (s.len > 0 and s[0] == ' ') s = s[1..]; + return std.mem.trimEnd(u8, s, " \t\r"); +} + +fn firstSentence(gpa: Allocator, doc: []const u8) ![]const u8 { + const para_end = std.mem.indexOf(u8, doc, "\n\n") orelse doc.len; + const para = try collapse(gpa, doc[0..para_end]); + var i: usize = 0; + while (i + 1 < para.len) : (i += 1) { + if (para[i] == '.' and para[i + 1] == ' ') return para[0 .. i + 1]; + } + return para; +} + +/// Source text with every run of whitespace, newlines included, made one space. +fn collapse(gpa: Allocator, text: []const u8) ![]const u8 { + var out: std.ArrayList(u8) = .empty; + var space = false; + for (text) |c| { + if (std.ascii.isWhitespace(c)) { + space = out.items.len > 0; + continue; + } + if (space) try out.append(gpa, ' '); + space = false; + // zig fmt leaves a comma before a closing bracket on a wrapped list. + if ((c == ')' or c == '}' or c == ']') and out.items.len > 1 and + out.items[out.items.len - 1] == ' ' and out.items[out.items.len - 2] == ',') + { + out.items.len -= 2; + } + try out.append(gpa, c); + } + return out.items; +} + +fn tokenText(tree: *const Ast, first: Ast.TokenIndex, last: Ast.TokenIndex) []const u8 { + const start = tree.tokenStart(first); + const end = tree.tokenStart(last) + tree.tokenSlice(last).len; + return tree.source[start..end]; +} + +fn lineOf(tree: *const Ast, tok: Ast.TokenIndex) usize { + return tree.tokenLocation(0, tok).line + 1; +} + +const Member = struct { + kind: Kind, + name: []const u8, + signature: []const u8, + doc: []const u8, + line: usize, + /// For a container: its node, to document fields and nested declarations. + container: ?Ast.Node.Index = null, + /// For an error set: its node, to list the error names. + errors: ?Ast.Node.Index = null, + /// For an imported file: the `@import` operand, such as "proc.zig". + import: []const u8 = "", +}; + +fn isContainer(tree: *const Ast, node: Ast.Node.Index) bool { + return switch (tree.nodeTag(node)) { + .container_decl, + .container_decl_trailing, + .container_decl_arg, + .container_decl_arg_trailing, + .container_decl_two, + .container_decl_two_trailing, + .tagged_union, + .tagged_union_trailing, + .tagged_union_enum_tag, + .tagged_union_enum_tag_trailing, + .tagged_union_two, + .tagged_union_two_trailing, + => true, + else => false, + }; +} + +fn isTypeName(name: []const u8) bool { + return name.len > 0 and std.ascii.isUpper(name[0]) or std.mem.endsWith(u8, name, "_t"); +} + +/// The declarations of one container worth a directive: `pub` ones, plus +/// every field. Returns them in source order. +fn members(ctx: *Ctx, tree: *const Ast, decls: []const Ast.Node.Index, fields: *std.ArrayList(Member)) !std.ArrayList(Member) { + var list: std.ArrayList(Member) = .empty; + const gpa = ctx.gpa; + for (decls) |decl| { + switch (tree.nodeTag(decl)) { + .container_field_init, .container_field_align, .container_field => { + var cf = tree.fullContainerField(decl).?; + cf.convertToNonTupleLike(tree); + if (cf.ast.tuple_like) continue; + const first = cf.firstToken(); + try fields.append(gpa, .{ + .kind = .constant, + .name = identName(tree.tokenSlice(cf.ast.main_token)), + .signature = try collapse(gpa, tokenText(tree, first, tree.lastToken(decl))), + .doc = try docComment(gpa, tree, first), + .line = lineOf(tree, first), + }); + }, + .fn_decl, .fn_proto, .fn_proto_multi, .fn_proto_one, .fn_proto_simple => { + var buf: [1]Ast.Node.Index = undefined; + const fp = tree.fullFnProto(&buf, decl).?; + if (fp.visib_token == null) continue; + const name_tok = fp.name_token orelse continue; + const proto = if (tree.nodeTag(decl) == .fn_decl) tree.nodeData(decl).node_and_node[0] else decl; + try list.append(gpa, .{ + .kind = .function, + .name = identName(tree.tokenSlice(name_tok)), + .signature = try collapse(gpa, tokenText(tree, fp.firstToken(), tree.lastToken(proto))), + .doc = try docComment(gpa, tree, fp.firstToken()), + .line = lineOf(tree, fp.firstToken()), + }); + }, + .global_var_decl, .local_var_decl, .simple_var_decl, .aligned_var_decl => { + const vd = tree.fullVarDecl(decl).?; + if (vd.visib_token == null) continue; + const name = identName(tree.tokenSlice(vd.ast.mut_token + 1)); + const first = vd.firstToken(); + var m: Member = .{ + .kind = if (tree.tokenTag(vd.ast.mut_token) == .keyword_var) .variable else .constant, + .name = name, + .signature = "", + .doc = try docComment(gpa, tree, first), + .line = lineOf(tree, first), + }; + const init_node = vd.ast.init_node.unwrap(); + const head_end: Ast.TokenIndex = if (init_node) |n| tree.firstToken(n) - 1 else tree.lastToken(decl); + const head = try collapse(gpa, tokenText(tree, first, head_end)); + if (init_node) |n| { + if (importPath(tree, vd)) |target| { + m.kind = .module; + m.import = target; + m.signature = try collapse(gpa, tokenText(tree, first, tree.lastToken(n))); + } else if (m.kind == .constant and isContainer(tree, n)) { + var cbuf: [2]Ast.Node.Index = undefined; + const cd = tree.fullContainerDecl(&cbuf, n).?; + const lbrace = brace: { + var t = cd.ast.main_token; + while (tree.tokenTag(t) != .l_brace) t += 1; + break :brace t; + }; + m.kind = .type; + m.container = n; + m.signature = try std.fmt.allocPrint(gpa, "{s} {s}", .{ head, try collapse(gpa, tokenText(tree, tree.firstToken(n), lbrace - 1)) }); + } else if (m.kind == .constant and (tree.nodeTag(n) == .error_set_decl or tree.nodeTag(n) == .merge_error_sets)) { + m.kind = .errorset; + m.errors = n; + m.signature = try std.fmt.allocPrint(gpa, "{s} {s}", .{ head, if (tree.nodeTag(n) == .error_set_decl) "error{...}" else try collapse(gpa, tree.getNodeSource(n)) }); + } else { + const value = try collapse(gpa, tree.getNodeSource(n)); + if (m.kind == .constant and isTypeName(name)) m.kind = .type; + m.signature = if (value.len <= 72 and std.mem.indexOfScalar(u8, value, '{') == null) + try std.fmt.allocPrint(gpa, "{s} {s}", .{ head, value }) + else + try std.fmt.allocPrint(gpa, "{s} ...", .{head}); + } + } else { + m.signature = head; + } + try list.append(gpa, m); + }, + else => {}, + } + } + return list; +} + +fn writePage(ctx: *Ctx, page: *Page) !void { + const gpa = ctx.gpa; + var tree = try parse(ctx, page.path); + var out: Writer.Allocating = .init(gpa); + const w = &out.writer; + + try w.print("# {s}\n\n", .{page.fqn}); + try w.print("::::{{zig:module}} {s}\n:file: {s}\n", .{ page.fqn, page.path }); + if (ctx.opts.source_url.len > 0) try w.print(":source: {s}{s}\n", .{ ctx.opts.source_url, page.path }); + if (!page.public) try w.writeAll(":no-autodoc:\n"); + try w.writeAll("\n"); + try writeDoc(w, try containerDoc(gpa, &tree)); + try w.writeAll("::::\n\n"); + + var fields: std.ArrayList(Member) = .empty; + const list = try members(ctx, &tree, tree.rootDecls(), &fields); + inline for (.{ Kind.module, Kind.type, Kind.errorset, Kind.function, Kind.constant, Kind.variable }) |kind| { + var any = false; + for (list.items) |m| { + if (m.kind != kind) continue; + if (!any) try w.print("## {s}\n\n", .{kind.heading()}); + any = true; + if (kind == .module) { + // The imported file's own page declares the module. + const target = try pageOf(ctx, page.path, m.import); + try w.print("- {{zig:mod}}`{s}`: ", .{target}); + try writeProse(w, summaryOf(ctx, target)); + try w.writeAll("\n"); + } else { + try writeMember(ctx, w, &tree, page, page.fqn, m); + } + } + if (kind == .module and any) try w.writeAll("\n"); + } + + const name = try std.fmt.allocPrint(gpa, "{s}.md", .{page.fqn}); + var dir = try Io.Dir.cwd().openDir(ctx.io, ctx.opts.out, .{}); + defer dir.close(ctx.io); + try dir.writeFile(ctx.io, .{ .sub_path = name, .data = out.written() }); +} + +fn summaryOf(ctx: *Ctx, fqn: []const u8) []const u8 { + for (ctx.pages.items) |page| { + if (std.mem.eql(u8, page.fqn, fqn)) return page.summary; + } + return ""; +} + +/// Colons for a directive that holds `depth` levels of nested directives. +fn fence(gpa: Allocator, depth: usize) ![]const u8 { + const f = try gpa.alloc(u8, 3 + depth); + @memset(f, ':'); + return f; +} + +fn nesting(ctx: *Ctx, tree: *const Ast, m: Member) !usize { + const n = m.container orelse return if (m.errors != null) 1 else 0; + var cbuf: [2]Ast.Node.Index = undefined; + const cd = tree.fullContainerDecl(&cbuf, n).?; + var fields: std.ArrayList(Member) = .empty; + const inner = try members(ctx, tree, cd.ast.members, &fields); + var deepest: usize = if (fields.items.len > 0) 1 else 0; + for (inner.items) |child| deepest = @max(deepest, 1 + try nesting(ctx, tree, child)); + return deepest; +} + +fn writeMember(ctx: *Ctx, w: *Writer, tree: *const Ast, page: *const Page, parent: []const u8, m: Member) !void { + const gpa = ctx.gpa; + const fqn = try std.fmt.allocPrint(gpa, "{s}.{s}", .{ parent, m.name }); + const colons = try fence(gpa, try nesting(ctx, tree, m)); + try w.print("{s}{{{s}}} {s}\n", .{ colons, m.kind.directive(), fqn }); + try w.print(":signature: {s}\n", .{m.signature}); + if (ctx.opts.source_url.len > 0) try w.print(":source: {s}{s}#L{d}\n", .{ ctx.opts.source_url, page.path, m.line }); + if (!page.public) try w.writeAll(":no-autodoc:\n"); + try w.writeAll("\n"); + try writeDoc(w, m.doc); + + if (m.errors) |n| try writeErrors(ctx, w, tree, n, fqn); + if (m.container) |n| { + var cbuf: [2]Ast.Node.Index = undefined; + const cd = tree.fullContainerDecl(&cbuf, n).?; + var fields: std.ArrayList(Member) = .empty; + const inner = try members(ctx, tree, cd.ast.members, &fields); + for (fields.items) |f| { + try w.print(":::{{zig:field}} {s}.{s}\n:signature: {s}\n", .{ fqn, f.name, f.signature }); + if (ctx.opts.source_url.len > 0) try w.print(":source: {s}{s}#L{d}\n", .{ ctx.opts.source_url, page.path, f.line }); + try w.writeAll("\n"); + try writeDoc(w, f.doc); + try w.writeAll(":::\n\n"); + } + for (inner.items) |child| try writeMember(ctx, w, tree, page, fqn, child); + } + try w.print("{s}\n\n", .{colons}); +} + +/// Each name of an `error{...}` set, with its `///` comment. +fn writeErrors(ctx: *Ctx, w: *Writer, tree: *const Ast, node: Ast.Node.Index, fqn: []const u8) !void { + if (tree.nodeTag(node) != .error_set_decl) return; + const lbrace, const rbrace = tree.nodeData(node).token_and_token; + var tok = lbrace + 1; + while (tok < rbrace) : (tok += 1) { + if (tree.tokenTag(tok) != .identifier) continue; + try w.print(":::{{zig:error}} {s}.{s}\n:signature: error.{s}\n\n", .{ fqn, identName(tree.tokenSlice(tok)), tree.tokenSlice(tok) }); + try writeDoc(w, try docComment(ctx.gpa, tree, tok)); + try w.writeAll(":::\n\n"); + } +} + +/// A doc comment as MyST: Markdown already, except that a heading cannot sit +/// inside a directive, so it becomes a bold line. +fn writeDoc(w: *Writer, doc: []const u8) !void { + if (std.mem.trim(u8, doc, " \n").len == 0) return; + var lines = std.mem.splitScalar(u8, std.mem.trimEnd(u8, doc, "\n"), '\n'); + var in_code = false; + while (lines.next()) |line| { + if (std.mem.startsWith(u8, std.mem.trimStart(u8, line, " "), "```")) { + in_code = !in_code; + try w.print("{s}\n", .{line}); + continue; + } + if (in_code) { + try w.print("{s}\n", .{line}); + } else if (std.mem.startsWith(u8, line, "#")) { + const text = std.mem.trim(u8, std.mem.trimStart(u8, line, "#"), " "); + try w.writeAll("**"); + try writeProse(w, text); + try w.writeAll("**\n"); + } else { + try writeProse(w, line); + try w.writeAll("\n"); + } + } + try w.writeAll("\n"); +} + +/// One line of doc comment prose, with the syntax MyST adds to Markdown, and +/// Zig's autodoc does not have, escaped outside code spans: a footnote +/// reference `[^x]` (a regular expression's negated class) and a `%` comment +/// line. +fn writeProse(w: *Writer, line: []const u8) !void { + return writeEscaped(w, line, false); +} + +/// writeProse for a table cell, where a pipe ends the cell, inside a code +/// span too. +fn writeCell(w: *Writer, text: []const u8) !void { + return writeEscaped(w, text, true); +} + +fn writeEscaped(w: *Writer, line: []const u8, cell: bool) !void { + const indent = line.len - std.mem.trimStart(u8, line, " ").len; + var in_span = false; + for (line, 0..) |c, i| { + if (c == '`') in_span = !in_span; + const footnote = !in_span and c == '[' and i + 1 < line.len and line[i + 1] == '^'; + const comment = i == indent and c == '%'; + if (footnote or comment or (cell and c == '|')) try w.writeByte('\\'); + try w.writeByte(c); + } +} + +fn writeIndex(ctx: *Ctx) !void { + var out: Writer.Allocating = .init(ctx.gpa); + const w = &out.writer; + const title = if (ctx.opts.title.len > 0) ctx.opts.title else "Zig API"; + try w.print("# {s}\n\n", .{title}); + try w.print("Generated from the doc comments of `{s}` by `docs/tools/zig_api.zig`.\n", .{ctx.opts.module}); + try w.writeAll("Each page is one source file; the `pub` declarations are grouped by kind in source order.\n"); + try w.writeAll("Every declaration links to its source line and, where the {zig:autodoc}`Zig autodoc ` build has it, to the same declaration there.\n"); + try w.writeAll("\n| Module | Summary |\n|---|---|\n"); + for (ctx.pages.items) |page| { + try w.print("| {{zig:mod}}`{s}` | ", .{page.fqn}); + try writeCell(w, page.summary); + try w.writeAll(" |\n"); + } + try w.writeAll("\n```{toctree}\n:hidden:\n:maxdepth: 1\n\n"); + for (ctx.pages.items) |page| try w.print("{s}\n", .{page.fqn}); + try w.writeAll("```\n"); + var dir = try Io.Dir.cwd().openDir(ctx.io, ctx.opts.out, .{}); + defer dir.close(ctx.io); + try dir.writeFile(ctx.io, .{ .sub_path = "index.md", .data = out.written() }); +} diff --git a/lychee.toml b/lychee.toml new file mode 100644 index 0000000..7661eb8 --- /dev/null +++ b/lychee.toml @@ -0,0 +1,31 @@ +# External links in the built site (pixi run -e docs linkcheck). Internal +# links and anchors are checked offline by docs/tools/check_site.py. +max_retries = 3 +retry_wait_time = 2 +timeout = 20 +max_concurrency = 16 +accept = ["200..=299", "429"] +include_fragments = "none" +cache = true +max_cache_age = "1d" +no_progress = true + +exclude_path = [ + # The Zig autodoc site links only within itself. + "docs/build/html/api/", +] + +exclude = [ + # This site: every page names its published URL as canonical, and a new + # page is not published until this build deploys. check_site.py checks the + # site's own links. + '^https://stackhands\.github\.io/eb\-keep\-logs/', + # Source links name the commit being built, which a pull request build + # may not have pushed anywhere yet; check_site.py checks the pages. + '^https://github\.com/stackhands/[^/]+/(blob|edit|tree)/', + # A Cloudflare challenge answers automated clients with 403. + '^https://eb-stack\.rgoswami\.me/', + # The repository's own, each with its reason; apply.py keeps this block. + # local:begin + # local:end +] diff --git a/pixi.lock b/pixi.lock new file mode 100644 index 0000000..7081eae --- /dev/null +++ b/pixi.lock @@ -0,0 +1,3859 @@ +version: 7 +platforms: +- name: linux-64 + virtual-packages: + - __unix=0 + - __linux=4.18 + - __glibc=2.28 + - __archspec=0=x86_64 +- name: osx-arm64 + virtual-packages: + - __unix=0 + - __osx=13.0 + - __archspec=0=m1 +environments: + default: + channels: + - url: https://conda.anaconda.org/conda-forge/ + packages: {} + docs: + channels: + - url: https://conda.anaconda.org/conda-forge/ + packages: + linux-64: + - conda: https://conda.anaconda.org/conda-forge/linux-64/_openmp_mutex-4.5-20_gnu.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/astroid-4.3.4-py313hd5f5364_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/at-spi2-atk-2.38.0-h0630a04_3.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/linux-64/at-spi2-core-2.40.3-h0630a04_0.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/linux-64/atk-1.0-2.38.0-hc5c8e38_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/binutils-2.46.1-default_h4852527_103.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/binutils_impl_linux-64-2.46.1-default_hfdba357_103.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/bzip2-1.0.8-hda65f42_10.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/c-ares-1.34.9-hebe6cf0_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/cairo-1.18.6-h3c89d7e_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/charset-normalizer-3.5.2-h1114479_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/curl-8.23.0-ha042cf0_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/dbus-1.16.2-he8c428d_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/emacs-30.2-hda76a9e_6.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/epoxy-1.5.10-hb03c661_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/fontconfig-2.18.3-h4db4eae_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/freetype-2.14.3-ha770c72_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/fribidi-1.0.18-h7cc23a3_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/gdk-pixbuf-2.44.8-h68053f1_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/giflib-6.1.3-hebe6cf0_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/glib-tools-2.90.1-h876c321_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/gmp-6.3.0-hfd2156b_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/gnutls-3.8.13-h18acefa_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/graphite2-1.3.15-h54a6638_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/gtk3-3.24.52-ha5ea40c_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/harfbuzz-15.0.0-ha770c72_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/hicolor-icon-theme-0.17-hfc2019e_4.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/icu-78.3-py310h44b86e0_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/keyutils-1.6.3-h7cc23a3_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/krb5-1.22.2-hbc21106_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/ld_impl_linux-64-2.46.1-default_hbd61a6d_103.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/lerc-4.3.0-he78707d_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libclang-cpp22.1-22.1.8-default_h0acdd01_11.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libcups-2.3.3-h7a8fb5f_6.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libcurl-8.23.0-ha042cf0_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libdeflate-1.26-h351257e_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libdrm-2.4.129-h7cc23a3_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libedit-3.1.20260512-pl5321h373387f_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libegl-1.7.0-ha4b6fd6_5.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libegl-devel-1.7.0-ha4b6fd6_5.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libev-4.33-h280c20c_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libexpat-2.9.0-hd2095e1_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libffi-3.7.0-h81df57d_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libfreetype-2.14.3-ha770c72_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libfreetype6-2.14.3-h5e6c136_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libgcc-16.2.0-ha9f2e26_7.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libgcc-ng-16.2.0-h69a702a_7.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libgl-1.7.0-ha4b6fd6_5.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libgl-devel-1.7.0-ha4b6fd6_5.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libglib-2.90.1-hb382ddc_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libglvnd-1.7.0-ha4b6fd6_5.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libglx-1.7.0-ha4b6fd6_5.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libglx-devel-1.7.0-ha4b6fd6_5.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libgomp-16.2.0-he0feb66_7.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libharfbuzz-15.0.0-h23af247_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libharfbuzz-devel-15.0.0-h23af247_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libiconv-1.18-h0cb94f2_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libidn2-2.3.8-hfac485b_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libjpeg-turbo-3.2.1-h7cc23a3_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libllvm22-22.1.8-h474f4eb_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/liblzma-5.8.3-hb03c661_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libmpdec-4.0.0-hb03c661_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libnghttp2-1.71.0-hc5e5977_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libpango-1.58.2-hce4e988_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libpango-devel-1.58.2-h317d9d0_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libpciaccess-0.19-hb03c661_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libpng-1.6.59-h922cc85_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libpsl-0.23.1-hd9e3e90_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libpython-3.13.18-hd51c5da_100_cp313.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/librsvg-2.62.4-ha427ee3_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libsqlite-3.54.1-h13e7031_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libssh2-1.11.1-h6154650_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libstdcxx-16.2.0-h934c35e_7.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libtasn1-4.21.0-h7cc23a3_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libtiff-4.7.2-h6d37cbf_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libtree-sitter-0.25.9-h280c20c_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libunistring-0.9.10-h7f98852_0.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/linux-64/libuuid-2.42.4-hcfc3c73_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libwebp-base-1.6.0-hd42ef1d_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libxcb-1.17.0-hb83e432_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libxkbcommon-1.13.2-h59c2f34_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libxml2-16-2.15.4-hf3af7cc_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libxml2-2.15.4-h7df9aa5_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/libzlib-1.3.2-h25fd6f3_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/lychee-0.24.2-h39d0f39_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/markupsafe-3.0.4-py313h2af15c8_5.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/mpc-1.4.1-ha2cb11d_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/mpfr-4.2.2-ha2cb11d_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/ncurses-6.6-hdb14827_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/nettle-3.10.1-h5ef0d04_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/openssl-3.6.5-h781a0a9_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/p11-kit-0.26.5-h8d769aa_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/pango-1.58.2-h2f58602_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/pcre2-10.49-h8b3dc9c_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/pixman-0.46.4-h54a6638_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/pthread-stubs-0.4-h7cc23a3_1004.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/python-3.13.18-hf47f18c_100_cp313.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/pyyaml-6.0.3-py313h45b8176_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/readline-8.3-hd6e31c0_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/tk-8.6.13-noxft_h1df4ec4_4.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/wayland-1.26.0-hc1c935e_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xkeyboard-config-2.48-hebe6cf0_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libice-1.1.2-h280c20c_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libsm-1.2.6-h0d788c3_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libx11-1.8.14-hb83e432_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxau-1.0.12-h7cc23a3_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxcomposite-0.4.7-hb03c661_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxcursor-1.2.3-h7cc23a3_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxdamage-1.1.6-hb9d3cd8_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxdmcp-1.1.5-h7cc23a3_2.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxext-1.3.7-h7cc23a3_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxfixes-6.0.2-h7cc23a3_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxi-1.8.4-h7cc23a3_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxinerama-1.1.6-hd2095e1_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxrandr-1.5.5-h7cc23a3_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxrender-0.9.13-h7cc23a3_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxtst-1.2.6-h7cc23a3_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxxf86vm-1.1.7-h7cc23a3_1.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-xorgproto-2025.1-hebe6cf0_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/yaml-0.2.5-hebe6cf0_3.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/zig-0.17.1-89c0722_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/zig_impl_linux-64-0.17.1-0addc32_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/zig_linux-64-0.17.1-fa519dd_0.conda + - conda: https://conda.anaconda.org/conda-forge/linux-64/zstd-1.5.7-hb78ec9c_7.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/_python_abi3_support-1.0-hd8ed1ab_3.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/adwaita-icon-theme-51.0-unix_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/alabaster-1.0.0-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/babel-2.18.0-pyhcf101f3_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/ca-certificates-2026.10.23-hbd8a1cb_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/certifi-2026.10.23-pyhd8ed1ab_3.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/colorama-0.4.6-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/cpython-3.13.18-py313hd8ed1ab_100.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/docutils-0.22.4-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-dejavu-sans-mono-2.37-hab24e00_0.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-inconsolata-3.000-h77eed37_0.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-source-code-pro-2.038-h77eed37_0.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-ubuntu-0.83-h77eed37_4.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/fonts-conda-ecosystem-1-0.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/noarch/fonts-conda-forge-1-hc364b38_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/idna-3.20-pyh5ded981_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/imagesize-2.0.1-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/jinja2-3.1.6-pyhcf101f3_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/kernel-headers_linux-64-4.18.0-he073ed8_9.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/libgcc-devel_linux-64-15.3.0-h2b852eb_107.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/libstdcxx-devel_linux-64-15.3.0-hb2c5482_107.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/markdown-it-py-4.3.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/mdit-py-plugins-0.7.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/mdurl-0.1.2-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/myst-parser-5.2.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/packaging-26.3-pyhc364b38_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/pygments-2.21.0-pyhcf101f3_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/pygments-styles-0.3.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/python-gil-3.13.18-h4df99d1_100.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/python_abi-3.13-9_cp313.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/requests-2.34.2-pyhcf101f3_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/roman-numerals-4.1.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/shibuya-2026.7.12-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/snowballstemmer-3.1.1-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-9.2.0-pyhc364b38_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-autoapi-3.9.0-pyh5ded981_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-copybutton-0.5.2-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-design-0.8.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-last-updated-by-git-0.3.8-pyhe01879c_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-sitemap-2.9.0-pyhcf101f3_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-applehelp-2.0.0-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-devhelp-2.0.0-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-htmlhelp-2.1.0-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-jsmath-2.0.0-pyh5ded981_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-qthelp-2.0.0-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-serializinghtml-2.0.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sysroot_linux-64-2.28-h4ee821c_9.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/tzdata-2026e-h5d301ff_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/urllib3-2.8.0-pyh5ded981_1.conda + osx-arm64: + - conda: https://conda.anaconda.org/conda-forge/noarch/alabaster-1.0.0-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/babel-2.18.0-pyhcf101f3_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/ca-certificates-2026.10.23-hbd8a1cb_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/certifi-2026.10.23-pyhd8ed1ab_3.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/charset-normalizer-3.5.1-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/colorama-0.4.6-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/docutils-0.22.4-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-dejavu-sans-mono-2.37-hab24e00_0.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-inconsolata-3.000-h77eed37_0.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-source-code-pro-2.038-h77eed37_0.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-ubuntu-0.83-h77eed37_4.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/fonts-conda-ecosystem-1-0.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/noarch/fonts-conda-forge-1-hc364b38_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/idna-3.20-pyh5ded981_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/imagesize-2.0.1-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/jinja2-3.1.6-pyhcf101f3_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/markdown-it-py-4.3.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/mdit-py-plugins-0.7.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/mdurl-0.1.2-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/myst-parser-5.2.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/packaging-26.3-pyhc364b38_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/pygments-2.21.0-pyhcf101f3_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/pygments-styles-0.3.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/python_abi-3.13-9_cp313.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/requests-2.34.2-pyhcf101f3_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/roman-numerals-4.1.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/shibuya-2026.7.12-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/snowballstemmer-3.1.1-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-9.2.0-pyhc364b38_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-autoapi-3.9.0-pyh5ded981_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-copybutton-0.5.2-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-design-0.8.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-last-updated-by-git-0.3.8-pyhe01879c_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-sitemap-2.9.0-pyhcf101f3_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-applehelp-2.0.0-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-devhelp-2.0.0-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-htmlhelp-2.1.0-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-jsmath-2.0.0-pyh5ded981_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-qthelp-2.0.0-pyhd8ed1ab_1.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-serializinghtml-2.0.0-pyhd8ed1ab_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/tzdata-2026e-h5d301ff_0.conda + - conda: https://conda.anaconda.org/conda-forge/noarch/urllib3-2.8.0-pyh5ded981_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/astroid-4.3.4-py313h6ee819a_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/bzip2-1.0.8-h4e30115_10.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/c-ares-1.34.9-h74c22ad_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/cairo-1.18.6-h580cee5_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/curl-8.23.0-h6651222_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/dbus-1.16.2-hf049998_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/emacs-30.2-ha2f6bed_6.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/fontconfig-2.18.3-h81aa574_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/freetype-2.14.3-hce30654_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/fribidi-1.0.18-hb001647_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/gdk-pixbuf-2.44.8-h5867e2c_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/giflib-6.1.3-h74c22ad_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/gmp-6.3.0-hf5e55b1_3.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/gnutls-3.8.13-hfe86254_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/graphite2-1.3.15-h784d473_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/icu-78.3-py310h579977c_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/krb5-1.22.2-h34f8a20_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/lerc-4.3.0-h0699d0c_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libasprintf-0.25.1-hae62183_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libclang-cpp22.1-22.1.8-default_h79071a4_11.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libcurl-8.23.0-h6651222_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libcxx-22.1.8-h55c6f16_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libdeflate-1.26-h72bfca4_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libedit-3.1.20260512-pl5321h26f1114_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libev-4.33-h1a92334_3.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libexpat-2.9.0-h6111c0a_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libffi-3.7.0-h47dc5ef_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libfreetype-2.14.3-hce30654_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libfreetype6-2.14.3-h2ed5691_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libgettextpo-0.25.1-hae62183_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libglib-2.90.0-hccd281b_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libharfbuzz-15.0.0-hcda0f7c_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libharfbuzz-devel-15.0.0-hcda0f7c_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libiconv-1.18-he4c29f2_3.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libidn2-2.3.8-ha90df94_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libintl-0.25.1-hae62183_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libjpeg-turbo-3.2.1-hb001647_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libllvm22-22.1.8-h759d1ac_3.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/liblzma-5.8.3-h8088a28_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libmpdec-4.0.0-h84a0fba_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libnghttp2-1.71.0-h29223de_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libpango-1.58.2-hc2ac4f2_3.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libpango-devel-1.58.2-haa2d88b_3.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libpng-1.6.59-hf5e6511_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libpsl-0.23.1-hdb0c161_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libpython-3.13.18-h0af5753_100_cp313.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/librsvg-2.62.4-hc8ac265_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libsqlite-3.54.1-hca69786_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libssh2-1.11.1-hbf2880b_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libtasn1-4.21.0-hb001647_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libtiff-4.7.2-h87d37ca_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libtree-sitter-0.25.9-he530434_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libunistring-0.9.10-h3422bc3_0.tar.bz2 + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libwebp-base-1.6.0-h202fb40_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libxml2-16-2.15.4-heb56d2d_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libxml2-2.15.4-h550178d_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/libzlib-1.3.2-h8088a28_3.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/lychee-0.24.2-h9d00c72_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/markupsafe-3.0.4-py313h0984dbd_5.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/ncurses-6.6-he64c551_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/nettle-3.10.1-hfc803ee_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/openssl-3.6.5-h55eecbc_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/p11-kit-0.26.5-h329a732_2.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/pango-1.58.2-hc6efcc1_3.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/pcre2-10.47-he63d830_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/pixman-0.46.4-h784d473_3.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/python-3.13.18-hb59dee6_100_cp313.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/pyyaml-6.0.3-py313h5c85ca1_3.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/readline-8.3-h8b90a29_1.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/tk-8.6.13-hbeba79b_4.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/yaml-0.2.5-h74c22ad_3.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/zig-0.17.1-0ccaba2_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/zig_impl_osx-arm64-0.17.1-8405819_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/zig_osx-arm64-0.17.1-a676bd3_0.conda + - conda: https://conda.anaconda.org/conda-forge/osx-arm64/zstd-1.5.7-hf451053_7.conda +packages: +- conda: https://conda.anaconda.org/conda-forge/linux-64/_openmp_mutex-4.5-20_gnu.conda + build_number: 20 + sha256: 1dd3fffd892081df9726d7eb7e0dea6198962ba775bd88842135a4ddb4deb3c9 + md5: a9f577daf3de00bca7c3c76c0ecbd1de + depends: + - __glibc >=2.17,<3.0.a0 + - libgomp >=7.5.0 + constrains: + - openmp_impl <0.0a0 + license: BSD-3-Clause + license_family: BSD + run_exports: + strong: + - _openmp_mutex >=4.5 + size: 28948 + timestamp: 1770939786096 +- conda: https://conda.anaconda.org/conda-forge/linux-64/astroid-4.3.4-py313hd5f5364_0.conda + sha256: 771ff3b8e696eddcae366aec29fa141de8f86c775829bdc4a7b2178e9ef63a0f + md5: 07762eaac3a9abec3df4a843ea7b1137 + depends: + - python + - python_abi 3.13.* *_cp313 + license: LGPL-2.1-only + run_exports: {} + size: 577483 + timestamp: 1791464581441 +- conda: https://conda.anaconda.org/conda-forge/linux-64/at-spi2-atk-2.38.0-h0630a04_3.tar.bz2 + sha256: 26ab9386e80bf196e51ebe005da77d57decf6d989b4f34d96130560bc133479c + md5: 6b889f174df1e0f816276ae69281af4d + depends: + - at-spi2-core >=2.40.0,<2.41.0a0 + - atk-1.0 >=2.36.0 + - dbus >=1.13.6,<2.0a0 + - libgcc-ng >=9.3.0 + - libglib >=2.68.1,<3.0a0 + license: LGPL-2.1-or-later + license_family: LGPL + run_exports: + weak: + - at-spi2-atk >=2.38.0,<3.0a0 + size: 339899 + timestamp: 1619122953439 +- conda: https://conda.anaconda.org/conda-forge/linux-64/at-spi2-core-2.40.3-h0630a04_0.tar.bz2 + sha256: c4f9b66bd94c40d8f1ce1fad2d8b46534bdefda0c86e3337b28f6c25779f258d + md5: 8cb2fc4cd6cc63f1369cfa318f581cc3 + depends: + - dbus >=1.13.6,<2.0a0 + - libgcc-ng >=9.3.0 + - libglib >=2.68.3,<3.0a0 + - xorg-libx11 + - xorg-libxi + - xorg-libxtst + license: LGPL-2.1-or-later + license_family: LGPL + run_exports: + weak: + - at-spi2-core >=2.40.3,<2.41.0a0 + size: 658390 + timestamp: 1625848454791 +- conda: https://conda.anaconda.org/conda-forge/linux-64/atk-1.0-2.38.0-hc5c8e38_3.conda + sha256: 0a46bb5d2b830bafbc087e03e6dcfbe2bb0ed5367f7eb0f2ac30d814c90eb273 + md5: 0025e3fcf41f95f2d101a5314c203cd7 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - libglib >=2.90.1,<3.0a0 + - libzlib >=1.3.2,<2.0a0 + constrains: + - atk-1.0 2.38.0 + license: LGPL-2.0-or-later + license_family: LGPL + run_exports: + weak: + - atk-1.0 >=2.38.0 + size: 184172 + timestamp: 1794581195451 +- conda: https://conda.anaconda.org/conda-forge/linux-64/binutils-2.46.1-default_h4852527_103.conda + sha256: 1198587b78b20fa00ee397d4ea1bdb5098b08100c08ad7b3e6d10912cd487466 + md5: 3624cc8224aec1c58079dad844d354a2 + depends: + - binutils_impl_linux-64 >=2.46.1,<2.46.2.0a0 + license: GPL-3.0-only + license_family: GPL + run_exports: {} + size: 35373 + timestamp: 1791565504227 +- conda: https://conda.anaconda.org/conda-forge/linux-64/binutils_impl_linux-64-2.46.1-default_hfdba357_103.conda + sha256: 98f9ddc6dc5d56a824b7eaea5bab6ad4bb47642288fc70d6b1b4024ac39d5595 + md5: e86f9dc615d7533c5be8b15b3a1dee8d + depends: + - ld_impl_linux-64 2.46.1 default_hbd61a6d_103 + - sysroot_linux-64 + - zstd >=1.5.7,<1.6.0a0 + license: GPL-3.0-only + license_family: GPL + run_exports: {} + size: 3706604 + timestamp: 1791565481839 +- conda: https://conda.anaconda.org/conda-forge/linux-64/bzip2-1.0.8-hda65f42_10.conda + sha256: 1a0d382c515ebf55f8ee1f38c8b81bc95af5c2acc42ad53b66bc5df932032f96 + md5: e675fabcf81499adc7edf58124fb1e01 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + license: bzip2-1.0.6 + license_family: BSD + run_exports: + weak: + - bzip2 >=1.0.8,<2.0a0 + size: 257808 + timestamp: 1785906269155 +- conda: https://conda.anaconda.org/conda-forge/linux-64/c-ares-1.34.9-hebe6cf0_0.conda + sha256: bd95dd25b80b5c4faf5349542377bf89b2794e23d0f7aa7f1c431e4f3b633f3c + md5: 78b505af04bf7a87ca957ef0cb5946f5 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: MIT + license_family: MIT + run_exports: + weak: + - c-ares >=1.34.9,<2.0a0 + size: 233759 + timestamp: 1792507024648 +- conda: https://conda.anaconda.org/conda-forge/linux-64/cairo-1.18.6-h3c89d7e_0.conda + sha256: 5d0efc6f9981468aca72897460d9b2d17b74dff72787f20a9d2330e214064515 + md5: 7920701f9abcb488411495742cf365a7 + depends: + - __glibc >=2.17,<3.0.a0 + - fontconfig >=2.18.3,<3.0a0 + - fonts-conda-ecosystem + - icu >=78.3,<79.0a0 + - libexpat >=2.8.1,<3.0a0 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - libgcc >=15 + - libglib >=2.90.0,<3.0a0 + - libpng >=1.6.58,<1.7.0a0 + - libstdcxx >=15 + - libxcb >=1.17.0,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + - pixman >=0.46.4,<1.0a0 + - xorg-libice >=1.1.2,<2.0a0 + - xorg-libsm >=1.2.6,<2.0a0 + - xorg-libx11 >=1.8.13,<2.0a0 + - xorg-libxext >=1.3.7,<2.0a0 + - xorg-libxrender >=0.9.12,<0.10.0a0 + license: LGPL-2.1-only or MPL-1.1 + run_exports: + weak: + - cairo >=1.18.6,<2.0a0 + size: 1007110 + timestamp: 1790045358757 +- conda: https://conda.anaconda.org/conda-forge/linux-64/charset-normalizer-3.5.2-h1114479_0.conda + noarch: python + sha256: e4f04b45d68716fcc47c808aeacbf165f6f295fb91bd20b91aa38942b8d2cdc6 + md5: 78d5c6112c9320a1a797935cecfec7c2 + depends: + - python + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + - _python_abi3_support 1.* + - cpython >=3.9 + license: MIT + license_family: MIT + run_exports: {} + size: 217200 + timestamp: 1790766086110 +- conda: https://conda.anaconda.org/conda-forge/linux-64/curl-8.23.0-ha042cf0_0.conda + sha256: c34fd476d8ad5eede00a3742f33bf52400e01b35bc2777ab2306d6fc21121949 + md5: ae85b19bbac7336f4efc4802c351effa + depends: + - __glibc >=2.17,<3.0.a0 + - krb5 >=1.22.2,<1.23.0a0 + - libcurl 8.23.0 ha042cf0_0 + - libgcc >=15 + - libpsl >=0.23.1,<0.24.0a0 + - libssh2 >=1.11.1,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + - openssl >=3.5.9,<4.0a0 + - zstd >=1.5.7,<1.6.0a0 + license: curl + license_family: MIT + run_exports: {} + size: 197652 + timestamp: 1791990906207 +- conda: https://conda.anaconda.org/conda-forge/linux-64/dbus-1.16.2-he8c428d_2.conda + sha256: 87a0a42d4ccc527597eff3234509dfb03e0d9bf67d5e2b6fc758e2ef389d8abe + md5: a6eb37b51be1a9a654dc3a8aca039b1a + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - libstdcxx >=15 + - libexpat >=2.8.1,<3.0a0 + - libzlib >=1.3.2,<2.0a0 + - libglib >=2.88.3,<3.0a0 + license: AFL-2.1 OR GPL-2.0-or-later + run_exports: + weak: + - dbus >=1.16.2,<2.0a0 + size: 449564 + timestamp: 1788197922783 +- conda: https://conda.anaconda.org/conda-forge/linux-64/emacs-30.2-hda76a9e_6.conda + sha256: 41085b883c2395030f0612c888897926bb11309a969c7fff4fde14ed0237de79 + md5: c89a80eb5ab4bcf59096bbc5c87c4e39 + depends: + - binutils + - __glibc >=2.17,<3.0.a0 + - libstdcxx >=15 + - libgcc >=15 + - xorg-libxext >=1.3.7,<2.0a0 + - libpng >=1.6.58,<1.7.0a0 + - giflib >=6.1.3,<6.2.0a0 + - zstd >=1.5.7,<1.6.0a0 + - libsqlite >=3.53.4,<4.0a0 + - gmp >=6.3.0,<7.0a0 + - libglib >=2.88.3,<3.0a0 + - fontconfig >=2.18.3,<3.0a0 + - fonts-conda-ecosystem + - xorg-libx11 >=1.8.13,<2.0a0 + - libwebp-base >=1.6.0,<2.0a0 + - xorg-libsm >=1.2.6,<2.0a0 + - libtree-sitter >=0.25.9,<0.26.0a0 + - cairo >=1.18.4,<2.0a0 + - xorg-libxrandr >=1.5.5,<2.0a0 + - xorg-libice >=1.1.2,<2.0a0 + - xorg-libxfixes >=6.0.2,<7.0a0 + - xorg-libxcomposite >=0.4.7,<1.0a0 + - libxml2 + - libxml2-16 >=2.14.6 + - gtk3 >=3.24.52,<4.0a0 + - adwaita-icon-theme + - libjpeg-turbo >=3.2.0,<4.0a0 + - libharfbuzz >=14.3.0 + - libiconv >=1.18,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - ncurses >=6.6,<7.0a0 + - librsvg >=2.62.3,<3.0a0 + - xorg-libxi >=1.8.3,<2.0a0 + - xorg-libxrender >=0.9.12,<0.10.0a0 + - mpfr >=4.2.2,<5.0a0 + - libxcb >=1.17.0,<2.0a0 + - gdk-pixbuf >=2.44.8,<3.0a0 + - libtiff >=4.7.2,<4.8.0a0 + - gnutls >=3.8.11,<3.9.0a0 + - pango >=1.58.2,<2.0a0 + - xorg-libxinerama >=1.1.6,<1.2.0a0 + - dbus >=1.16.2,<2.0a0 + - libexpat >=2.8.1,<3.0a0 + - mpc >=1.4.0,<2.0a0 + license: GPL-3.0-only + license_family: GPL + run_exports: {} + size: 73507511 + timestamp: 1786884762437 +- conda: https://conda.anaconda.org/conda-forge/linux-64/epoxy-1.5.10-hb03c661_2.conda + sha256: a5b51e491fec22bcc1765f5b2c8fff8a97428e9a5a7ee6730095fb9d091b0747 + md5: 057083b06ccf1c2778344b6dabace38b + depends: + - __glibc >=2.17,<3.0.a0 + - libdrm >=2.4.125,<2.5.0a0 + - libegl >=1.7.0,<2.0a0 + - libegl-devel + - libgcc >=14 + - libgl >=1.7.0,<2.0a0 + - libgl-devel + - libglx >=1.7.0,<2.0a0 + - libglx-devel + - xorg-libx11 >=1.8.12,<2.0a0 + - xorg-libxdamage >=1.1.6,<2.0a0 + - xorg-libxext >=1.3.6,<2.0a0 + - xorg-libxfixes >=6.0.1,<7.0a0 + - xorg-libxxf86vm >=1.1.6,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - epoxy >=1.5.10,<1.6.0a0 + size: 411735 + timestamp: 1758743520805 +- conda: https://conda.anaconda.org/conda-forge/linux-64/fontconfig-2.18.3-h4db4eae_2.conda + sha256: 49d5b86a00d441d23e6351a6371429fea311538e2aa8b855e61c4d3dbe3e8762 + md5: 2385ef6446d1a75b26a681449a6e32a7 + depends: + - __glibc >=2.17,<3.0.a0 + - libexpat >=2.9.0,<3.0a0 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - libgcc >=15 + - libuuid >=2.42.4,<3.0a0 + - libzlib >=1.3.2,<2.0a0 + license: MIT + run_exports: + weak: + - fontconfig >=2.18.3,<3.0a0 + - fonts-conda-ecosystem + size: 296751 + timestamp: 1794699581275 +- conda: https://conda.anaconda.org/conda-forge/linux-64/freetype-2.14.3-ha770c72_2.conda + sha256: 612a8e0c1a6ecae23da54d81ef395f6ebb5c8e4468ec2611593ebce75876a4e0 + md5: 2d0ea23b23603e07ca47f23f949f67b6 + depends: + - libfreetype 2.14.3 ha770c72_2 + - libfreetype6 2.14.3 h5e6c136_2 + license: GPL-2.0-only OR FTL + run_exports: + weak: + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + size: 175239 + timestamp: 1786641011029 +- conda: https://conda.anaconda.org/conda-forge/linux-64/fribidi-1.0.18-h7cc23a3_0.conda + sha256: 6cabdf62dad4973ef0fe8b0d80c4b5b5d76ac9249da91f26f663cb44acdcc6a1 + md5: a14a9f11f543b9a5c03ae6a5c2245b0a + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: LGPL-2.1-or-later + run_exports: + weak: + - fribidi >=1.0.18,<2.0a0 + size: 64767 + timestamp: 1793323486599 +- conda: https://conda.anaconda.org/conda-forge/linux-64/gdk-pixbuf-2.44.8-h68053f1_2.conda + sha256: 32f3ebd1871cb6ac7eac36c78c410860f38e8d252d5857a80f6abfcb79c7e0ff + md5: d7bd6ccfc58eb6796bd6bba85878fc0e + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - libglib >=2.88.3,<3.0a0 + - libjpeg-turbo >=3.2.0,<4.0a0 + - liblzma >=5.8.3,<6.0a0 + - libpng >=1.6.58,<1.7.0a0 + - libtiff >=4.7.2,<4.8.0a0 + license: LGPL-2.1-or-later + license_family: LGPL + run_exports: + weak: + - gdk-pixbuf >=2.44.8,<3.0a0 + size: 581961 + timestamp: 1788490424411 +- conda: https://conda.anaconda.org/conda-forge/linux-64/giflib-6.1.3-hebe6cf0_2.conda + sha256: 917c3a622c3870f822d25a882f1856e757d91e31a3dd52a499849a392ca865d2 + md5: 07bdd65afe03df3fb5dbcaa8257c64a3 + depends: + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + license: MIT + license_family: MIT + run_exports: + weak: + - giflib >=6.1.3,<6.2.0a0 + size: 86117 + timestamp: 1788948683783 +- conda: https://conda.anaconda.org/conda-forge/linux-64/glib-tools-2.90.1-h876c321_3.conda + sha256: 6f7be2f6545fe3f2e2c62428021623e489daa98ca0d9dbcd9d3fc5297de3bc8b + md5: f68c210114fbae3b35e07a9f1a230972 + depends: + - libglib ==2.90.1 hb382ddc_3 + - libffi + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + license: LGPL-2.1-or-later + run_exports: {} + size: 238585 + timestamp: 1794580555960 +- conda: https://conda.anaconda.org/conda-forge/linux-64/gmp-6.3.0-hfd2156b_3.conda + sha256: f36c336efc874f346a53a9011f67e997f9faac505562cc18c13b6d399cfe61c7 + md5: 576e32739f323438bf69ab006c21be7b + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + - libstdcxx >=14 + license: GPL-2.0-or-later OR LGPL-3.0-or-later + run_exports: + weak: + - gmp >=6.3.0,<7.0a0 + size: 493498 + timestamp: 1786629164954 +- conda: https://conda.anaconda.org/conda-forge/linux-64/gnutls-3.8.13-h18acefa_0.conda + sha256: dbdbb714064914281c755650bc54e1855412e7e2f4c99ad171b5123ed704b2b1 + md5: 7c3de21891993e89aabdadaa603ed835 + depends: + - __glibc >=2.17,<3.0.a0 + - gmp >=6.3.0,<7.0a0 + - libgcc >=14 + - libidn2 >=2,<3.0a0 + - libstdcxx >=14 + - libtasn1 >=4.21.0,<5.0a0 + - nettle >=3.10.1,<3.11.0a0 + - p11-kit >=0.26.2,<0.27.0a0 + license: LGPL-2.1-or-later + license_family: LGPL + run_exports: + weak: + - gnutls >=3.8.13,<3.9.0a0 + size: 2054535 + timestamp: 1778044634746 +- conda: https://conda.anaconda.org/conda-forge/linux-64/graphite2-1.3.15-h54a6638_1.conda + sha256: 7fa3b6a9c081fa3e545573152a788d061a0a0ba57df7251cc0f4f75225fc93e7 + md5: f9fe2984587fa8235a6af6004760cd18 + depends: + - __glibc >=2.17,<3.0.a0 + - libstdcxx >=14 + - libgcc >=14 + license: LGPL-2.0-or-later + license_family: LGPL + run_exports: + weak: + - graphite2 >=1.3.15,<2.0a0 + size: 102835 + timestamp: 1786118485753 +- conda: https://conda.anaconda.org/conda-forge/linux-64/gtk3-3.24.52-ha5ea40c_0.conda + sha256: c6bb4f06331bcb0a566d84e0f0fad7af4b9035a03b13e2d5ecfaf13be57e6e10 + md5: bcaea22d85999a4f17918acfab877e61 + depends: + - __glibc >=2.17,<3.0.a0 + - at-spi2-atk >=2.38.0,<3.0a0 + - atk-1.0 >=2.38.0 + - cairo >=1.18.4,<2.0a0 + - epoxy >=1.5.10,<1.6.0a0 + - fontconfig >=2.17.1,<3.0a0 + - fonts-conda-ecosystem + - fribidi >=1.0.16,<2.0a0 + - gdk-pixbuf >=2.44.5,<3.0a0 + - glib-tools + - harfbuzz >=13.2.1 + - hicolor-icon-theme + - libcups >=2.3.3,<2.4.0a0 + - libcups >=2.3.3,<3.0a0 + - libexpat >=2.7.4,<3.0a0 + - libfreetype >=2.14.2 + - libfreetype6 >=2.14.2 + - libgcc >=14 + - libglib >=2.86.4,<3.0a0 + - liblzma >=5.8.2,<6.0a0 + - libxkbcommon >=1.13.1,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + - pango >=1.56.4,<2.0a0 + - wayland >=1.25.0,<2.0a0 + - xorg-libx11 >=1.8.13,<2.0a0 + - xorg-libxcomposite >=0.4.7,<1.0a0 + - xorg-libxcursor >=1.2.3,<2.0a0 + - xorg-libxdamage >=1.1.6,<2.0a0 + - xorg-libxext >=1.3.7,<2.0a0 + - xorg-libxfixes >=6.0.2,<7.0a0 + - xorg-libxi >=1.8.2,<2.0a0 + - xorg-libxinerama >=1.1.6,<1.2.0a0 + - xorg-libxrandr >=1.5.5,<2.0a0 + - xorg-libxrender >=0.9.12,<0.10.0a0 + license: LGPL-2.0-or-later + license_family: LGPL + run_exports: + weak: + - gtk3 >=3.24.52,<4.0a0 + - adwaita-icon-theme + size: 5939083 + timestamp: 1774288645605 +- conda: https://conda.anaconda.org/conda-forge/linux-64/harfbuzz-15.0.0-ha770c72_0.conda + sha256: 66e49a0888ad60b69766c8a82a4c5b8be0000b1b0d595710ffaba079fd717e5e + md5: 3bb1373c9a1ca102437ca168e5282cc0 + depends: + - libharfbuzz-devel 15.0.0 h23af247_0 + license: MIT + license_family: MIT + run_exports: + weak: + - libharfbuzz >=15.0.0 + size: 11075 + timestamp: 1792769341313 +- conda: https://conda.anaconda.org/conda-forge/linux-64/hicolor-icon-theme-0.17-hfc2019e_4.conda + sha256: 3eadfa497feb83b48e115383468d756b0637bdd3db7c93d8880c3a68e5f63c68 + md5: bd55e24a51101bcdc51e2c7c8850b333 + license: GPL-2.0-or-later + license_family: GPL + run_exports: {} + size: 15246 + timestamp: 1794120683401 +- conda: https://conda.anaconda.org/conda-forge/linux-64/icu-78.3-py310h44b86e0_2.conda + sha256: 9f07834f0c546ab14d885ce0366285f61f44e326c0edd1fc63b8294e113ae432 + md5: 72a381cbad04f24b1c2a43ef707f45b4 + depends: + - __glibc >=2.17,<3.0.a0 + - libstdcxx >=14 + - libgcc >=14 + license: MIT + license_family: MIT + run_exports: + weak: + - icu >=78.3,<79.0a0 + size: 14459115 + timestamp: 1786545741408 +- conda: https://conda.anaconda.org/conda-forge/linux-64/keyutils-1.6.3-h7cc23a3_1.conda + sha256: dd053c96dcb0dcfd59422aefea9d2fe937a190167f34fba7893ec1e10a7e8963 + md5: ba55d1b89fd7775e67de8291029b4059 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: LGPL-2.1-or-later + run_exports: + weak: + - keyutils >=1.6.3,<2.0a0 + size: 135295 + timestamp: 1786739238128 +- conda: https://conda.anaconda.org/conda-forge/linux-64/krb5-1.22.2-hbc21106_2.conda + sha256: 2a5c38c85e63df84c4e69ee71439841ce570d259ae3060627bb9a49a938d66f4 + md5: 53318d715316929a574f83591308b1f8 + depends: + - __glibc >=2.17,<3.0.a0 + - keyutils >=1.6.3,<2.0a0 + - libedit >=3.1.20250104,<3.2.0a0 + - libedit >=3.1.20250104,<4.0a0 + - libgcc >=15 + - libstdcxx >=15 + - openssl >=3.5.7,<4.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - krb5 >=1.22.2,<1.23.0a0 + size: 1394333 + timestamp: 1786762112514 +- conda: https://conda.anaconda.org/conda-forge/linux-64/ld_impl_linux-64-2.46.1-default_hbd61a6d_103.conda + sha256: 901649b1edbe841fd4ee7e2d491a05184ed540eb01cdae506872f344babc1d28 + md5: 2362c70e7e79827c32db35547d9c179b + depends: + - __glibc >=2.17,<3.0.a0 + - zstd >=1.5.7,<1.6.0a0 + constrains: + - binutils_impl_linux-64 2.46.1 + license: GPL-3.0-only + license_family: GPL + run_exports: {} + size: 742109 + timestamp: 1791565468810 +- conda: https://conda.anaconda.org/conda-forge/linux-64/lerc-4.3.0-he78707d_0.conda + sha256: 467aa52e9ba7a438f17944909e1904399eab863778ab501cf271e30cfa4bc6f3 + md5: 78908f9592dbe2cebd57082bf8c57000 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - libstdcxx >=15 + license: Apache-2.0 + license_family: Apache + run_exports: + weak: + - lerc >=4.3.0,<5.0a0 + size: 269911 + timestamp: 1793411350746 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libclang-cpp22.1-22.1.8-default_h0acdd01_11.conda + sha256: e7a3df524a2900677c460e8cd1407db8aabadc3d19e6a713a58a4f29b1d4bef7 + md5: eccc111e6808c3aa5dd458a448c597e6 + depends: + - __glibc >=2.17,<3.0.a0 + - libstdcxx >=15 + - libgcc >=15 + - libxml2 + - libxml2-16 >=2.15.4 + - zstd >=1.5.7,<1.6.0a0 + - libzlib >=1.3.2,<2.0a0 + - libllvm22 >=22.1.8,<22.2.0a0 + license: Apache-2.0 WITH LLVM-exception + license_family: APACHE + run_exports: + weak: + - libclang-cpp22.1 >=22.1.8,<22.2.0a0 + size: 24529645 + timestamp: 1791934037580 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libcups-2.3.3-h7a8fb5f_6.conda + sha256: 205c4f19550f3647832ec44e35e6d93c8c206782bdd620c1d7cf66237580ff9c + md5: 49c553b47ff679a6a1e9fc80b9c5a2d4 + depends: + - __glibc >=2.17,<3.0.a0 + - krb5 >=1.22.2,<1.23.0a0 + - libgcc >=14 + - libstdcxx >=14 + - libzlib >=1.3.1,<2.0a0 + license: Apache-2.0 + license_family: Apache + run_exports: + weak: + - libcups >=2.3.3,<2.4.0a0 + size: 4518030 + timestamp: 1770902209173 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libcurl-8.23.0-ha042cf0_0.conda + sha256: d2db14d80efb4f2e76e76561c633f1767f7543987f2bcb54a067a9d264d432ab + md5: 0ad16151226df493aed967f0efce0e80 + depends: + - __glibc >=2.17,<3.0.a0 + - krb5 >=1.22.2,<1.23.0a0 + - libgcc >=15 + - libnghttp2 >=1.68.1,<2.0a0 + - libpsl >=0.23.1,<0.24.0a0 + - libssh2 >=1.11.1,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + - openssl >=3.5.9,<4.0a0 + - zstd >=1.5.7,<1.6.0a0 + license: curl + license_family: MIT + run_exports: + weak: + - libcurl >=8.23.0,<9.0a0 + size: 505683 + timestamp: 1791990900844 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libdeflate-1.26-h351257e_0.conda + sha256: f437f68abb1fa1dededd082a0c2800bec40495e01cf9ec46f4e693e34d60b644 + md5: d0c17fc12939a990f0865b7a14b49cfe + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: MIT + license_family: MIT + run_exports: + weak: + - libdeflate >=1.26,<1.27.0a0 + size: 74338 + timestamp: 1787442593524 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libdrm-2.4.129-h7cc23a3_0.conda + sha256: ea46b0ca0fa16af1f8b329b740e6cd8b4577c5378fa8717b28a885f70668633d + md5: 64cc91512b6278c315349dc13c53f680 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - libpciaccess >=0.19,<0.20.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - libdrm >=2.4.129,<2.5.0a0 + size: 313461 + timestamp: 1786684701973 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libedit-3.1.20260512-pl5321h373387f_0.conda + sha256: 45301f14f4eb66da57cfaf2d265f3eeee73f8b07e99614ee3afc5b26eea91126 + md5: 27dbd7e2984b8fe48e069379636ccfdd + depends: + - ncurses + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + - ncurses >=6.6,<7.0a0 + license: BSD-2-Clause + license_family: BSD + run_exports: + weak: + - libedit >=3.1.20260512,<3.2.0a0 + size: 135877 + timestamp: 1791327370514 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libegl-1.7.0-ha4b6fd6_5.conda + sha256: 13d3fde9c1dcf254968cc70652222a43f25d04e69555ccf855553110e753288e + md5: 3a1b41c4591a0a1734382af3e2b8bc08 + depends: + - __glibc >=2.17,<3.0.a0 + - libglvnd 1.7.0 ha4b6fd6_5 + license: LicenseRef-libglvnd + run_exports: {} + size: 46694 + timestamp: 1787310030923 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libegl-devel-1.7.0-ha4b6fd6_5.conda + sha256: fd2794bbcff7e692fb476c17886702702893d074071d429217bad7cfb072abfd + md5: 577800fc8c9d8b7d9727246bbfde704e + depends: + - __glibc >=2.17,<3.0.a0 + - libegl 1.7.0 ha4b6fd6_5 + - libgl-devel 1.7.0 ha4b6fd6_5 + - xorg-libx11 + license: LicenseRef-libglvnd + run_exports: + weak: + - libegl >=1.7.0,<2.0a0 + size: 31242 + timestamp: 1787310065866 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libev-4.33-h280c20c_3.conda + sha256: e4418f68d01a6307c4431b585c71b584f40189877364e542ee87deb777f5e85b + md5: 7bc31538d6e3fb349e897353969237ec + depends: + - libgcc >=14 + - __glibc >=2.17,<3.0.a0 + license: BSD-2-Clause OR GPL-2.0-or-later + license_family: GPL + run_exports: + weak: + - libev >=4.33,<4.34.0a0 + size: 43220 + timestamp: 1785917328200 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libexpat-2.9.0-hd2095e1_0.conda + sha256: 7b930a8b6bc6553cb754b4977a11f9c862c719a652fc2d128d89270992ce8beb + md5: 317ecabe4a58b3068c7958dc5eb89e43 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + constrains: + - expat 2.9.0.* + license: MIT + license_family: MIT + run_exports: {} + size: 78894 + timestamp: 1793054221966 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libffi-3.7.0-h81df57d_1.conda + sha256: c8c7583ef063bc3c430f1d48298e5ad24f796a35c22ed5b14183325825a61106 + md5: 6525a0b06aa4fd390795f0740636a9dd + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: MIT + license_family: MIT + run_exports: + weak: + - libffi >=3.7.0,<3.8.0a0 + size: 68004 + timestamp: 1787753412298 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libfreetype-2.14.3-ha770c72_2.conda + sha256: fb12ecb46c30d18d928c0e8fc346ab13b5f6fc8a9cacae4f2f4bb188782586f5 + md5: f8054e759d0ddddaf34a5c8fedc900a1 + depends: + - libfreetype6 >=2.14.3 + license: GPL-2.0-only OR FTL + run_exports: {} + size: 8407 + timestamp: 1786641007099 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libfreetype6-2.14.3-h5e6c136_2.conda + sha256: ec607dd5445dd17ff6bf8b7fe6832e5504c226dd91d3aaea7ba83569808b0ce4 + md5: b72a266a9317036fd0464cb98b027cd0 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - libpng >=1.6.58,<1.7.0a0 + - libzlib >=1.3.2,<2.0a0 + constrains: + - freetype >=2.14.3 + license: GPL-2.0-only OR FTL + run_exports: {} + size: 387671 + timestamp: 1786641006460 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libgcc-16.2.0-ha9f2e26_7.conda + sha256: e031634c3a928f9594eba868bc46ef5230d6571a364a0c63215b06c4563bfcea + md5: 735629b400b70eeab21a2ba8f5b1c2ce + depends: + - __glibc >=2.17,<3.0.a0 + - _openmp_mutex >=4.5 + constrains: + - libgcc-ng ==16.2.0=*_7 + - libgomp 16.2.0 he0feb66_7 + license: GPL-3.0-only WITH GCC-exception-3.1 + license_family: GPL + run_exports: {} + size: 1058444 + timestamp: 1790303109576 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libgcc-ng-16.2.0-h69a702a_7.conda + sha256: 03b54d7008de080a17cc2174b0e4acd6d06e1c981b2eb19846f46d8f59966034 + md5: 2005515ac9340f816fb2ac7e83afe553 + depends: + - libgcc 16.2.0 ha9f2e26_7 + license: GPL-3.0-only WITH GCC-exception-3.1 + license_family: GPL + run_exports: + strong: + - libgcc + size: 28616 + timestamp: 1790303114248 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libgl-1.7.0-ha4b6fd6_5.conda + sha256: 7b2e7e31e8a4f5a01c45ecadcd8aa68c8f733b035240bc7ba9881835ef4bf7b4 + md5: 81141db127a106eb5a91df69a29c9918 + depends: + - __glibc >=2.17,<3.0.a0 + - libglvnd 1.7.0 ha4b6fd6_5 + - libglx 1.7.0 ha4b6fd6_5 + license: LicenseRef-libglvnd + run_exports: {} + size: 131988 + timestamp: 1787310049847 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libgl-devel-1.7.0-ha4b6fd6_5.conda + sha256: 3bebdbeb3ce451287794dddd5cc4d7f4970aac200b2fb797f0d17ac727a71cb7 + md5: f5f7fc038c611a25b22758c0a40d25c9 + depends: + - __glibc >=2.17,<3.0.a0 + - libgl 1.7.0 ha4b6fd6_5 + - libglx-devel 1.7.0 ha4b6fd6_5 + license: LicenseRef-libglvnd + run_exports: + weak: + - libgl >=1.7.0,<2.0a0 + size: 116212 + timestamp: 1787310061570 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libglib-2.90.1-hb382ddc_3.conda + sha256: ff0405851f6e95c2b350eb11c505cb5b13c9aca1fe2b854499286b64c78249d8 + md5: e84cb2c1d7ef14f65b92d854b0545ff5 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - pcre2 >=10.49,<10.50.0a0 + - libffi >=3.7.0,<3.8.0a0 + - libiconv >=1.18,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + constrains: + - glib >2.66 + license: LGPL-2.1-or-later + run_exports: + weak: + - libglib >=2.90.1,<3.0a0 + size: 4856026 + timestamp: 1794580555960 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libglvnd-1.7.0-ha4b6fd6_5.conda + sha256: 6eb77601a44b78c4631d886d54ef54f321c2bdc69fdefc4065a1e0491f030c76 + md5: cfcf11edcfd4acf0094771a9c3b8587f + depends: + - __glibc >=2.17,<3.0.a0 + license: LicenseRef-libglvnd + run_exports: {} + size: 133827 + timestamp: 1787310026653 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libglx-1.7.0-ha4b6fd6_5.conda + sha256: d1f0d51aea6bcc5d915969cbed32e72a8ed6a95931b87357ef8d0866573688c4 + md5: 614e10aae180f87b84f0d1ca8ceb7d9e + depends: + - __glibc >=2.17,<3.0.a0 + - libglvnd 1.7.0 ha4b6fd6_5 + - xorg-libx11 >=1.8.13,<2.0a0 + license: LicenseRef-libglvnd + run_exports: {} + size: 79834 + timestamp: 1787310042550 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libglx-devel-1.7.0-ha4b6fd6_5.conda + sha256: aff3841e3404d78e1887fef988ca4842930c577399d566fa0980808756b1df51 + md5: fb00b4fb800f2d431303a5c1625ef9d0 + depends: + - __glibc >=2.17,<3.0.a0 + - libglx 1.7.0 ha4b6fd6_5 + - xorg-libx11 >=1.8.13,<2.0a0 + - xorg-xorgproto + license: LicenseRef-libglvnd + run_exports: + weak: + - libglx >=1.7.0,<2.0a0 + size: 27698 + timestamp: 1787310053582 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libgomp-16.2.0-he0feb66_7.conda + sha256: 92a0bb350c7be6a4eedcb4e111c60aefd176018e6b1c009a6e025dbe9bbcd758 + md5: d904c7ddd95e026254b4b80808ee9e12 + depends: + - __glibc >=2.17,<3.0.a0 + license: GPL-3.0-only WITH GCC-exception-3.1 + license_family: GPL + run_exports: + strong: + - _openmp_mutex >=4.5 + size: 640566 + timestamp: 1790303046034 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libharfbuzz-15.0.0-h23af247_0.conda + sha256: d3190aedc31b449627ba5bdb8423a62fd234623ab99959c0a5a580e4d6ef6420 + md5: f8beff45d7ea8bea3c6675a7ef568337 + depends: + - __glibc >=2.17,<3.0.a0 + - cairo >=1.18.6,<2.0a0 + - graphite2 >=1.3.15,<2.0a0 + - icu >=78.3,<79.0a0 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - libgcc >=15 + - libglib >=2.90.0,<3.0a0 + - libpng >=1.6.59,<1.7.0a0 + - libstdcxx >=15 + - libzlib >=1.3.2,<2.0a0 + license: MIT + license_family: MIT + run_exports: {} + size: 1628948 + timestamp: 1792769313795 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libharfbuzz-devel-15.0.0-h23af247_0.conda + sha256: 1409a10889a683a95eff4eac5bd2f99631f40c3ef51f7fbd139a90cc3bc36862 + md5: 0ca7e3876bc01ee2c0d3c1e3b0217cc4 + depends: + - __glibc >=2.17,<3.0.a0 + - cairo >=1.18.6,<2.0a0 + - freetype + - graphite2 >=1.3.15,<2.0a0 + - icu >=78.3,<79.0a0 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - libgcc >=15 + - libglib >=2.90.0,<3.0a0 + - libharfbuzz 15.0.0 h23af247_0 + - libpng >=1.6.59,<1.7.0a0 + - libstdcxx >=15 + - libzlib >=1.3.2,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - libharfbuzz >=15.0.0 + size: 2464838 + timestamp: 1792769333155 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libiconv-1.18-h0cb94f2_3.conda + sha256: f943117edb9cd4d9c61cc972eee5a34291dc55ea7a6e9e38da104995841cbcb6 + md5: f92233bf33e24a25668bb2119e2c51f9 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: LGPL-2.1-only + run_exports: + weak: + - libiconv >=1.18,<2.0a0 + size: 789471 + timestamp: 1787033836207 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libidn2-2.3.8-hfac485b_1.conda + sha256: cc38c900b9a20fe75e61cbb594e749c57a06d96510722f5ddfa309682062b065 + md5: 842a81de672ddcf476337c8bde3cad33 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + - libunistring >=0,<1.0a0 + license: LGPL-2.0-only + license_family: LGPL + run_exports: + weak: + - libidn2 >=2,<3.0a0 + size: 139036 + timestamp: 1760385590993 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libjpeg-turbo-3.2.1-h7cc23a3_0.conda + sha256: 2f7d092a3212884825c43814575225fde8a9190611bc0e38c55e0dae45e329ac + md5: 5fd2b2218f7c28c71e95738a4fffaf78 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + constrains: + - jpeg <0.0.0a + license: IJG AND BSD-3-Clause AND Zlib + run_exports: + weak: + - libjpeg-turbo >=3.2.1,<4.0a0 + size: 653905 + timestamp: 1793157024388 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libllvm22-22.1.8-h474f4eb_3.conda + sha256: 135b8b9bfed6a20cdbda657ddb4584d483203eb0e4c29e448a60d4bcc762f391 + md5: c927dba789a253045c0089cb25af44ac + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - libstdcxx >=15 + - libxml2 + - libxml2-16 >=2.15.4 + - libzlib >=1.3.2,<2.0a0 + - zstd >=1.5.7,<1.6.0a0 + license: Apache-2.0 WITH LLVM-exception + license_family: Apache + run_exports: + weak: + - libllvm22 >=22.1.8,<22.2.0a0 + size: 44629067 + timestamp: 1790110003063 +- conda: https://conda.anaconda.org/conda-forge/linux-64/liblzma-5.8.3-hb03c661_1.conda + sha256: 9787df8c22a59c9a70d3e5a10db9ad663485e75e9ccc3f09bd092cb7b95e0dab + md5: 1390b7c5ac0b1d8e447bc5efa6d3c8c2 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + constrains: + - xz 5.8.3.* + license: 0BSD + run_exports: + weak: + - liblzma >=5.8.3,<6.0a0 + size: 112995 + timestamp: 1786348617826 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libmpdec-4.0.0-hb03c661_2.conda + sha256: 46820b4a835e175940ae20bec00fdddaff804cda27a1408ab1b95e77a2196437 + md5: fcfed1dc5053eb1901b66e7b1fc32588 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + license: BSD-2-Clause + license_family: BSD + run_exports: {} + size: 92759 + timestamp: 1786650399772 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libnghttp2-1.71.0-hc5e5977_0.conda + sha256: a4386712ad6d5bc18943b198407c39e2f8ae2fa9c6418bb37bba96f1d382f109 + md5: 726df214814a8b06135a6a674bc54589 + depends: + - libev >=4.33,<5.0a0 + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - libstdcxx >=15 + - libev >=4.33,<4.34.0a0 + - c-ares >=1.34.9,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + - openssl >=3.5.9,<4.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - libnghttp2 >=1.71.0,<2.0a0 + size: 822778 + timestamp: 1793628201366 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libpango-1.58.2-hce4e988_3.conda + sha256: 251dfa10f843dfb14ccc8c33d7ec0f18ac75f51be119100f65468a046b1b33ce + md5: d1ad1c07f3ae04176c0b218d7fe3be9b + depends: + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - fontconfig >=2.18.3,<3.0a0 + - fonts-conda-ecosystem + - cairo >=1.18.6,<2.0a0 + - fribidi >=1.0.17,<2.0a0 + - libglib >=2.90.0,<3.0a0 + - libharfbuzz >=14.6.0 + license: LGPL-2.1-or-later + run_exports: {} + size: 343535 + timestamp: 1792050659391 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libpango-devel-1.58.2-h317d9d0_3.conda + sha256: 75df9cf6e8c8b94648beaa8c7bf0d3c1efd7c3e0ebfb26529e415185a065c2a3 + md5: 8f2e0739636fe033c7324130121ab11c + depends: + - libpango ==1.58.2 hce4e988_3 + - freetype + - libharfbuzz-devel + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - fontconfig >=2.18.3,<3.0a0 + - fonts-conda-ecosystem + - cairo >=1.18.6,<2.0a0 + - fribidi >=1.0.17,<2.0a0 + - libglib >=2.90.0,<3.0a0 + - libharfbuzz >=14.6.0 + license: LGPL-2.1-or-later + run_exports: + weak: + - libpango >=1.58.2,<2.0a0 + size: 211407 + timestamp: 1792050659391 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libpciaccess-0.19-hb03c661_1.conda + sha256: addc80c69d362a9e6c40305c493139a8e9ee504b2f45a6687dbdaa9da3c6183c + md5: 35fa2b34bbced424e6976d30f5fde576 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + license: MIT + license_family: MIT + run_exports: + weak: + - libpciaccess >=0.19,<0.20.0a0 + size: 30070 + timestamp: 1785971678815 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libpng-1.6.59-h922cc85_0.conda + sha256: c7381be8ef713501f6cd2f5ad473e401f2edeaec3c46788296b8dbf0de165e15 + md5: 8c9caf742a485ac688ffa88bbadbf0be + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - libzlib >=1.3.2,<2.0a0 + license: zlib-acknowledgement + run_exports: + weak: + - libpng >=1.6.59,<1.7.0a0 + size: 316872 + timestamp: 1790805159503 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libpsl-0.23.1-hd9e3e90_1.conda + sha256: 09e8effdc89bc5d021349318d32b85594f5b8d8e3ab8f90a85b81f8fe695a566 + md5: 77be60417aa572afcb48cbe0f967401d + depends: + - libstdcxx >=15 + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + - icu >=78.3,<79.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - libpsl >=0.23.1,<0.24.0a0 + size: 72519 + timestamp: 1786970753847 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libpython-3.13.18-hd51c5da_100_cp313.conda + build_number: 100 + sha256: 8fb44e69c90a7cb942a6388fae4c7493dbebbae3c9e11cc34d1c464256dc3af1 + md5: eb85e5c7b22eb523e07fa1140b91b9ef + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: Python-2.0 + run_exports: + weak: + - libpython >=3.13,<4.0a0 + size: 9721079 + timestamp: 1793015613296 +- conda: https://conda.anaconda.org/conda-forge/linux-64/librsvg-2.62.4-ha427ee3_0.conda + sha256: b8036adad17ceddcef416790131492fd236d34c64a0b2754934903087fa84279 + md5: f9bda2728debbde4c641bd1af103c623 + depends: + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + - libglib >=2.90.0,<3.0a0 + - pango >=1.58.2,<2.0a0 + - fontconfig >=2.18.3,<3.0a0 + - fonts-conda-ecosystem + - libxml2-16 >=2.15.4 + - cairo >=1.18.6,<2.0a0 + - libharfbuzz >=14.5.0 + - gdk-pixbuf >=2.44.8,<3.0a0 + constrains: + - __glibc >=2.17 + license: LGPL-2.1-or-later + run_exports: + weak: + - librsvg >=2.62.4,<3.0a0 + size: 4692221 + timestamp: 1790276295756 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libsqlite-3.54.1-h13e7031_0.conda + sha256: 07b3c98282022f05781122d073f84e944bfb4299946e8457ece3ce6c384ff78e + md5: 8f15f0ec9b69344df5c3bb5cce1751a1 + depends: + - __glibc >=2.17,<3.0.a0 + - icu >=78.3,<79.0a0 + - libgcc >=15 + - libzlib >=1.3.2,<2.0a0 + license: blessing + run_exports: + weak: + - libsqlite >=3.54.1,<4.0a0 + size: 983668 + timestamp: 1792175587601 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libssh2-1.11.1-h6154650_1.conda + sha256: 7e463000fa1cba3f3a6597b776f6ab301d425a96e3bc20d0d9d76a3b9f237aa3 + md5: 5c526561e1d2a2e071941174eae84557 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + - libzlib >=1.3.2,<2.0a0 + - openssl >=3.5.7,<4.0a0 + license: BSD-3-Clause + license_family: BSD + run_exports: + weak: + - libssh2 >=1.11.1,<2.0a0 + size: 306045 + timestamp: 1786713107897 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libstdcxx-16.2.0-h934c35e_7.conda + sha256: fa7018298629fc429971fffd6ecba3d27a7b02e4e890d6a93ea01ffebe8cb745 + md5: 9b6707e0caca917fa6ea9ee473f37a5d + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc 16.2.0 ha9f2e26_7 + constrains: + - libstdcxx-ng ==16.2.0=*_7 + license: GPL-3.0-only WITH GCC-exception-3.1 + license_family: GPL + run_exports: {} + size: 6615436 + timestamp: 1790303132935 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libtasn1-4.21.0-h7cc23a3_1.conda + sha256: 8db5fe4b5ca8e9f35622d3903e9dcdb28e4e289fcdba3212ee48c9be9dca91f5 + md5: efe26e97b4c332d0c8b2ae6306747133 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: LGPL-2.1-or-later + run_exports: + weak: + - libtasn1 >=4.21.0,<5.0a0 + size: 118904 + timestamp: 1793068469782 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libtiff-4.7.2-h6d37cbf_2.conda + sha256: 3406eed96ee929309ecd3937308d5a81302f4ca2eddd30e832071cbe9121a6c7 + md5: 18023fe8fbec4f031ca88444572590e4 + depends: + - __glibc >=2.17,<3.0.a0 + - lerc >=4.3.0,<5.0a0 + - libdeflate >=1.26,<1.27.0a0 + - libgcc >=15 + - libjpeg-turbo >=3.2.1,<4.0a0 + - liblzma >=5.8.3,<6.0a0 + - libstdcxx >=15 + - libwebp-base >=1.6.0,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + - zstd >=1.5.7,<1.6.0a0 + license: HPND + run_exports: + weak: + - libtiff >=4.7.2,<4.8.0a0 + size: 459656 + timestamp: 1794045728051 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libtree-sitter-0.25.9-h280c20c_0.conda + sha256: de4133900552a22fb1d8f5de690b15f784d2bbd7cdd967ad282bd34c965124bf + md5: a9a506002eda117e7cd473305c825f1a + depends: + - libgcc >=14 + - __glibc >=2.17,<3.0.a0 + license: MIT + license_family: MIT + run_exports: + weak: + - libtree-sitter >=0.25.9,<0.26.0a0 + size: 205332 + timestamp: 1757201839815 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libunistring-0.9.10-h7f98852_0.tar.bz2 + sha256: e88c45505921db29c08df3439ddb7f771bbff35f95e7d3103bf365d5d6ce2a6d + md5: 7245a044b4a1980ed83196176b78b73a + depends: + - libgcc-ng >=9.3.0 + license: GPL-3.0-only OR LGPL-3.0-only + run_exports: + weak: + - libunistring >=0,<1.0a0 + size: 1433436 + timestamp: 1626955018689 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libuuid-2.42.4-hcfc3c73_1.conda + sha256: 0e2e8f2daa9306e67f046e31092d637431d8cf0a26c407ab22401d108c2d4631 + md5: d852293faea3c04a6e896b908b43aded + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: BSD-3-Clause + license_family: BSD + run_exports: + weak: + - libuuid >=2.42.4,<3.0a0 + size: 36134 + timestamp: 1793891599274 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libwebp-base-1.6.0-hd42ef1d_1.conda + sha256: 8415001414f488c85b72b9d8cc2071dfb3981a47bc3c8eb56ef91a57d12eae7f + md5: 9332b53d0ea93c5d39e33be03a0c611a + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + constrains: + - libwebp 1.6.0 + license: BSD-3-Clause + license_family: BSD + run_exports: + weak: + - libwebp-base >=1.6.0,<2.0a0 + size: 428430 + timestamp: 1785954557217 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libxcb-1.17.0-hb83e432_3.conda + sha256: 38021f35547021762c04860d1c9f2d3186b83e090e5f1773216045de06cf10cc + md5: 661d9e1392a1b672d19d76df3a1feb07 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - pthread-stubs + - xorg-libxau >=1.0.12,<2.0a0 + - xorg-libxdmcp >=1.1.5,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - libxcb >=1.17.0,<2.0a0 + size: 398900 + timestamp: 1794246094531 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libxkbcommon-1.13.2-h59c2f34_2.conda + sha256: 156fdf41b9f3efc54c077b5b8570b810a87800b978c12348c27ec6e0ddc20359 + md5: b85ed11539022fbbf4e63117692179ec + depends: + - xkeyboard-config + - libgcc >=15 + - libstdcxx >=15 + - __glibc >=2.17,<3.0.a0 + - libxml2 + - libxml2-16 >=2.15.4 + - xorg-libxau >=1.0.12,<2.0a0 + - libxcb >=1.17.0,<2.0a0 + license: MIT AND MIT-open-group AND HPND AND HPND-sell-variant AND ISC + run_exports: + weak: + - libxkbcommon >=1.13.2,<2.0a0 + size: 945345 + timestamp: 1792810173656 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libxml2-16-2.15.4-hf3af7cc_1.conda + sha256: d1906463070c21f3215cd5de93164f31c44d5bac6ae9b5d8f5adf42b1e304039 + md5: 046d9eada488e1a1657c80b55c23da52 + depends: + - __glibc >=2.17,<3.0.a0 + - icu >=78.3,<79.0a0 + - libgcc >=15 + - libiconv >=1.18,<2.0a0 + - liblzma >=5.8.3,<6.0a0 + - libzlib >=1.3.2,<2.0a0 + constrains: + - libxml2 2.15.4 + license: MIT + license_family: MIT + run_exports: {} + size: 569062 + timestamp: 1791465631497 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libxml2-2.15.4-h7df9aa5_1.conda + sha256: 8c32be9e8720bc413d2b4267517459d7d71fad4a5f398a2aa8319b6d7b8a00e6 + md5: 51e5162f95bd6840f6b2b3169125fff5 + depends: + - __glibc >=2.17,<3.0.a0 + - icu >=78.3,<79.0a0 + - libgcc >=15 + - libiconv >=1.18,<2.0a0 + - liblzma >=5.8.3,<6.0a0 + - libxml2-16 2.15.4 hf3af7cc_1 + - libzlib >=1.3.2,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - libxml2 + - libxml2-16 >=2.15.4 + size: 46570 + timestamp: 1791465635923 +- conda: https://conda.anaconda.org/conda-forge/linux-64/libzlib-1.3.2-h25fd6f3_3.conda + sha256: eb8a0db0aa570124f7d2a93d7c7f596e3390df5e047818d873baad32985fc736 + md5: 0de0122d9570a8ab637c6b73db268389 + depends: + - __glibc >=2.17,<3.0.a0 + constrains: + - zlib 1.3.2 *_3 + license: Zlib + license_family: Other + run_exports: + weak: + - libzlib >=1.3.2,<2.0a0 + size: 63713 + timestamp: 1785362952714 +- conda: https://conda.anaconda.org/conda-forge/linux-64/lychee-0.24.2-h39d0f39_1.conda + sha256: 59a5afe396a93269ddc4b67262412f0cb707d1294393944d461b2f29164ab5dc + md5: 81747139d7e9fba97af275d1c8f7fe0a + depends: + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + constrains: + - __glibc >=2.17 + license: Apache-2.0 OR MIT + run_exports: {} + size: 5760830 + timestamp: 1791278254472 +- conda: https://conda.anaconda.org/conda-forge/linux-64/markupsafe-3.0.4-py313h2af15c8_5.conda + sha256: def2a3d0cda3f815b569d5224ef65200555164136cdd3acba30c07321ecfeff6 + md5: eae8eb68bfde138aab698e02a6a19809 + depends: + - python + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - python_abi 3.13.* *_cp313 + constrains: + - jinja2 >=3.0.0 + license: BSD-3-Clause + run_exports: {} + size: 27791 + timestamp: 1794823807688 +- conda: https://conda.anaconda.org/conda-forge/linux-64/mpc-1.4.1-ha2cb11d_0.conda + sha256: ab81712f560a055277a23435b17c113e4aa8b2b15d31042dbc959e236cc5c528 + md5: 8ca4b2b9325e2d22aaf7639aaa5369a1 + depends: + - __glibc >=2.17,<3.0.a0 + - gmp >=6.3.0,<7.0a0 + - libgcc >=15 + - mpfr >=4.2.2,<5.0a0 + license: LGPL-3.0-or-later + run_exports: + weak: + - mpc >=1.4.1,<2.0a0 + size: 101262 + timestamp: 1794641220776 +- conda: https://conda.anaconda.org/conda-forge/linux-64/mpfr-4.2.2-ha2cb11d_1.conda + sha256: 0be79ef2ee536e0c5d3ddb4a52bbae9f26d08560623299f33db2f4c4a17c525a + md5: 7dcc10f6c0bc3596d5519a710a84dfd4 + depends: + - __glibc >=2.17,<3.0.a0 + - gmp >=6.3.0,<7.0a0 + - libgcc >=15 + license: LGPL-3.0-only + license_family: LGPL + run_exports: + weak: + - mpfr >=4.2.2,<5.0a0 + size: 730409 + timestamp: 1787236218159 +- conda: https://conda.anaconda.org/conda-forge/linux-64/ncurses-6.6-hdb14827_1.conda + sha256: 5d46557214ed184381dafe835b7c94a474a1c3b307a08a250b1ea4779b44ffb3 + md5: ee6c0cd80a60961a1f48aa3e0b91f986 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + license: X11 AND BSD-3-Clause + run_exports: + weak: + - ncurses >=6.6,<7.0a0 + size: 911196 + timestamp: 1786355078102 +- conda: https://conda.anaconda.org/conda-forge/linux-64/nettle-3.10.1-h5ef0d04_1.conda + sha256: 9f08df8a8d6660c4c5d8c810da2da2a5b099cd00ca30e1174be6d8df27a82120 + md5: 7b8f8d1226c95f61a51436a657c84770 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + - gmp >=6.3.0,<7.0a0 + license: GPL-2.0-or-later OR LGPL-3.0-or-later + run_exports: + weak: + - nettle >=3.10.1,<3.11.0a0 + size: 1052171 + timestamp: 1787065085312 +- conda: https://conda.anaconda.org/conda-forge/linux-64/openssl-3.6.5-h781a0a9_0.conda + sha256: 9c1533f1cf784f0e250919c0c9762d0b0e6bc727a79290ffb7cea1ceca1d038c + md5: 5a51a2ea653f120240b1a9bf76e0aae9 + depends: + - __glibc >=2.17,<3.0.a0 + - ca-certificates + - libgcc >=15 + license: Apache-2.0 + license_family: Apache + run_exports: + weak: + - openssl >=3.6.5,<4.0a0 + size: 3195299 + timestamp: 1791098052301 +- conda: https://conda.anaconda.org/conda-forge/linux-64/p11-kit-0.26.5-h8d769aa_2.conda + sha256: 16bcb050de08f5423b0e898dea9eb08a66ff93c1b347233137ffc17b2ec7e66c + md5: aeb4e6fe52e15c22f44f73476510c005 + depends: + - __glibc >=2.17,<3.0.a0 + - libffi >=3.7.0,<3.8.0a0 + - libgcc >=15 + - libtasn1 >=4.21.0,<5.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - p11-kit >=0.26.5,<0.27.0a0 + size: 3945183 + timestamp: 1788196153960 +- conda: https://conda.anaconda.org/conda-forge/linux-64/pango-1.58.2-h2f58602_3.conda + sha256: 255c7311441dddee7858279b799156387a6719d3a114dce861cbf379f6fb9d6e + md5: 4a1bbf999cdcdcf3ca1bfd819259f795 + depends: + - libpango-devel ==1.58.2 h317d9d0_3 + license: LGPL-2.1-or-later + run_exports: + weak: + - libpango >=1.58.2,<2.0a0 + size: 15014 + timestamp: 1792050659391 +- conda: https://conda.anaconda.org/conda-forge/linux-64/pcre2-10.49-h8b3dc9c_0.conda + sha256: 63784a2dd0231cf8944b31a781b4ebab48954a94cd455d13585874370e46b658 + md5: db724d35be3a1c7b6cd49b7a03de4027 + depends: + - __glibc >=2.17,<3.0.a0 + - bzip2 >=1.0.8,<2.0a0 + - libgcc >=15 + - libzlib >=1.3.2,<2.0a0 + license: BSD-3-Clause + license_family: BSD + run_exports: + weak: + - pcre2 >=10.49,<10.50.0a0 + size: 1234818 + timestamp: 1793902484896 +- conda: https://conda.anaconda.org/conda-forge/linux-64/pixman-0.46.4-h54a6638_3.conda + sha256: 829d8288764282de5a9f7b9169acb75cc7dc0b6c3fe2535cfe87dea3436bbc5d + md5: 0ee5bb30034b081a1386c1e2c98ab0a7 + depends: + - libstdcxx >=14 + - libgcc >=14 + - __glibc >=2.17,<3.0.a0 + license: MIT + license_family: MIT + run_exports: + weak: + - pixman >=0.46.4,<1.0a0 + size: 376704 + timestamp: 1786106621354 +- conda: https://conda.anaconda.org/conda-forge/linux-64/pthread-stubs-0.4-h7cc23a3_1004.conda + sha256: 4a44fd00ea73b79ca2c89b0727b9ccf61c506ead71e67a9abfa4c590042b5a4a + md5: bb66b610707b811e3c65181a6431e7a8 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: MIT + license_family: MIT + run_exports: {} + size: 9630 + timestamp: 1788381877753 +- conda: https://conda.anaconda.org/conda-forge/linux-64/python-3.13.18-hf47f18c_100_cp313.conda + build_number: 100 + sha256: 8c20b663f2da07fee96f5406651854727a18d173e84735b71136cf06d7032b47 + md5: 8a8f008a3e3ae6e4eb6e149d639ab43e + depends: + - __glibc >=2.17,<3.0.a0 + - bzip2 >=1.0.8,<2.0a0 + - ld_impl_linux-64 >=2.36.1 + - libexpat >=2.8.5,<3.0a0 + - libffi >=3.7.0,<3.8.0a0 + - libgcc >=15 + - liblzma >=5.8.3,<6.0a0 + - libmpdec >=4.0.0,<5.0a0 + - libpython 3.13.18 hd51c5da_100_cp313 + - libsqlite >=3.54.1,<4.0a0 + - libuuid >=2.42.4,<3.0a0 + - libzlib >=1.3.2,<2.0a0 + - ncurses >=6.6,<7.0a0 + - openssl >=3.5.9,<4.0a0 + - python_abi 3.13.* *_cp313 + - readline >=8.3,<9.0a0 + - tk >=8.6.13,<8.7.0a0 + - tzdata + license: Python-2.0 + run_exports: + weak: + - python_abi 3.13.* *_cp313 + noarch: + - python + size: 24309726 + timestamp: 1793015646233 + python_site_packages_path: lib/python3.13/site-packages +- conda: https://conda.anaconda.org/conda-forge/linux-64/pyyaml-6.0.3-py313h45b8176_3.conda + sha256: 3e90c35deffbc80fe714ddfc28201589604f6b1144593a78d28929be899b1b60 + md5: b53b2182e0df385ce82e39a38a4a7b05 + depends: + - python + - yaml + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + - yaml >=0.2.5,<0.3.0a0 + - python_abi 3.13.* *_cp313 + license: MIT + license_family: MIT + run_exports: {} + size: 226628 + timestamp: 1793655133957 +- conda: https://conda.anaconda.org/conda-forge/linux-64/readline-8.3-hd6e31c0_1.conda + sha256: 01b3fe073a66e321970d09e04b388708f8cbdca5cdfbfcb7c9eeb470ad10383d + md5: 69c01c781e7c8190bbdaf79e3848c5ca + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - ncurses >=6.6,<7.0a0 + license: GPL-3.0-only + license_family: GPL + run_exports: + weak: + - readline >=8.3,<9.0a0 + size: 348899 + timestamp: 1787033801506 +- conda: https://conda.anaconda.org/conda-forge/linux-64/tk-8.6.13-noxft_h1df4ec4_4.conda + build_number: 104 + sha256: a1a241d172c1ccab067ba245206dd048bc3c2d1b84504b53c9468e99adfc16a1 + md5: 676a2f9b1c4fcf57b70aa5c65f6c60d0 + depends: + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + - libzlib >=1.3.2,<2.0a0 + constrains: + - xorg-libx11 >=1.8.13,<2.0a0 + license: TCL + run_exports: + weak: + - tk >=8.6.13,<8.7.0a0 + size: 3566806 + timestamp: 1787272857910 +- conda: https://conda.anaconda.org/conda-forge/linux-64/wayland-1.26.0-hc1c935e_2.conda + sha256: df65b987979e6d7f88e756494da5a230d4f2d08d17437d04eecd35559c3a04e4 + md5: 88a47e22b53e50865b1cabe2eb648352 + depends: + - __glibc >=2.17,<3.0.a0 + - libexpat >=2.8.1,<3.0a0 + - libffi >=3.7.0,<3.8.0a0 + - libgcc >=15 + - libstdcxx >=15 + license: MIT + license_family: MIT + run_exports: + weak: + - wayland >=1.26.0,<2.0a0 + size: 340058 + timestamp: 1787793849093 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xkeyboard-config-2.48-hebe6cf0_1.conda + sha256: 5d803109509756b39e018b780746ed4210cff640eb428fd58fa6c64c9c15ae6b + md5: 1d0383de55470a551d61ccdc225c0d88 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - xorg-libx11 >=1.8.14,<2.0a0 + license: MIT + license_family: MIT + run_exports: {} + size: 441638 + timestamp: 1792698743043 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libice-1.1.2-h280c20c_0.conda + sha256: 49b532d1df875c6749d9078b56a76f3f5db49a5abe0ca620b593ed474ef0ebf1 + md5: 85c9442aec283b4e464fa9ecc484a2f3 + depends: + - libgcc >=14 + - __glibc >=2.17,<3.0.a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libice >=1.1.2,<2.0a0 + size: 62517 + timestamp: 1786474410404 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libsm-1.2.6-h0d788c3_1.conda + sha256: ef907caee0665cf3b0f775602cc50e388e3bade8ce22ecade0873ff26604b2fd + md5: aa7459ed9ad086ba11dda843d764b33d + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + - xorg-libice >=1.1.2,<2.0a0 + - libuuid >=2.42.2,<3.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libsm >=1.2.6,<2.0a0 + size: 30739 + timestamp: 1786545374265 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libx11-1.8.14-hb83e432_0.conda + sha256: 1815dc9900bf3a4678caeb343bccbbc74cd5e5a5ff3f6e0a2c01c5e19cd9d30b + md5: e7752792cb214013a34e265cc0838352 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - libxcb >=1.17.0,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libx11 >=1.8.14,<2.0a0 + size: 846774 + timestamp: 1792545407029 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxau-1.0.12-h7cc23a3_2.conda + sha256: 3ec065b94554dc48a4ca582a960a5484bc166b26e83ce0954653e08d17e8bd53 + md5: da33efee1a93603d92e06d4a2b68def6 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxau >=1.0.12,<2.0a0 + size: 18793 + timestamp: 1788960512381 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxcomposite-0.4.7-hb03c661_0.conda + sha256: 048c103000af9541c919deef03ae7c5e9c570ffb4024b42ecb58dbde402e373a + md5: f2ba4192d38b6cef2bb2c25029071d90 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=14 + - xorg-libx11 >=1.8.12,<2.0a0 + - xorg-libxfixes >=6.0.2,<7.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxcomposite >=0.4.7,<1.0a0 + size: 14415 + timestamp: 1770044404696 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxcursor-1.2.3-h7cc23a3_1.conda + sha256: 5a819cd8d06656559349175be63bab398947e9755fe54692fab1bfab5385211a + md5: 6115d96e6728a7518358314701a27f75 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - xorg-libx11 >=1.8.14,<2.0a0 + - xorg-libxfixes >=6.0.2,<7.0a0 + - xorg-libxrender >=0.9.13,<0.10.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxcursor >=1.2.3,<2.0a0 + size: 34792 + timestamp: 1793235593597 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxdamage-1.1.6-hb9d3cd8_0.conda + sha256: 43b9772fd6582bf401846642c4635c47a9b0e36ca08116b3ec3df36ab96e0ec0 + md5: b5fcc7172d22516e1f965490e65e33a4 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=13 + - xorg-libx11 >=1.8.10,<2.0a0 + - xorg-libxext >=1.3.6,<2.0a0 + - xorg-libxfixes >=6.0.1,<7.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxdamage >=1.1.6,<2.0a0 + size: 13217 + timestamp: 1727891438799 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxdmcp-1.1.5-h7cc23a3_2.conda + sha256: 8a095df9bc1d2e50f2504ce8858a047ae29ea634aad6cc0b43298c63361da6d9 + md5: eabfc45786244de252090cf8d55128a8 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxdmcp >=1.1.5,<2.0a0 + size: 22606 + timestamp: 1789676943335 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxext-1.3.7-h7cc23a3_1.conda + sha256: aa9bbe8b278aacc194e280ff5037f9f9a1f2c5b33ed97de8e7f01cfbe90dda43 + md5: e5b6b28536b81b3f4cb20db4668a4642 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - xorg-libx11 >=1.8.13,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxext >=1.3.7,<2.0a0 + size: 53124 + timestamp: 1787100841900 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxfixes-6.0.2-h7cc23a3_1.conda + sha256: aec84f554fc897bf4085c7bc8b8f0740e4c224e13bca3cc51c93e7699d56f83a + md5: 09132e874fe0e1f5e4492b0b6b904b6e + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - xorg-libx11 >=1.8.13,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxfixes >=6.0.2,<7.0a0 + size: 21440 + timestamp: 1787248059682 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxi-1.8.4-h7cc23a3_0.conda + sha256: bb12543188be23b6e16e478d8b550d4e60bb52dc9c6f0667a5c865ceb3e7a881 + md5: 4ae02f09591c09bbe61a2b675d799ce5 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - xorg-libx11 >=1.8.13,<2.0a0 + - xorg-libxext >=1.3.7,<2.0a0 + - xorg-libxfixes >=6.0.2,<7.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxi >=1.8.4,<2.0a0 + size: 49659 + timestamp: 1792543111146 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxinerama-1.1.6-hd2095e1_1.conda + sha256: 4bd09fade2b2ca9f69cd6c5211f7fb172b81a43697aa1f009cab48eec5a233bf + md5: ff48e795cb92fc74087c7e818d4dcff1 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - libstdcxx >=15 + - xorg-libx11 >=1.8.14,<2.0a0 + - xorg-libxext >=1.3.7,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxinerama >=1.1.6,<1.2.0a0 + size: 16227 + timestamp: 1794185243418 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxrandr-1.5.5-h7cc23a3_1.conda + sha256: 05a7f25d7f7f5cd32b27a019233ece97167fd8ade255bc13a0e49e53387f4c30 + md5: 798a8c9d171859a022e1cb89e7d0eb10 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - xorg-libx11 >=1.8.13,<2.0a0 + - xorg-libxext >=1.3.7,<2.0a0 + - xorg-libxrender >=0.9.12,<0.10.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxrandr >=1.5.5,<2.0a0 + size: 31106 + timestamp: 1787246614086 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxrender-0.9.13-h7cc23a3_0.conda + sha256: 008d610d6ec1d021ad678024afd5dcf534ff84d9c1e9d2877ff36d112c89896f + md5: 7249ce52789c3680e889e7335a2e1c3e + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - xorg-libx11 >=1.8.13,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxrender >=0.9.13,<0.10.0a0 + size: 34604 + timestamp: 1792530399214 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxtst-1.2.6-h7cc23a3_0.conda + sha256: 9d8e7a2db860da3f362284650b447a96688b834bdb3122707b04bae512a1a178 + md5: 05e756ed9e8b2358591d47f6b8939db4 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - xorg-libx11 >=1.8.13,<2.0a0 + - xorg-libxext >=1.3.7,<2.0a0 + - xorg-libxi >=1.8.3,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxtst >=1.2.6,<2.0a0 + size: 34918 + timestamp: 1792204941937 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-libxxf86vm-1.1.7-h7cc23a3_1.conda + sha256: 264ddaeba8de4fe17fb25d10c6f6c2aac5d8d41d8883a0976dae59b528ef9520 + md5: ac05771f924d124349ef9cc3140e9876 + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + - xorg-libx11 >=1.8.14,<2.0a0 + - xorg-libxext >=1.3.7,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - xorg-libxxf86vm >=1.1.7,<2.0a0 + size: 20109 + timestamp: 1794184632365 +- conda: https://conda.anaconda.org/conda-forge/linux-64/xorg-xorgproto-2025.1-hebe6cf0_3.conda + sha256: 8e9c7ca4fcfe9f0c300e4aa853b79c25411fc4e470decfe8f909b74f60dfb6dd + md5: c3d0a6f03ba3aa312777b41b20a71ec0 + depends: + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + license: MIT + license_family: MIT + run_exports: {} + size: 596340 + timestamp: 1788874111132 +- conda: https://conda.anaconda.org/conda-forge/linux-64/yaml-0.2.5-hebe6cf0_3.conda + sha256: d164dfa75ecd538f6fd68765defcc06aa875bc697b9b215362d79a2a73125dd0 + md5: e741576fb8f89821ac7c1c537322a33d + depends: + - __glibc >=2.17,<3.0.a0 + - libgcc >=15 + license: MIT + license_family: MIT + run_exports: + weak: + - yaml >=0.2.5,<0.3.0a0 + size: 84936 + timestamp: 1787228426393 +- conda: https://conda.anaconda.org/conda-forge/linux-64/zig-0.17.1-89c0722_0.conda + sha256: 36fe7fd9960cca013e843798706fa21f93ebb9839527334c7b43bc77b0592193 + md5: 7ba9f63b0c91252ef787d6a574a11c15 + depends: + - zig_linux-64 ==0.17.1 fa519dd_0 + - libstdcxx >=15 + - libgcc >=15 + license: MIT AND Apache-2.0 WITH LLVM-exception AND Apache-2.0 AND LGPL-2.1-or-later AND BSD-2-Clause AND BSD-3-Clause AND ZPL-2.1 AND LicenseRef-Public-Domain + run_exports: + weak: + - zig >=0.17.1,<0.17.2.0a0 + size: 230408 + timestamp: 1794496954055 +- conda: https://conda.anaconda.org/conda-forge/linux-64/zig_impl_linux-64-0.17.1-0addc32_0.conda + sha256: a059082ebd358256c76914c0ecf061b23a79cf705be9f877f3f3e7bcbab13ab3 + md5: d6666c72896f39a252c28a5fd57d929e + depends: + - libstdcxx >=15 + - libgcc >=15 + - __glibc >=2.17,<3.0.a0 + - libclang-cpp22.1 >=22.1.8,<22.2.0a0 + - libllvm22 >=22.1.8,<22.2.0a0 + - libxml2 + - libzlib >=1.3.2,<2.0a0 + - zstd >=1.5.7,<1.6.0a0 + license: MIT AND Apache-2.0 WITH LLVM-exception AND Apache-2.0 AND LGPL-2.1-or-later AND BSD-2-Clause AND BSD-3-Clause AND ZPL-2.1 AND LicenseRef-Public-Domain + run_exports: {} + size: 77529577 + timestamp: 1794496954055 +- conda: https://conda.anaconda.org/conda-forge/linux-64/zig_linux-64-0.17.1-fa519dd_0.conda + sha256: 69801f7b6201bab75250a094b6af4ae6e5457f40e6bce6ef66f0788d43397b1e + md5: b3c1277859f37ea8acf2aec28dc29016 + depends: + - zig_impl_linux-64 ==0.17.1 0addc32_0 + - libstdcxx-devel_linux-64 15.* + - libgcc-devel_linux-64 15.* + - __glibc >=2.17,<3.0.a0 + license: MIT AND Apache-2.0 WITH LLVM-exception AND Apache-2.0 AND LGPL-2.1-or-later AND BSD-2-Clause AND BSD-3-Clause AND ZPL-2.1 AND LicenseRef-Public-Domain + run_exports: + strong: + - libstdcxx >=15 + - libgcc >=15 + size: 362660 + timestamp: 1794496954055 +- conda: https://conda.anaconda.org/conda-forge/linux-64/zstd-1.5.7-hb78ec9c_7.conda + sha256: 47d682b9f6d6ec9eb1a6e6c3e75ea6273e899e78fb7fc59f81d39745009fbc60 + md5: aa459086047c0e5e27023ab19f8cb86a + depends: + - __glibc >=2.17,<3.0.a0 + - libzlib >=1.3.2,<2.0a0 + license: BSD-3-Clause + license_family: BSD + run_exports: + weak: + - zstd >=1.5.7,<1.6.0a0 + size: 601301 + timestamp: 1786599621503 +- conda: https://conda.anaconda.org/conda-forge/noarch/_python_abi3_support-1.0-hd8ed1ab_3.conda + sha256: 2a7204314663eeda5dec482a956f0e2eaf289bd5b9953eaaaad0e81aa64638f2 + md5: 3845f3d75991bae0fb90884662f4327c + depends: + - cpython + - python-gil + license: MIT + license_family: MIT + run_exports: {} + size: 8144 + timestamp: 1784221492234 +- conda: https://conda.anaconda.org/conda-forge/noarch/adwaita-icon-theme-51.0-unix_0.conda + sha256: def01b148aa54d4de29b7d4bf58d941c8699582201db14cf78c6c89fa1666434 + md5: 6f62266fb2bfc35a5071cfa1d6ffdcc9 + depends: + - __unix + - hicolor-icon-theme + - librsvg + license: LGPL-3.0-or-later OR CC-BY-SA-3.0 + run_exports: {} + size: 687517 + timestamp: 1790100765464 +- conda: https://conda.anaconda.org/conda-forge/noarch/alabaster-1.0.0-pyhd8ed1ab_1.conda + sha256: 6c4456a138919dae9edd3ac1a74b6fbe5fd66c05675f54df2f8ab8c8d0cc6cea + md5: 1fd9696649f65fd6611fcdb4ffec738a + depends: + - python >=3.10 + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 18684 + timestamp: 1733750512696 +- conda: https://conda.anaconda.org/conda-forge/noarch/babel-2.18.0-pyhcf101f3_1.conda + sha256: a14a9ad02101aab25570543a59c5193043b73dc311a25650134ed9e6cb691770 + md5: f1976ce927373500cc19d3c0b2c85177 + depends: + - python >=3.10 + - python + constrains: + - pytz >=2015.7 + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 7684321 + timestamp: 1772555330347 +- conda: https://conda.anaconda.org/conda-forge/noarch/ca-certificates-2026.10.23-hbd8a1cb_0.conda + sha256: 95619b9c1184be7175392eeb0ee7eeb5ccf25d280951f4225f2d62e725790be3 + md5: 3fd02989038a1e1cee627c14c2d73f29 + depends: + - __unix + license: ISC + run_exports: {} + size: 130057 + timestamp: 1792772446739 +- conda: https://conda.anaconda.org/conda-forge/noarch/certifi-2026.10.23-pyhd8ed1ab_3.conda + sha256: e17d21d2f133cae8eede0eef5a8acfa076b1999d00f11e714e1d18c2c8fd02c6 + md5: 6e761a5c8fd92be3a9fec46ade31b481 + depends: + - ca-certificates >=2026.10.23 + - python >=3.10 + license: ISC + run_exports: {} + size: 13539 + timestamp: 1793720135524 +- conda: https://conda.anaconda.org/conda-forge/noarch/charset-normalizer-3.5.1-pyhd8ed1ab_0.conda + sha256: cb60ef3e0631c8bacb4f7057196dee4496091a22baa3bb4b9bccb12c7e1c921b + md5: e0ac3accc64e23e40969d660e5f58ac8 + depends: + - python >=3.10 + license: MIT + license_family: MIT + run_exports: {} + size: 64487 + timestamp: 1786835648298 +- conda: https://conda.anaconda.org/conda-forge/noarch/colorama-0.4.6-pyhd8ed1ab_1.conda + sha256: ab29d57dc70786c1269633ba3dff20288b81664d3ff8d21af995742e2bb03287 + md5: 962b9857ee8e7018c22f2776ffa0b2d7 + depends: + - python >=3.9 + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 27011 + timestamp: 1733218222191 +- conda: https://conda.anaconda.org/conda-forge/noarch/cpython-3.13.18-py313hd8ed1ab_100.conda + noarch: generic + sha256: 283ec2ea28bb5f6de4bb74abebca67b984d95879eef436a13b5635396328e082 + md5: 7ffd95656f21420f6c2d0655e3735656 + depends: + - python >=3.13,<3.14.0a0 + - python_abi * *_cp313 + license: Python-2.0 + run_exports: {} + size: 50090 + timestamp: 1793014423191 +- conda: https://conda.anaconda.org/conda-forge/noarch/docutils-0.22.4-pyhd8ed1ab_0.conda + sha256: 0d605569a77350fb681f9ed8d357cc71649b59a304099dc9d09fbeec5e84a65e + md5: d6bd3cd217e62bbd7efe67ff224cd667 + depends: + - python >=3.10 + license: CC-PDDC AND BSD-3-Clause AND BSD-2-Clause AND ZPL-2.1 + run_exports: {} + size: 438002 + timestamp: 1766092633160 +- conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-dejavu-sans-mono-2.37-hab24e00_0.tar.bz2 + sha256: 58d7f40d2940dd0a8aa28651239adbf5613254df0f75789919c4e6762054403b + md5: 0c96522c6bdaed4b1566d11387caaf45 + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 397370 + timestamp: 1566932522327 +- conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-inconsolata-3.000-h77eed37_0.tar.bz2 + sha256: c52a29fdac682c20d252facc50f01e7c2e7ceac52aa9817aaf0bb83f7559ec5c + md5: 34893075a5c9e55cdafac56607368fc6 + license: OFL-1.1 + license_family: Other + run_exports: {} + size: 96530 + timestamp: 1620479909603 +- conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-source-code-pro-2.038-h77eed37_0.tar.bz2 + sha256: 00925c8c055a2275614b4d983e1df637245e19058d79fc7dd1a93b8d9fb4b139 + md5: 4d59c254e01d9cde7957100457e2d5fb + license: OFL-1.1 + license_family: Other + run_exports: {} + size: 700814 + timestamp: 1620479612257 +- conda: https://conda.anaconda.org/conda-forge/noarch/font-ttf-ubuntu-0.83-h77eed37_4.conda + sha256: a7384ac883b1acf492fd1aef27431f0f1a647bbb8b5709a1bfab11b0a765f5e5 + md5: 1df978a6efeb98fa80b96f2860b9b280 + license: Ubuntu-font-1.0 + license_family: Other + run_exports: {} + size: 1619009 + timestamp: 1794346192807 +- conda: https://conda.anaconda.org/conda-forge/noarch/fonts-conda-ecosystem-1-0.tar.bz2 + sha256: a997f2f1921bb9c9d76e6fa2f6b408b7fa549edd349a77639c9fe7a23ea93e61 + md5: fee5683a3f04bd15cbd8318b096a27ab + depends: + - fonts-conda-forge + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 3667 + timestamp: 1566974674465 +- conda: https://conda.anaconda.org/conda-forge/noarch/fonts-conda-forge-1-hc364b38_1.conda + sha256: 54eea8469786bc2291cc40bca5f46438d3e062a399e8f53f013b6a9f50e98333 + md5: a7970cd949a077b7cb9696379d338681 + depends: + - font-ttf-ubuntu + - font-ttf-inconsolata + - font-ttf-dejavu-sans-mono + - font-ttf-source-code-pro + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 4059 + timestamp: 1762351264405 +- conda: https://conda.anaconda.org/conda-forge/noarch/idna-3.20-pyh5ded981_0.conda + sha256: e044b1ec829e2e24f971fa3f3408eb26f1db836e521a58f08b0fd9a03fee47be + md5: ee73be987f9de9ea5c2fdaeefa7b6491 + depends: + - python >=3.11 + - python + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 178572 + timestamp: 1790020377150 +- conda: https://conda.anaconda.org/conda-forge/noarch/imagesize-2.0.1-pyhd8ed1ab_0.conda + sha256: 4e787f9ccc31053ccea56d98ecd284a4f788988a3f9c4627db72fdd0b127529b + md5: ebc56022e4ef7e74a829be94c53797ca + depends: + - python >=3.10 + license: MIT + license_family: MIT + run_exports: {} + size: 21467 + timestamp: 1787649248672 +- conda: https://conda.anaconda.org/conda-forge/noarch/jinja2-3.1.6-pyhcf101f3_1.conda + sha256: fc9ca7348a4f25fed2079f2153ecdcf5f9cf2a0bc36c4172420ca09e1849df7b + md5: 04558c96691bed63104678757beb4f8d + depends: + - markupsafe >=2.0 + - python >=3.10 + - python + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 120685 + timestamp: 1764517220861 +- conda: https://conda.anaconda.org/conda-forge/noarch/kernel-headers_linux-64-4.18.0-he073ed8_9.conda + sha256: 41557eeadf641de6aeae49486cef30d02a6912d8da98585d687894afd65b356a + md5: 86d9cba083cd041bfbf242a01a7a1999 + constrains: + - sysroot_linux-64 ==2.28 + license: LGPL-2.0-or-later AND LGPL-2.0-or-later WITH exceptions AND GPL-2.0-or-later + license_family: GPL + run_exports: {} + size: 1278712 + timestamp: 1765578681495 +- conda: https://conda.anaconda.org/conda-forge/noarch/libgcc-devel_linux-64-15.3.0-h2b852eb_107.conda + sha256: 5200a1402eb3c3e9b0e4ba38b3cf163be136d020a15477fb86ce6e754d3ae515 + md5: 057ab488a4da13485caa3b672df9824a + depends: + - __unix + license: GPL-3.0-only WITH GCC-exception-3.1 + license_family: GPL + run_exports: {} + size: 3085843 + timestamp: 1790302578256 +- conda: https://conda.anaconda.org/conda-forge/noarch/libstdcxx-devel_linux-64-15.3.0-hb2c5482_107.conda + sha256: 4b2d94a9abf2feedea354e4256756c5dc255b84080e7faed9a324a101cf20e74 + md5: edce245dade1c29f691983796b4b8414 + depends: + - __unix + license: GPL-3.0-only WITH GCC-exception-3.1 + license_family: GPL + run_exports: {} + size: 20673146 + timestamp: 1790302599776 +- conda: https://conda.anaconda.org/conda-forge/noarch/markdown-it-py-4.3.0-pyhd8ed1ab_0.conda + sha256: 4ccea503ad204bba76b8911fce9245488456bf31249fc6e3d95c072602dc1143 + md5: 975dce37a9e7d56c4f56981666578b07 + depends: + - mdurl >=0.1,<1 + - python >=3.10 + license: MIT + license_family: MIT + run_exports: {} + size: 74305 + timestamp: 1794422554733 +- conda: https://conda.anaconda.org/conda-forge/noarch/mdit-py-plugins-0.7.0-pyhd8ed1ab_0.conda + sha256: 9757a597362961195f6bf0cb93b77ed41814f8461fb99e5728a676193d676b1a + md5: b3f1ff606285e87cb76017e004d3b463 + depends: + - markdown-it-py >=3.0.0,<5.0.0 + - python >=3.10 + license: MIT + license_family: MIT + run_exports: {} + size: 56027 + timestamp: 1794422336457 +- conda: https://conda.anaconda.org/conda-forge/noarch/mdurl-0.1.2-pyhd8ed1ab_1.conda + sha256: 78c1bbe1723449c52b7a9df1af2ee5f005209f67e40b6e1d3c7619127c43b1c7 + md5: 592132998493b3ff25fd7479396e8351 + depends: + - python >=3.9 + license: MIT + license_family: MIT + run_exports: {} + size: 14465 + timestamp: 1733255681319 +- conda: https://conda.anaconda.org/conda-forge/noarch/myst-parser-5.2.0-pyhd8ed1ab_0.conda + sha256: a1d937b0705e31496ed97866b7f714b3926b76b4ca111475a68675cc4bde2020 + md5: ec615efa256902ded31b2dd69d011d1b + depends: + - docutils >=0.20,<0.24 + - jinja2 + - markdown-it-py >=4.2.0,<5 + - mdit-py-plugins >=0.7.0,<1 + - python >=3.11 + - pyyaml + - sphinx >=8,<10 + license: MIT + license_family: MIT + run_exports: {} + size: 90015 + timestamp: 1794425517871 +- conda: https://conda.anaconda.org/conda-forge/noarch/packaging-26.3-pyhc364b38_0.conda + sha256: c432626b16768b8dab228bfb706f7060c2d462a21c516d240f68f2f902b5a044 + md5: 936687ed80f295a1f5dbcf8bd34c252c + depends: + - python >=3.9 + - python + license: Apache-2.0 + license_family: APACHE + run_exports: {} + size: 116363 + timestamp: 1785888127370 +- conda: https://conda.anaconda.org/conda-forge/noarch/pygments-2.21.0-pyhcf101f3_0.conda + sha256: f5f015ff1bc3e1b7fc08eee096b1865234189ae0b82bebdb86a5369116e42fa0 + md5: 2882dee445dfa45b0c5afce3ffb7730a + depends: + - python >=3.10 + - python + license: BSD-2-Clause + license_family: BSD + run_exports: {} + size: 959376 + timestamp: 1786995678795 +- conda: https://conda.anaconda.org/conda-forge/noarch/pygments-styles-0.3.0-pyhd8ed1ab_0.conda + sha256: 451e28671386bc66ecd6fdd999aa8a62502596760cb77e4226ad298edef0a76a + md5: 7bcc971fbb4ef305d6953ce95c6179b7 + depends: + - pygments + - python >=3.10 + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 21902 + timestamp: 1762266264143 +- conda: https://conda.anaconda.org/conda-forge/noarch/python-gil-3.13.18-h4df99d1_100.conda + sha256: 5fcdc5f22a5d6354230e3757347165f4ddcdcc04fd523b361b59a0d679cd6c91 + md5: 9c939d47ea820fdf3cdbc9582188bb70 + depends: + - cpython 3.13.18.* + - python_abi * *_cp313 + license: Python-2.0 + run_exports: {} + size: 50086 + timestamp: 1793014429956 +- conda: https://conda.anaconda.org/conda-forge/noarch/python_abi-3.13-9_cp313.conda + build_number: 9 + sha256: 9dc0cb6a20ebc7e9bcd8c6868f2bec083c114b0ba20b7118405c036533d5c522 + md5: c5abc97af551bc12d71305852392f75c + constrains: + - python 3.13.* *_cp313 + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 6769 + timestamp: 1788302828005 +- conda: https://conda.anaconda.org/conda-forge/noarch/requests-2.34.2-pyhcf101f3_0.conda + sha256: 1715246b19c9f85ee022933b4845f2fc14ac9184981b7b7d9b728bec8e9588da + md5: 4a85203c1d80c1059086ae860836ffb9 + depends: + - python >=3.10 + - certifi >=2023.5.7 + - charset-normalizer >=2,<4 + - idna >=2.5,<4 + - urllib3 >=1.26,<3 + - python + constrains: + - chardet >=3.0.2,<8 + license: Apache-2.0 + license_family: APACHE + run_exports: {} + size: 68709 + timestamp: 1778851103479 +- conda: https://conda.anaconda.org/conda-forge/noarch/roman-numerals-4.1.0-pyhd8ed1ab_0.conda + sha256: 30f3c04fcfb64c44d821d392a4a0b8915650dbd900c8befc20ade8fde8ec6aa2 + md5: 0dc48b4b570931adc8641e55c6c17fe4 + depends: + - python >=3.10 + license: 0BSD OR CC0-1.0 + run_exports: {} + size: 13814 + timestamp: 1766003022813 +- conda: https://conda.anaconda.org/conda-forge/noarch/shibuya-2026.7.12-pyhd8ed1ab_0.conda + sha256: acbbe4fff1f88e9988fc934311845b72ffca5e0f074cd7a9f31c045cb32781d4 + md5: d9011d5b8d6cb55b2bad3d76aa6fa710 + depends: + - pygments-styles + - python >=3.10 + - sphinx + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 87339 + timestamp: 1783799362860 +- conda: https://conda.anaconda.org/conda-forge/noarch/snowballstemmer-3.1.1-pyhd8ed1ab_0.conda + sha256: ad89284ea94821c20ff87e64b948e4afc690cf5202d14c009355b0594cf23aea + md5: 46b6abe31482f6bca064b965696ae807 + depends: + - python >=3.10 + license: BSD-3-Clause + license_family: BSD + run_exports: {} + size: 74456 + timestamp: 1780468201547 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-9.2.0-pyhc364b38_0.conda + sha256: 43c6100fbd2980786c0d3dd3cc76906200597a5d6d83995cc0b8e5afbce00c71 + md5: c1dbc9be69a349a057de3ab17160c887 + depends: + - python >=3.13 + - alabaster >=0.7.14 + - babel >=2.13 + - docutils >=0.21,<0.23 + - imagesize >=1.3 + - jinja2 >=3.1 + - packaging >=23.0 + - pygments >=2.17 + - requests >=2.30.0 + - roman-numerals >=1.0.0 + - snowballstemmer >=2.2 + - sphinxcontrib-applehelp >=1.0.7 + - sphinxcontrib-devhelp >=1.0.6 + - sphinxcontrib-htmlhelp >=2.0.6 + - sphinxcontrib-jsmath >=1.0.1 + - sphinxcontrib-qthelp >=1.0.6 + - sphinxcontrib-serializinghtml >=1.1.9 + - colorama >=0.4.6 + - python + license: BSD-2-Clause + license_family: BSD + run_exports: {} + size: 1588783 + timestamp: 1792587728747 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-autoapi-3.9.0-pyh5ded981_0.conda + sha256: 093453d2c50bf7de814f65e62c5568d7d0d1118473eebb7d2ea0e0d095ac4b94 + md5: cdd46294d340a6847af94f2790518752 + depends: + - python >=3.11 + - astroid >=3.0 + - jinja2 + - pyyaml + - sphinx >=7.4.0 + - python + license: MIT + license_family: MIT + run_exports: {} + size: 37103 + timestamp: 1793487424258 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-copybutton-0.5.2-pyhd8ed1ab_1.conda + sha256: 8cd892e49cb4d00501bc4439fb0c73ca44905f01a65b2b7fa05ba0e8f3924f19 + md5: bf22cb9c439572760316ce0748af3713 + depends: + - python >=3.9 + - sphinx >=1.8 + license: MIT + license_family: MIT + run_exports: {} + size: 17893 + timestamp: 1734573117732 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-design-0.8.0-pyhd8ed1ab_0.conda + sha256: 80ad3e0f137df6a7f6380de78c71e911d551f69ffa856043aa53cce289c13f0f + md5: 6a9ef411fc8221580ee1bbd023edee81 + depends: + - python >=3.11 + - sphinx >=7.2,<10 + license: MIT + license_family: MIT + run_exports: {} + size: 1054687 + timestamp: 1794431986619 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-last-updated-by-git-0.3.8-pyhe01879c_0.conda + sha256: f761670b793dcc10a4a2d855de163d9dfd4016636ef093fb3e3d83ac25ed6e97 + md5: 405a232fb900fc631d2f1b5cdf01dea9 + depends: + - python >=3.9 + - sphinx >=1.8 + - python + license: BSD-2-Clause + license_family: BSD + run_exports: {} + size: 17546 + timestamp: 1750694360605 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinx-sitemap-2.9.0-pyhcf101f3_0.conda + sha256: 1be6289124207256df5dfbfe6ff0a652e313ac5c3e50560c9e510afa76eb702b + md5: 3baeff262222dc87e978a68702bc5797 + depends: + - python >=3.10 + - sphinx-last-updated-by-git + - python + license: MIT + license_family: MIT + run_exports: {} + size: 13441 + timestamp: 1759753011102 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-applehelp-2.0.0-pyhd8ed1ab_1.conda + sha256: d7433a344a9ad32a680b881c81b0034bc61618d12c39dd6e3309abeffa9577ba + md5: 16e3f039c0aa6446513e94ab18a8784b + depends: + - python >=3.9 + - sphinx >=5 + license: BSD-2-Clause + license_family: BSD + run_exports: {} + size: 29752 + timestamp: 1733754216334 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-devhelp-2.0.0-pyhd8ed1ab_1.conda + sha256: 55d5076005d20b84b20bee7844e686b7e60eb9f683af04492e598a622b12d53d + md5: 910f28a05c178feba832f842155cbfff + depends: + - python >=3.9 + - sphinx >=5 + license: BSD-2-Clause + license_family: BSD + run_exports: {} + size: 24536 + timestamp: 1733754232002 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-htmlhelp-2.1.0-pyhd8ed1ab_1.conda + sha256: c1492c0262ccf16694bdcd3bb62aa4627878ea8782d5cd3876614ffeb62b3996 + md5: e9fb3fe8a5b758b4aff187d434f94f03 + depends: + - python >=3.9 + - sphinx >=5 + license: BSD-2-Clause + license_family: BSD + run_exports: {} + size: 32895 + timestamp: 1733754385092 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-jsmath-2.0.0-pyh5ded981_0.conda + sha256: 59cedf5b1c202005f3af3c276e3fb1c7806bb7dbff476f8f8d46abcade227aed + md5: 7e9e28f90ddccdafa9e16a0541841bc4 + depends: + - python >=3.11 + - python + license: BSD-2-Clause + license_family: BSD + run_exports: {} + size: 25630 + timestamp: 1792589772735 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-qthelp-2.0.0-pyhd8ed1ab_1.conda + sha256: c664fefae4acdb5fae973bdde25836faf451f41d04342b64a358f9a7753c92ca + md5: 00534ebcc0375929b45c3039b5ba7636 + depends: + - python >=3.9 + - sphinx >=5 + license: BSD-2-Clause + license_family: BSD + run_exports: {} + size: 26959 + timestamp: 1733753505008 +- conda: https://conda.anaconda.org/conda-forge/noarch/sphinxcontrib-serializinghtml-2.0.0-pyhd8ed1ab_0.conda + sha256: 20b49741065fd7d3fabf98caf6d19b6436badb06b6d41f66b58f1fc2b52f37a1 + md5: f77df1fcf9af03b7287342638befca77 + depends: + - python >=3.10 + - sphinx >=5 + license: BSD-2-Clause + license_family: BSD + run_exports: {} + size: 30640 + timestamp: 1781260357443 +- conda: https://conda.anaconda.org/conda-forge/noarch/sysroot_linux-64-2.28-h4ee821c_9.conda + sha256: c47299fe37aebb0fcf674b3be588e67e4afb86225be4b0d452c7eb75c086b851 + md5: 13dc3adbc692664cd3beabd216434749 + depends: + - __glibc >=2.28 + - kernel-headers_linux-64 4.18.0 he073ed8_9 + - tzdata + license: LGPL-2.0-or-later AND LGPL-2.0-or-later WITH exceptions AND GPL-2.0-or-later + license_family: GPL + run_exports: + strong: + - __glibc >=2.28,<3.0.a0 + size: 24008591 + timestamp: 1765578833462 +- conda: https://conda.anaconda.org/conda-forge/noarch/tzdata-2026e-h5d301ff_0.conda + sha256: 2b7ca858879f183ce2dcc65b300f48a0133d5430550f35b23d80d405a0788dbf + md5: abccc3810d2b97e570dee487f2b46e38 + license: LicenseRef-Public-Domain + run_exports: {} + size: 119208 + timestamp: 1792758382821 +- conda: https://conda.anaconda.org/conda-forge/noarch/urllib3-2.8.0-pyh5ded981_1.conda + sha256: f892d267de12e031d887b90ea44718358f3558c052dfbac45b10b6cd4cee6705 + md5: 8ce0b6bfc873bf2c25b083dd5ee29489 + depends: + - python >=3.11 + - python + license: MIT + license_family: MIT + run_exports: {} + size: 113282 + timestamp: 1794575230703 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/astroid-4.3.4-py313h6ee819a_0.conda + sha256: 2fbc671a15170292020d2d12d2a9c0f98479639c4e34a82a1c7fbc19a8b22166 + md5: df0851b9d0c7dfda3acf6a1acc8396e8 + depends: + - python + - python_abi 3.13.* *_cp313 + license: LGPL-2.1-only + run_exports: {} + size: 576673 + timestamp: 1791464588433 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/bzip2-1.0.8-h4e30115_10.conda + sha256: 8ec22f0ba25cbfc2e64d70cf29459eccd7ffdf6436f6a6ff15bbfef799f7d4f6 + md5: b50612e7d190b8061ab4e7dc119cf4d5 + depends: + - __osx >=11.0 + license: bzip2-1.0.6 + license_family: BSD + run_exports: + weak: + - bzip2 >=1.0.8,<2.0a0 + size: 124965 + timestamp: 1785906749812 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/c-ares-1.34.9-h74c22ad_0.conda + sha256: 74b52d784b3576643da3aea1240a4120c1f25ee057f14ae5a89e8a7b3fb2e69f + md5: 84dac5da92970cdde9789fcbfe63cb3a + depends: + - __osx >=11.0 + license: MIT + license_family: MIT + run_exports: + weak: + - c-ares >=1.34.9,<2.0a0 + size: 201979 + timestamp: 1792507050139 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/cairo-1.18.6-h580cee5_0.conda + sha256: 32ad9b731d0b4c6dd82061201206164b07bd695bc695e5eb3addc0087ed54cca + md5: 0d25672f63cd1c9b08653a0becfbf31a + depends: + - __osx >=11.0 + - fontconfig >=2.18.3,<3.0a0 + - fonts-conda-ecosystem + - icu >=78.3,<79.0a0 + - libcxx >=21 + - libexpat >=2.8.1,<3.0a0 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - libglib >=2.90.0,<3.0a0 + - libpng >=1.6.58,<1.7.0a0 + - libzlib >=1.3.2,<2.0a0 + - pixman >=0.46.4,<1.0a0 + license: LGPL-2.1-only or MPL-1.1 + run_exports: + weak: + - cairo >=1.18.6,<2.0a0 + size: 844614 + timestamp: 1790045326889 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/curl-8.23.0-h6651222_0.conda + sha256: c9628a012fba18552ef02a8a2b46db48153d10b9209c57bdec0a33afcdc508a5 + md5: de96eb952f8c91d2b5161eb55f9a24f0 + depends: + - __osx >=11.0 + - krb5 >=1.22.2,<1.23.0a0 + - libcurl 8.23.0 h6651222_0 + - libpsl >=0.23.1,<0.24.0a0 + - libssh2 >=1.11.1,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + - openssl >=3.5.9,<4.0a0 + - zstd >=1.5.7,<1.6.0a0 + license: curl + license_family: MIT + run_exports: {} + size: 183387 + timestamp: 1792014031633 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/dbus-1.16.2-hf049998_2.conda + sha256: 60e265d5ac83198f1d13a43ab5cd2de097b10b460a5ad0764ed62af875b4ecdc + md5: a199888312b83a5c5e2d2880919eb1f2 + depends: + - __osx >=11.0 + - libcxx >=21 + - libglib >=2.88.3,<3.0a0 + - libexpat >=2.8.1,<3.0a0 + - libzlib >=1.3.2,<2.0a0 + license: AFL-2.1 OR GPL-2.0-or-later + run_exports: + weak: + - dbus >=1.16.2,<2.0a0 + size: 398252 + timestamp: 1788197996006 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/emacs-30.2-ha2f6bed_6.conda + sha256: 4b31cfee001921ffa2342d85c6e19f45b9c4de984a1ff35c892c7ad0cd08c723 + md5: 5615ed71fb7ccbfe82475d322d6213b8 + depends: + - dbus + - __osx >=11.0 + - gnutls >=3.8.11,<3.9.0a0 + - libtree-sitter >=0.25.9,<0.26.0a0 + - libsqlite >=3.53.4,<4.0a0 + - libwebp-base >=1.6.0,<2.0a0 + - libjpeg-turbo >=3.2.0,<4.0a0 + - gmp >=6.3.0,<7.0a0 + - ncurses >=6.6,<7.0a0 + - librsvg >=2.62.3,<3.0a0 + - libzlib >=1.3.2,<2.0a0 + - libxml2 + - libxml2-16 >=2.14.6 + - libpng >=1.6.58,<1.7.0a0 + - libtiff >=4.7.2,<4.8.0a0 + - gdk-pixbuf >=2.44.8,<3.0a0 + - dbus >=1.16.2,<2.0a0 + - giflib >=6.1.3,<6.2.0a0 + - libglib >=2.88.3,<3.0a0 + - libexpat >=2.8.1,<3.0a0 + license: GPL-3.0-only + license_family: GPL + run_exports: {} + size: 53125036 + timestamp: 1786884731551 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/fontconfig-2.18.3-h81aa574_1.conda + sha256: 004570d35fb0eff73ce3ae49b209a47622d0c2e580dd0dc4c61d59626b386a09 + md5: 8ac8cc3fe744b484de4387703134d8b2 + depends: + - __osx >=11.0 + - libexpat >=2.8.1,<3.0a0 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - libintl >=0.25.1,<1.0a0 + - libzlib >=1.3.2,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - fontconfig >=2.18.3,<3.0a0 + - fonts-conda-ecosystem + size: 265659 + timestamp: 1786667932256 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/freetype-2.14.3-hce30654_2.conda + sha256: 90681f1d0658cb2fd49a074f644eb4774272499290487a4bebb1c4df01d6997b + md5: 2f4cc7dc2e6622591735c49dda1b92aa + depends: + - libfreetype 2.14.3 hce30654_2 + - libfreetype6 2.14.3 h2ed5691_2 + license: GPL-2.0-only OR FTL + run_exports: + weak: + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + size: 175388 + timestamp: 1786641016583 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/fribidi-1.0.18-hb001647_0.conda + sha256: 0eb7cf0378cfd45c4729e2eedd896bc1fab01872d1ed204d6ea8bbf853a0138d + md5: 08fef45968356b6a9093c19f05d2364e + depends: + - __osx >=11.0 + license: LGPL-2.1-or-later + run_exports: + weak: + - fribidi >=1.0.18,<2.0a0 + size: 64404 + timestamp: 1793323489033 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/gdk-pixbuf-2.44.8-h5867e2c_2.conda + sha256: 96dcac22eaea2f24b9c92e8be078c3e39058829aa4db2a8103c1a4e85f8925ed + md5: 3a84786e0c929f4a05d08c07be5ec9b3 + depends: + - __osx >=11.0 + - libglib >=2.88.3,<3.0a0 + - libintl >=0.25.1,<1.0a0 + - libjpeg-turbo >=3.2.0,<4.0a0 + - liblzma >=5.8.3,<6.0a0 + - libpng >=1.6.58,<1.7.0a0 + - libtiff >=4.7.2,<4.8.0a0 + license: LGPL-2.1-or-later + license_family: LGPL + run_exports: + weak: + - gdk-pixbuf >=2.44.8,<3.0a0 + size: 552802 + timestamp: 1788490405006 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/giflib-6.1.3-h74c22ad_2.conda + sha256: 36a1605ea258ea805fd5a0f23f07ce3febcf4ac041d1ea99d0b31902b79f4358 + md5: edc562dcbe5872664817e64575aa325f + depends: + - __osx >=11.0 + license: MIT + license_family: MIT + run_exports: + weak: + - giflib >=6.1.3,<6.2.0a0 + size: 82055 + timestamp: 1788948759889 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/gmp-6.3.0-hf5e55b1_3.conda + sha256: 980cb1bbc3656d6f923d44297a2c4ab75f20482b8930c70537fd7f1ef2378894 + md5: bbfa5bd261b68536ddcda39e03d3407f + depends: + - libcxx >=19 + - __osx >=11.0 + license: GPL-2.0-or-later OR LGPL-3.0-or-later + run_exports: + weak: + - gmp >=6.3.0,<7.0a0 + size: 399307 + timestamp: 1786629210135 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/gnutls-3.8.13-hfe86254_0.conda + sha256: d36222db9e35788af78b6f41f66dc702d20b18375a9059c81ee074ea4c63d72a + md5: 9fafe1b7ed7d1264dc032e55227e2529 + depends: + - __osx >=11.0 + - gmp >=6.3.0,<7.0a0 + - libasprintf >=0.25.1,<1.0a0 + - libcxx >=19 + - libgettextpo >=0.25.1,<1.0a0 + - libidn2 >=2,<3.0a0 + - libintl >=0.25.1,<1.0a0 + - libtasn1 >=4.21.0,<5.0a0 + - nettle >=3.10.1,<3.11.0a0 + - p11-kit >=0.26.2,<0.27.0a0 + license: LGPL-2.1-or-later + license_family: LGPL + run_exports: + weak: + - gnutls >=3.8.13,<3.9.0a0 + size: 1906035 + timestamp: 1778045117683 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/graphite2-1.3.15-h784d473_1.conda + sha256: 471f34a187fdb4f2df33e26f2e471b16c239a5b277903f643d9c3a8c9a9f44ec + md5: 0c7b78d9ffff4f5a6ca28d346f734d8f + depends: + - libcxx >=19 + - __osx >=11.0 + license: LGPL-2.0-or-later + license_family: LGPL + run_exports: + weak: + - graphite2 >=1.3.15,<2.0a0 + size: 86493 + timestamp: 1786118637573 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/icu-78.3-py310h579977c_2.conda + sha256: 6cdb5dee54c72e56ab189fb3ad33cb28533553d42590e7e831160248f4416a43 + md5: a5efc0b42bb8b42e97d0a29ae3e3c187 + depends: + - __osx >=11.0 + license: MIT + license_family: MIT + run_exports: + weak: + - icu >=78.3,<79.0a0 + size: 14070242 + timestamp: 1786545847761 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/krb5-1.22.2-h34f8a20_2.conda + sha256: aaea1d42b07769920db2af7471ece9399d2613448863da64ad8272998db5db34 + md5: 15235dd10450d67bc25ccafd5b46d2bc + depends: + - __osx >=11.0 + - libcxx >=21 + - libedit >=3.1.20250104,<3.2.0a0 + - libedit >=3.1.20250104,<4.0a0 + - openssl >=3.5.7,<4.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - krb5 >=1.22.2,<1.23.0a0 + size: 1165740 + timestamp: 1786762145768 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/lerc-4.3.0-h0699d0c_0.conda + sha256: 93b1189cf3e47b93fe613dc08213cf22b892650097e8df77519e50f9301e9f62 + md5: b0a537a2f2650404b5fe49f46db50c9d + depends: + - __osx >=11.0 + - libcxx >=21 + license: Apache-2.0 + license_family: Apache + run_exports: + weak: + - lerc >=4.3.0,<5.0a0 + size: 188293 + timestamp: 1793411290334 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libasprintf-0.25.1-hae62183_2.conda + sha256: af6e0e598ace7cdac145daec66c39916016ebcd4d960246b5e90c4247e47be52 + md5: fa3b4ff4b5cbde3a77824949f5d0b1ef + depends: + - __osx >=11.0 + - libcxx >=21 + license: LGPL-2.1-or-later + run_exports: + weak: + - libasprintf >=0.25.1,<1.0a0 + size: 52487 + timestamp: 1790118662123 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libclang-cpp22.1-22.1.8-default_h79071a4_11.conda + sha256: f5e3e35d9a855636a09cd872ea16e195bdd32171ecee295a417f1b7ac2c50a6b + md5: 1eae4048550ca47885ed2bdf6b139aa4 + depends: + - libcxx >=22.1.8 + - __osx >=11.0 + - libzlib >=1.3.2,<2.0a0 + - zstd >=1.5.7,<1.6.0a0 + - libxml2 + - libxml2-16 >=2.15.4 + - libllvm22 >=22.1.8,<22.2.0a0 + license: Apache-2.0 WITH LLVM-exception + license_family: APACHE + run_exports: + weak: + - libclang-cpp22.1 >=22.1.8,<22.2.0a0 + size: 15941660 + timestamp: 1791933888154 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libcurl-8.23.0-h6651222_0.conda + sha256: d9f60525b665e50da15c84fcb4e74e6b1f0a56ea4c89a02d4258f23c3fe1f02c + md5: b955db4c41b9820eba0aa2c9a3c74a37 + depends: + - __osx >=11.0 + - krb5 >=1.22.2,<1.23.0a0 + - libnghttp2 >=1.68.1,<2.0a0 + - libpsl >=0.23.1,<0.24.0a0 + - libssh2 >=1.11.1,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + - openssl >=3.5.9,<4.0a0 + - zstd >=1.5.7,<1.6.0a0 + license: curl + license_family: MIT + run_exports: + weak: + - libcurl >=8.23.0,<9.0a0 + size: 425637 + timestamp: 1792014025908 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libcxx-22.1.8-h55c6f16_0.conda + sha256: a2e7abab5add9750fab064c024394de48e49f97631c605ad5db5c8ac3fc769ef + md5: 89f76a2a21a3ec3ec983b5eb237c4113 + depends: + - __osx >=11.0 + license: Apache-2.0 WITH LLVM-exception + license_family: Apache + run_exports: {} + size: 569349 + timestamp: 1781670209146 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libdeflate-1.26-h72bfca4_0.conda + sha256: f9c75ef67dbcc8e3c255d37e32948550bc8aa6752102c181686630b9ede96b8d + md5: 3f49c4c4ebcdb9fa285e5c73441063c1 + depends: + - __osx >=11.0 + license: MIT + license_family: MIT + run_exports: + weak: + - libdeflate >=1.26,<1.27.0a0 + size: 55312 + timestamp: 1787442891411 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libedit-3.1.20260512-pl5321h26f1114_0.conda + sha256: 5692a969e49b200c7874d1e869d281753361980b2ecfe9191b571d7e550f8b92 + md5: ef2ab2462744ec6ba3a54c34dcc6a06e + depends: + - ncurses + - __osx >=11.0 + - ncurses >=6.6,<7.0a0 + license: BSD-2-Clause + license_family: BSD + run_exports: + weak: + - libedit >=3.1.20260512,<3.2.0a0 + size: 108512 + timestamp: 1791327440683 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libev-4.33-h1a92334_3.conda + sha256: c0100064506ae8abb432c5a506d474f10af2cf48c33d62bc221fb28b6d6ff6ac + md5: 19e86c8a6a47e92bb2e70ca12e758c5c + depends: + - __osx >=11.0 + license: BSD-2-Clause OR GPL-2.0-or-later + license_family: GPL + run_exports: + weak: + - libev >=4.33,<4.34.0a0 + size: 39991 + timestamp: 1785917376956 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libexpat-2.9.0-h6111c0a_0.conda + sha256: b155c524118f751ad8b1c823397bab8b7f715f7e3ca10479925867a7e23e7e9d + md5: f85a1fda9a2758a7aef2a7787d9c0203 + depends: + - __osx >=11.0 + constrains: + - expat 2.9.0.* + license: MIT + license_family: MIT + run_exports: {} + size: 69681 + timestamp: 1793054210049 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libffi-3.7.0-h47dc5ef_1.conda + sha256: 2783389a7b9dda04c62cc54c6bbeb03dd3cef24b3fc642715d02a3fa19464a9a + md5: 216bbcc23c11e9695b3db4a8771d76eb + depends: + - __osx >=11.0 + license: MIT + license_family: MIT + run_exports: + weak: + - libffi >=3.7.0,<3.8.0a0 + size: 43637 + timestamp: 1787753403688 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libfreetype-2.14.3-hce30654_2.conda + sha256: 19ce8bd320414cb6b9889ecbf48a3ded848b0d1068b76ff6bea099bd7387d6f3 + md5: ee1fc5bba400ff0cae27fbf141a1ae0c + depends: + - libfreetype6 >=2.14.3 + license: GPL-2.0-only OR FTL + run_exports: {} + size: 8367 + timestamp: 1786641013393 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libfreetype6-2.14.3-h2ed5691_2.conda + sha256: d9b203d6484ad491b5b5f33d49a9d7a91189d776a9adae53d2b63af18ec11e6a + md5: 881cfb44ea02cc9849f612725a959660 + depends: + - __osx >=11.0 + - libpng >=1.6.58,<1.7.0a0 + - libzlib >=1.3.2,<2.0a0 + constrains: + - freetype >=2.14.3 + license: GPL-2.0-only OR FTL + run_exports: {} + size: 340923 + timestamp: 1786641012794 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libgettextpo-0.25.1-hae62183_2.conda + sha256: ea81b8992214e8c4cd289ba4b9092004aa941ddb12900a32cfbc28be6d3156ff + md5: 93e3f213a8e3fa21fb7b1407d6a4cd44 + depends: + - __osx >=11.0 + - libiconv >=1.18,<2.0a0 + - libintl 0.25.1 hae62183_2 + license: GPL-3.0-or-later + license_family: GPL + run_exports: + weak: + - libgettextpo >=0.25.1,<1.0a0 + size: 182332 + timestamp: 1790118703147 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libglib-2.90.0-hccd281b_0.conda + sha256: 4ec64c476881b31f211842952f192208a3af0925a596da227f4d97fb9a63e0ac + md5: 8f63a5f35547d0c6d819830ebe0d3245 + depends: + - __osx >=11.0 + - libintl >=0.25.1,<1.0a0 + - libzlib >=1.3.2,<2.0a0 + - libffi >=3.7.0,<3.8.0a0 + - libiconv >=1.18,<2.0a0 + - pcre2 >=10.47,<10.48.0a0 + constrains: + - glib >2.66 + license: LGPL-2.1-or-later + run_exports: + weak: + - libglib >=2.90.0,<3.0a0 + size: 4489939 + timestamp: 1789478088421 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libharfbuzz-15.0.0-hcda0f7c_0.conda + sha256: 1cf7900cfd17b60a8e3f76a31ca95140deca4781899e290b499b6caad82058b2 + md5: 2bf1803b0f15fa26d9f22ce8364d16df + depends: + - __osx >=11.0 + - cairo >=1.18.6,<2.0a0 + - graphite2 >=1.3.15,<2.0a0 + - icu >=78.3,<79.0a0 + - libcxx >=21 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - libglib >=2.90.0,<3.0a0 + - libpng >=1.6.59,<1.7.0a0 + - libzlib >=1.3.2,<2.0a0 + license: MIT + license_family: MIT + run_exports: {} + size: 1146987 + timestamp: 1792769126357 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libharfbuzz-devel-15.0.0-hcda0f7c_0.conda + sha256: 764b95c1630e66f7eebca2f75ab3dd2cb039aa1d007d00c763e122cd29564a8a + md5: 14a65f11238f07714323d65bc2c9034f + depends: + - __osx >=11.0 + - cairo >=1.18.6,<2.0a0 + - freetype + - graphite2 >=1.3.15,<2.0a0 + - icu >=78.3,<79.0a0 + - libcxx >=21 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - libglib >=2.90.0,<3.0a0 + - libharfbuzz 15.0.0 hcda0f7c_0 + - libpng >=1.6.59,<1.7.0a0 + - libzlib >=1.3.2,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - libharfbuzz >=15.0.0 + size: 1673578 + timestamp: 1792769143858 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libiconv-1.18-he4c29f2_3.conda + sha256: 689a14968267f2f97c07112fca5636e7d756036b9aee969911267c20bd3eea1f + md5: 17f4744c0873e9f77ac9b5cd0a27c187 + depends: + - __osx >=11.0 + license: LGPL-2.1-only + run_exports: + weak: + - libiconv >=1.18,<2.0a0 + size: 750816 + timestamp: 1787033961086 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libidn2-2.3.8-ha90df94_1.conda + sha256: 6d9d2db2c8a645f63073553e9497ea266507c940de42800f2f0faddbf00149cd + md5: d4b2e2dd2a1a1e2df8b4a3f05034beb4 + depends: + - __osx >=11.0 + - libintl >=0.25.1,<1.0a0 + - libunistring >=0,<1.0a0 + license: LGPL-2.0-only + license_family: LGPL + run_exports: + weak: + - libidn2 >=2,<3.0a0 + size: 145706 + timestamp: 1760385907428 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libintl-0.25.1-hae62183_2.conda + sha256: b43c6645e668f86d04d5c06d6dc17efe921bbd9244be4b77946d56fb950a3fcc + md5: a3a4193101bc5427e6cf8be81d5eeddf + depends: + - __osx >=11.0 + - libiconv >=1.18,<2.0a0 + license: LGPL-2.1-or-later + run_exports: + weak: + - libintl >=0.25.1,<1.0a0 + size: 90024 + timestamp: 1790118675563 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libjpeg-turbo-3.2.1-hb001647_0.conda + sha256: 957469c69b3b9c9e6ae48dc1267c5c9dfe0db9e1aefa5fa9abf9798224aa23c9 + md5: d420b10837f3b64259b1febf263b5f7a + depends: + - __osx >=11.0 + constrains: + - jpeg <0.0.0a + license: IJG AND BSD-3-Clause AND Zlib + run_exports: + weak: + - libjpeg-turbo >=3.2.1,<4.0a0 + size: 555606 + timestamp: 1793156969006 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libllvm22-22.1.8-h759d1ac_3.conda + sha256: 70d7bbba65233fec41fb2294e81351d81b8d7e21206113135604fed4dd7fdcf6 + md5: 3b912a5fea164495d16d3edc64242f3a + depends: + - __osx >=11.0 + - libcxx >=21 + - libxml2 + - libxml2-16 >=2.15.4 + - libzlib >=1.3.2,<2.0a0 + - zstd >=1.5.7,<1.6.0a0 + license: Apache-2.0 WITH LLVM-exception + license_family: Apache + run_exports: + weak: + - libllvm22 >=22.1.8,<22.2.0a0 + size: 30242555 + timestamp: 1790103714094 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/liblzma-5.8.3-h8088a28_1.conda + sha256: 23d0630046a3e8b164d8f80f2b74ed2605af2e7050ab9913018056402fae4311 + md5: 8ab10323068b107661a4b9a4af84f3b5 + depends: + - __osx >=11.0 + constrains: + - xz 5.8.3.* + license: 0BSD + run_exports: + weak: + - liblzma >=5.8.3,<6.0a0 + size: 91720 + timestamp: 1786348695846 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libmpdec-4.0.0-h84a0fba_2.conda + sha256: 04cc136c5a956a73aa14e0a160b5822b0b29714e67b299fa1b1fd16dbcba5366 + md5: ff33a4dbd93abc8a798cc4e0e7c8136d + depends: + - __osx >=11.0 + license: BSD-2-Clause + license_family: BSD + run_exports: {} + size: 73289 + timestamp: 1786651074391 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libnghttp2-1.71.0-h29223de_0.conda + sha256: d533256cdb91c676b106728e8437a5d96e9c02dc6a99b948f1b04b04a92620c2 + md5: a8f77fc66cd70f2c883764a318fa2f26 + depends: + - libev >=4.33,<5.0a0 + - __osx >=11.0 + - libcxx >=21 + - c-ares >=1.34.9,<2.0a0 + - libev >=4.33,<4.34.0a0 + - openssl >=3.5.9,<4.0a0 + - libzlib >=1.3.2,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - libnghttp2 >=1.71.0,<2.0a0 + size: 671516 + timestamp: 1793628217888 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libpango-1.58.2-hc2ac4f2_3.conda + sha256: 90118019ce64d713888abbe41a15be9e5885bdc8d5d4f84480e615299d2b5a01 + md5: 1261a045589c8d98219cbd258b71ea95 + depends: + - __osx >=11.0 + - fribidi >=1.0.17,<2.0a0 + - libglib >=2.90.0,<3.0a0 + - libharfbuzz >=14.6.0 + - cairo >=1.18.6,<2.0a0 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - fontconfig >=2.18.3,<3.0a0 + - fonts-conda-ecosystem + license: LGPL-2.1-or-later + run_exports: {} + size: 308102 + timestamp: 1792050658787 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libpango-devel-1.58.2-haa2d88b_3.conda + sha256: 2434b8c792ce63ba089da94a21acb25ec45430a053d5cbe537d18f18771b27a7 + md5: 4bac42499647d2567ef309b6193d63f6 + depends: + - libpango ==1.58.2 hc2ac4f2_3 + - freetype + - libharfbuzz-devel + - __osx >=11.0 + - fribidi >=1.0.17,<2.0a0 + - libglib >=2.90.0,<3.0a0 + - libharfbuzz >=14.6.0 + - cairo >=1.18.6,<2.0a0 + - libfreetype >=2.14.3 + - libfreetype6 >=2.14.3 + - fontconfig >=2.18.3,<3.0a0 + - fonts-conda-ecosystem + license: LGPL-2.1-or-later + run_exports: + weak: + - libpango >=1.58.2,<2.0a0 + size: 213942 + timestamp: 1792050658787 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libpng-1.6.59-hf5e6511_0.conda + sha256: 4de4dc4cb7432c328c1eaf4f7cc9c6b48c073eab1e9c6723d4533e6d57e7d595 + md5: 4f99571d5354c39f2621b8b6e3a9afa3 + depends: + - __osx >=11.0 + - libzlib >=1.3.2,<2.0a0 + license: zlib-acknowledgement + run_exports: + weak: + - libpng >=1.6.59,<1.7.0a0 + size: 290299 + timestamp: 1790805167385 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libpsl-0.23.1-hdb0c161_1.conda + sha256: c8c3153df39abedf3413483f672151ad70f1adb0c06c192bdf7ec432c3616b07 + md5: 5d270f716a2b4bc13df9af8612071b17 + depends: + - __osx >=11.0 + - libcxx >=21 + - icu >=78.3,<79.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - libpsl >=0.23.1,<0.24.0a0 + size: 72673 + timestamp: 1786970928205 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libpython-3.13.18-h0af5753_100_cp313.conda + build_number: 100 + sha256: 2ccf200438a519589d86acb96c75822f7ba6f6a9e654d1da355521cec4adfac3 + md5: 57bd17817c81cfe8d491e328dcb59a43 + depends: + - __osx >=11.0 + license: Python-2.0 + run_exports: + weak: + - libpython >=3.13,<4.0a0 + size: 1823071 + timestamp: 1793014722078 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/librsvg-2.62.4-hc8ac265_0.conda + sha256: 3bd54de0136907782249a0d5797744ecac5bbd77026f5f2712dd62390c5c9f77 + md5: 878c79beee628e3b683ddc9094aaad1e + depends: + - __osx >=11.0 + - pango >=1.58.2,<2.0a0 + - libglib >=2.90.0,<3.0a0 + - fontconfig >=2.18.3,<3.0a0 + - fonts-conda-ecosystem + - libxml2-16 >=2.15.4 + - gdk-pixbuf >=2.44.8,<3.0a0 + - libharfbuzz >=14.5.0 + - cairo >=1.18.6,<2.0a0 + constrains: + - __osx >=11.0 + license: LGPL-2.1-or-later + run_exports: + weak: + - librsvg >=2.62.4,<3.0a0 + size: 3888310 + timestamp: 1790276358897 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libsqlite-3.54.1-hca69786_0.conda + sha256: 998cd122027b2523f2f25807b1d476b82a168489d16b1430fd848a9a6b606a80 + md5: b3fc67af56dfdf7c9ee7d8fdae21f654 + depends: + - __osx >=11.0 + - icu >=78.3,<79.0a0 + - libzlib >=1.3.2,<2.0a0 + license: blessing + run_exports: + weak: + - libsqlite >=3.54.1,<4.0a0 + size: 953427 + timestamp: 1792175622950 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libssh2-1.11.1-hbf2880b_1.conda + sha256: a056e518c3d2d09fbb1778cea80c0c95338fb24adf1a817bbf90fb484850a304 + md5: d957a8eda98c49b073e8dcfd677c127a + depends: + - libzlib >=1.3.2,<2.0a0 + - openssl >=3.5.7,<4.0a0 + license: BSD-3-Clause + license_family: BSD + run_exports: + weak: + - libssh2 >=1.11.1,<2.0a0 + size: 280492 + timestamp: 1786714226814 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libtasn1-4.21.0-hb001647_1.conda + sha256: a18d0abb7414e4caba4043c3b9e7f981b62b016ed6f203437d7232b175ba2e67 + md5: c298706579b4d8ac9af0df9557fdebae + depends: + - __osx >=11.0 + license: LGPL-2.1-or-later + run_exports: + weak: + - libtasn1 >=4.21.0,<5.0a0 + size: 117547 + timestamp: 1793068747771 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libtiff-4.7.2-h87d37ca_2.conda + sha256: 3c1cf481a60ed8598093641b3a41ee1a7bb78413029ec566a238927504e941bd + md5: ac0e529ed6020472c12f740602e58ab5 + depends: + - __osx >=11.0 + - lerc >=4.3.0,<5.0a0 + - libcxx >=21 + - libdeflate >=1.26,<1.27.0a0 + - libjpeg-turbo >=3.2.1,<4.0a0 + - liblzma >=5.8.3,<6.0a0 + - libwebp-base >=1.6.0,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + - zstd >=1.5.7,<1.6.0a0 + license: HPND + run_exports: + weak: + - libtiff >=4.7.2,<4.8.0a0 + size: 380333 + timestamp: 1794045696512 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libtree-sitter-0.25.9-he530434_0.conda + sha256: 439049f9222d51c0747d004a324cf97dc66138eff9f449627007f7acd4fad971 + md5: 805b557db147781ba60665802414d3e8 + depends: + - __osx >=11.0 + license: MIT + license_family: MIT + run_exports: + weak: + - libtree-sitter >=0.25.9,<0.26.0a0 + size: 207080 + timestamp: 1757201895620 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libunistring-0.9.10-h3422bc3_0.tar.bz2 + sha256: a1afe12ab199f82f339eae83405d293d197f2485d45346a709703bc7e8299949 + md5: d88e77a4861e20bd96bde6628ee7a5ae + license: GPL-3.0-only OR LGPL-3.0-only + run_exports: + weak: + - libunistring >=0,<1.0a0 + size: 1577561 + timestamp: 1626955172521 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libwebp-base-1.6.0-h202fb40_1.conda + sha256: 0ff54650d470c7e54cbeffdd53a8c063e055a7bcf784388c0385ce5c4741b0f4 + md5: 168a13e329259710b28277abc1395b8e + depends: + - __osx >=11.0 + constrains: + - libwebp 1.6.0 + license: BSD-3-Clause + license_family: BSD + run_exports: + weak: + - libwebp-base >=1.6.0,<2.0a0 + size: 294522 + timestamp: 1785955350410 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libxml2-16-2.15.4-heb56d2d_1.conda + sha256: 1acd4dd49c6f54440dc172ab469d0e2c7c3c02de5b1f21158a233eb585ec3c38 + md5: ef82ce9c5e6a0bb8bc9cb0e6935f18ca + depends: + - __osx >=11.0 + - icu >=78.3,<79.0a0 + - libiconv >=1.18,<2.0a0 + - liblzma >=5.8.3,<6.0a0 + - libzlib >=1.3.2,<2.0a0 + constrains: + - libxml2 2.15.4 + license: MIT + license_family: MIT + run_exports: {} + size: 469239 + timestamp: 1791465646245 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libxml2-2.15.4-h550178d_1.conda + sha256: f333b4c6c823ea317aeb0b817520ae3ba2fb16277923d848f5f2aee2049198e5 + md5: 5881b9ab679553078d590db82d7e57b3 + depends: + - __osx >=11.0 + - icu >=78.3,<79.0a0 + - libiconv >=1.18,<2.0a0 + - liblzma >=5.8.3,<6.0a0 + - libxml2-16 2.15.4 heb56d2d_1 + - libzlib >=1.3.2,<2.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - libxml2 + - libxml2-16 >=2.15.4 + size: 41382 + timestamp: 1791465651969 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/libzlib-1.3.2-h8088a28_3.conda + sha256: a18fa5d5bac452401459f966cf0d872224e8080c4ff93c77e168d43ab42ef9d7 + md5: f39288f0ea63ae962e1a2e4f355a0d75 + depends: + - __osx >=11.0 + constrains: + - zlib 1.3.2 *_3 + license: Zlib + license_family: Other + run_exports: + weak: + - libzlib >=1.3.2,<2.0a0 + size: 47822 + timestamp: 1785277049190 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/lychee-0.24.2-h9d00c72_1.conda + sha256: 9c35bbfe243d26c07a21375cfb863f376991e4dd6de3d6bfb147569c60d65cf0 + md5: 1ec074eabe183deb5a7e65fb9e776c3e + depends: + - __osx >=11.0 + constrains: + - __osx >=11.0 + license: Apache-2.0 OR MIT + run_exports: {} + size: 5351911 + timestamp: 1791278249049 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/markupsafe-3.0.4-py313h0984dbd_5.conda + sha256: c996dadcd7c6f0df9ade4e019cf0858761039a62c9dde312475e0822468af8d9 + md5: 4a83df2cb081468887b1ba02de0736a2 + depends: + - python + - __osx >=11.0 + - python_abi 3.13.* *_cp313 + constrains: + - jinja2 >=3.0.0 + license: BSD-3-Clause + run_exports: {} + size: 28227 + timestamp: 1794823823453 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/ncurses-6.6-he64c551_1.conda + sha256: 7024a48c8c0d0114ed4ab53c76bf9275d50e91ba7cea367a9aead638d3c29c68 + md5: 3dfa0d0316dc246cd44937a557de4501 + depends: + - __osx >=11.0 + license: X11 AND BSD-3-Clause + run_exports: + weak: + - ncurses >=6.6,<7.0a0 + size: 804298 + timestamp: 1786355189145 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/nettle-3.10.1-hfc803ee_1.conda + sha256: f57e68f8e7e3197340fa6edc6cc66afd6015f1dc52850a7c2ab20cec66b766d0 + md5: b0229aa5ed12f2d0f33ac3e88a63e1db + depends: + - __osx >=11.0 + - gmp >=6.3.0,<7.0a0 + license: GPL-2.0-or-later OR LGPL-3.0-or-later + run_exports: + weak: + - nettle >=3.10.1,<3.11.0a0 + size: 456749 + timestamp: 1787065337321 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/openssl-3.6.5-h55eecbc_0.conda + sha256: 44fbc526456571a9fb8fa18157f6f269d4d4bd40eef20183a93b9c9296f94497 + md5: 45d9179cdf6e53d88aec034246f0dad6 + depends: + - __osx >=11.0 + - ca-certificates + license: Apache-2.0 + license_family: Apache + run_exports: + weak: + - openssl >=3.6.5,<4.0a0 + size: 3111573 + timestamp: 1791097959641 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/p11-kit-0.26.5-h329a732_2.conda + sha256: ba17447c428db9e0a7c74067e30ef7c9aab29835d69676dad3076e62ae9f8763 + md5: b6dc8c0520f47b73a42dec38794bad8c + depends: + - __osx >=11.0 + - libffi >=3.7.0,<3.8.0a0 + - libtasn1 >=4.21.0,<5.0a0 + license: MIT + license_family: MIT + run_exports: + weak: + - p11-kit >=0.26.5,<0.27.0a0 + size: 800354 + timestamp: 1788196674456 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/pango-1.58.2-hc6efcc1_3.conda + sha256: 4206a8d179dbc2ae070d7c5ed148b73ccf5ec8a962f428e2645527bad9c016de + md5: 17bb0626b5ac18be2c28e65b6d949e3a + depends: + - libpango-devel ==1.58.2 haa2d88b_3 + license: LGPL-2.1-or-later + run_exports: + weak: + - libpango >=1.58.2,<2.0a0 + size: 15035 + timestamp: 1792050658787 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/pcre2-10.47-he63d830_1.conda + sha256: f8c415329b542e1fca1ff2917b80e687c18302dfa0353530668b90cb225b494f + md5: 5ab90033816cbe4097e8a297e5179f67 + depends: + - __osx >=11.0 + - bzip2 >=1.0.8,<2.0a0 + - libzlib >=1.3.2,<2.0a0 + license: BSD-3-Clause + license_family: BSD + run_exports: + weak: + - pcre2 >=10.47,<10.48.0a0 + size: 851704 + timestamp: 1787294559157 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/pixman-0.46.4-h784d473_3.conda + sha256: 4779cd57231ce2e96fac643fcbdd4a6f51a57986264545445574e9c4acf526d3 + md5: 9a99c0b60efe41c194d01c182d000733 + depends: + - __osx >=11.0 + - libcxx >=19 + license: MIT + license_family: MIT + run_exports: + weak: + - pixman >=0.46.4,<1.0a0 + size: 198717 + timestamp: 1786106922508 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/python-3.13.18-hb59dee6_100_cp313.conda + build_number: 100 + sha256: ca7809f986ebd644a418bd52e3bfa1ece8979441917c08e47d341b9e818c652b + md5: fe33fb185e1b63c33394512bccf8807f + depends: + - __osx >=11.0 + - bzip2 >=1.0.8,<2.0a0 + - libexpat >=2.8.5,<3.0a0 + - libffi >=3.7.0,<3.8.0a0 + - liblzma >=5.8.3,<6.0a0 + - libmpdec >=4.0.0,<5.0a0 + - libpython 3.13.18 h0af5753_100_cp313 + - libsqlite >=3.54.1,<4.0a0 + - libzlib >=1.3.2,<2.0a0 + - ncurses >=6.6,<7.0a0 + - openssl >=3.5.9,<4.0a0 + - python_abi 3.13.* *_cp313 + - readline >=8.3,<9.0a0 + - tk >=8.6.13,<8.7.0a0 + - tzdata + license: Python-2.0 + run_exports: + weak: + - python_abi 3.13.* *_cp313 + noarch: + - python + size: 11971526 + timestamp: 1793014757271 + python_site_packages_path: lib/python3.13/site-packages +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/pyyaml-6.0.3-py313h5c85ca1_3.conda + sha256: a5c89aa6d093077b4569c5f33182c93ca7de4fe8536d2ce27a5bec6a407f0ecc + md5: bd7d78d5a001b042e7520cbd724b21a5 + depends: + - python + - yaml + - __osx >=11.0 + - python_abi 3.13.* *_cp313 + - yaml >=0.2.5,<0.3.0a0 + license: MIT + license_family: MIT + run_exports: {} + size: 204613 + timestamp: 1793655118128 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/readline-8.3-h8b90a29_1.conda + sha256: d6782b430e6dce4fe8c7ac118cd988d5a193eb4a7f60741edfaede58016b6110 + md5: 9347fd56a002e6b58946831d48fe62f6 + depends: + - __osx >=11.0 + - ncurses >=6.6,<7.0a0 + license: GPL-3.0-only + license_family: GPL + run_exports: + weak: + - readline >=8.3,<9.0a0 + size: 314395 + timestamp: 1787033878899 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/tk-8.6.13-hbeba79b_4.conda + sha256: 857d89087ae7f2c328cf256728affcb7343031a148b4af847334d248a9cf564c + md5: 90a01bf394d1c594e0eb9258f967d828 + depends: + - __osx >=11.0 + - libzlib >=1.3.2,<2.0a0 + license: TCL + run_exports: + weak: + - tk >=8.6.13,<8.7.0a0 + size: 3342183 + timestamp: 1787272852357 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/yaml-0.2.5-h74c22ad_3.conda + sha256: 3e78c43207502418fc5fb2317bbbefe5df8b6fc1051d90bdcd1c881c76bb4193 + md5: 31cf6dcc138abe673c9440cd6fe6c6fe + depends: + - __osx >=11.0 + license: MIT + license_family: MIT + run_exports: + weak: + - yaml >=0.2.5,<0.3.0a0 + size: 77530 + timestamp: 1787228556857 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/zig-0.17.1-0ccaba2_0.conda + sha256: b79e9a60a36a4001178fe43eb454e74d67266f5ff0828e5581e455e41d8634f7 + md5: 515c9a0205dc70ea68d556fd361a2c69 + depends: + - zig_osx-arm64 ==0.17.1 a676bd3_0 + - libcxx >=22 + license: MIT AND Apache-2.0 WITH LLVM-exception AND Apache-2.0 AND LGPL-2.1-or-later AND BSD-2-Clause AND BSD-3-Clause AND ZPL-2.1 AND LicenseRef-Public-Domain + run_exports: + weak: + - zig >=0.17.1,<0.17.2.0a0 + size: 229303 + timestamp: 1794496879060 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/zig_impl_osx-arm64-0.17.1-8405819_0.conda + sha256: a5cf38eef3105506af4a1488c5cee42e182e8c47bfa56228899cd30dc9c7ee1f + md5: aa771c478390ba34eb22842cdc320334 + depends: + - libcxx 22.* + - libcxx >=22 + - __osx >=11.0 + - libxml2 + - libxml2-16 >=2.15.4 + - zstd >=1.5.7,<1.6.0a0 + - libllvm22 >=22.1.8,<22.2.0a0 + - libzlib >=1.3.2,<2.0a0 + - libclang-cpp22.1 >=22.1.8,<22.2.0a0 + license: MIT AND Apache-2.0 WITH LLVM-exception AND Apache-2.0 AND LGPL-2.1-or-later AND BSD-2-Clause AND BSD-3-Clause AND ZPL-2.1 AND LicenseRef-Public-Domain + run_exports: {} + size: 76882981 + timestamp: 1794496879060 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/zig_osx-arm64-0.17.1-a676bd3_0.conda + sha256: f65739411083e5b9d486bf73af89f1f9dc49032b3135690fbd2dabd49e0bb672 + md5: 74a14e85555a80674578bfa6b77b93cf + depends: + - zig_impl_osx-arm64 ==0.17.1 8405819_0 + license: MIT AND Apache-2.0 WITH LLVM-exception AND Apache-2.0 AND LGPL-2.1-or-later AND BSD-2-Clause AND BSD-3-Clause AND ZPL-2.1 AND LicenseRef-Public-Domain + run_exports: + strong: + - libcxx >=22 + size: 335709 + timestamp: 1794496879060 +- conda: https://conda.anaconda.org/conda-forge/osx-arm64/zstd-1.5.7-hf451053_7.conda + sha256: da867f5092eb0cb746d353694f0098031fd9817a4ce7d5743121209ae0f406ca + md5: 4ec2684c73812cc2c3d78379384a39cc + depends: + - __osx >=11.0 + - libzlib >=1.3.2,<2.0a0 + license: BSD-3-Clause + license_family: BSD + run_exports: + weak: + - zstd >=1.5.7,<1.6.0a0 + size: 433687 + timestamp: 1786599629846 diff --git a/pixi.toml b/pixi.toml new file mode 100644 index 0000000..20bd64d --- /dev/null +++ b/pixi.toml @@ -0,0 +1,42 @@ +# The documentation toolchain, pinned by pixi.lock. `pixi run -e docs docbld` +# builds docs/build/html the way CI does; docs/orgmode/contributing.org has +# the steps. In a repository that already has a pixi.toml, copy the +# [feature.docs.*] tables and the docs environment into it. +[workspace] +name = "eb-keep-logs" +channels = ["conda-forge"] +platforms = ["linux-64", "osx-arm64"] + +[feature.docs.dependencies] +python = "3.13.*" +emacs = "30.*" +curl = "*" +lychee = "*" +zig = "0.17.1.*" +sphinx = "9.*" +myst-parser = "*" +shibuya = "*" +sphinx-copybutton = "*" +sphinx-design = "*" +sphinx-sitemap = "*" +sphinx-autoapi = "*" + +[feature.docs.tasks] +# Org pages to reStructuredText, docs/orgmode -> docs/source. +mkrst = { cmd = "emacs -Q --batch --load export.el", cwd = "docs" } +# API pages from the code, into docs/source/reference/api/. +mkapi = { cmd = "zig run docs/tools/zig_api.zig -- --module eb-keep-logs --root src/main.zig --out docs/source/reference/api/zig --source-url 'https://github.com/stackhands/eb-keep-logs/blob/{ref}/' --title 'Zig API' --follow-private-imports" } +sphinxbld = { cmd = "sphinx-build -W -n --keep-going -d docs/build/doctrees -b html docs/source docs/build/html", depends-on = ["mkrst", "mkapi"] } +# The Zig autodoc site, served beside the Sphinx pages at api/. +autodoc = { cmd = "zig build docs --prefix docs/build/autodoc && rm -rf docs/build/html/api && cp -r docs/build/autodoc/docs docs/build/html/api", depends-on = ["sphinxbld"] } +# Every internal link and anchor resolves, and no page names a site. The +# changelog may name what a release removed; its links are still checked. +doccheck = { cmd = "python docs/tools/check_site.py docs/build/html --sources docs/orgmode --exempt changelog.html", depends-on = ["autodoc"] } +docbld = { depends-on = ["doccheck"] } +# External links; needs the network, so CI runs it as its own step. +linkcheck = { cmd = "lychee --config lychee.toml --no-progress 'docs/build/html/**/*.html'" } +# Generated files are the ignored ones under docs/source (see .gitignore). +docdel = { cmd = "rm -rf docs/build && git clean -fdX docs/source" } + +[environments] +docs = { features = ["docs"], no-default-feature = true } From 3f15fdb91806c4936b705a0a1ace4d5bbbdf9093 Mon Sep 17 00:00:00 2001 From: Rohit Goswami Date: Mon, 16 Nov 2026 17:58:08 +0000 Subject: [PATCH 2/4] docs: a doc comment on every pub declaration The API pages and the autodoc show each declaration's doc comment, and its first sentence is the summary in the module's list. 11 of the 19 pub declarations had none, nor had five fields of localtime's Posix and Zone, so their entries were a bare name and a signature. Each now says what it is or does, with the units, limits and errors the code has. The comment at the top of src/localtime.zig said the zone is read the way glibc reads it. In two cases it is not: an empty TZDIR leaves a zone name relative to the working directory, where glibc takes it as unset, and a TZ with a leading ':' that names no file is UTC, where glibc reads the rule string after the ':'. The comment says so now. Only comments change: the release binary is the same file, byte for byte. --- changelog.d/+doc-comments.doc.md | 1 + src/localtime.zig | 52 +++++++++++++++++++++++++++----- src/main.zig | 6 ++++ 3 files changed, 52 insertions(+), 7 deletions(-) create mode 100644 changelog.d/+doc-comments.doc.md diff --git a/changelog.d/+doc-comments.doc.md b/changelog.d/+doc-comments.doc.md new file mode 100644 index 0000000..1d2e86c --- /dev/null +++ b/changelog.d/+doc-comments.doc.md @@ -0,0 +1 @@ +Every `pub` declaration has a doc comment, whose first sentence is the summary the API pages list, and the comment at the top of `src/localtime.zig` names the two cases in which the zone is read differently from glibc: an empty `TZDIR`, and a `TZ` with a leading `:` that names no file. diff --git a/src/localtime.zig b/src/localtime.zig index c7f14b1..145b539 100644 --- a/src/localtime.zig +++ b/src/localtime.zig @@ -1,12 +1,18 @@ //! Local time as the C library sees it, enough to turn a calendar date into //! the epoch second of its local midnight, as `date -d YYYYMMDD +%s` does. //! -//! The zone comes from TZ the way glibc reads it: unset means -//! /etc/localtime; empty means UTC; a leading ':' or any value naming a TZif -//! file under TZDIR (default /usr/share/zoneinfo) or an absolute path is -//! that file; anything else is a POSIX TZ rule string. A zone that cannot be -//! read or parsed is UTC. TZif files use their transitions, then the POSIX -//! rule in their footer for times after the last transition. +//! The zone comes from TZ much as glibc reads it: unset means +//! /etc/localtime; empty means UTC; otherwise the value, without a leading +//! ':', names a TZif file, under TZDIR (default /usr/share/zoneinfo) unless +//! it is an absolute path, and a value without a leading ':' that names no +//! file is a POSIX TZ rule string. A zone that cannot be read or parsed is +//! UTC. TZif files use their transitions, then the POSIX rule in their +//! footer for times after the last transition. +//! +//! Two cases differ from glibc, which takes an empty TZDIR as unset and +//! reads a rule string after a leading ':' too: here an empty TZDIR leaves a +//! zone name relative to the working directory, and a value with a leading +//! ':' that names no file is UTC. const std = @import("std"); const common = @import("zig_common"); const fsx = common.fsx; @@ -14,6 +20,8 @@ const sys = common.sys; const Allocator = std.mem.Allocator; +/// The day of the year on which a POSIX TZ rule starts or ends daylight +/// saving time: `Jn`, `n` or `Mm.w.d`. pub const Rule = union(enum) { /// Day of year 1..365, February 29 never counted. julian1: u16, @@ -23,9 +31,15 @@ pub const Rule = union(enum) { mwd: struct { m: u8, w: u8, d: u8 }, }; +/// A POSIX TZ rule string, such as `CET-1CEST,M3.5.0,M10.5.0/3`, as +/// `parsePosix` reads it. pub const Posix = struct { /// Seconds east of UTC. std_off: i32, + /// Daylight saving time, null when the zone has none: `off` in seconds + /// east of UTC, and the days it starts and ends with their times in + /// seconds from that day's local midnight, `start_time` in standard time + /// and `end_time` in daylight time. dst: ?struct { off: i32, start: Rule, @@ -35,14 +49,23 @@ pub const Posix = struct { } = null, }; +/// A time zone: the transitions of a TZif file and the POSIX rule after +/// them, or a POSIX rule alone. The default value is UTC. pub const Zone = struct { + /// UTC seconds at which the offset changes, in ascending order. transitions: []const i64 = &.{}, + /// Seconds east of UTC from the transition at the same index on. offsets: []const i32 = &.{}, /// Offset before the first transition. first_off: i32 = 0, + /// The rule from the last transition on, or for all times when there + /// are none; without it the last transition's offset stays in force. footer: ?Posix = null, + /// Holds what was read from a TZif file; `deinit` frees it. arena: ?std.heap.ArenaAllocator = null, + /// Free what was read from a TZif file; a zone without one holds + /// nothing to free. pub fn deinit(z: *Zone) void { if (z.arena) |*a| a.deinit(); } @@ -80,7 +103,9 @@ pub const Zone = struct { } }; -// Calendar arithmetic (Howard Hinnant's days_from_civil). +/// Days from 1970-01-01 to `y_in`-`m`-`d` in the proleptic Gregorian +/// calendar, negative before it (Howard Hinnant's days_from_civil). `m` is +/// 1..12; neither it nor `d` is checked. pub fn daysFromCivil(y_in: i64, m: u8, d: u8) i64 { const y = if (m <= 2) y_in - 1 else y_in; const era = @divFloor(y, 400); @@ -91,10 +116,12 @@ pub fn daysFromCivil(y_in: i64, m: u8, d: u8) i64 { return era * 146097 + doe - 719468; } +/// Whether `y` is a leap year in the proleptic Gregorian calendar. pub fn isLeap(y: i64) bool { return @mod(y, 4) == 0 and (@mod(y, 100) != 0 or @mod(y, 400) == 0); } +/// Days in month `m` of year `y`; `m` must be 1..12. pub fn daysInMonth(y: i64, m: u8) u8 { const t = [_]u8{ 31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31 }; return if (m == 2 and isLeap(y)) 29 else t[m - 1]; @@ -132,6 +159,10 @@ fn ruleDay(r: Rule, y: i64) i64 { } } +/// Seconds east of UTC that rule `p` puts in force at UTC time `t`: the +/// daylight offset from the year's start of daylight saving time to its end, +/// the standard offset otherwise. A start later in the year than the end, +/// as in the southern hemisphere, means daylight time spans the new year. pub fn posixOffset(p: Posix, t: i64) i32 { const dst = p.dst orelse return p.std_off; const y = yearOf(@divFloor(t + p.std_off, 86400)); @@ -219,6 +250,13 @@ const Parser = struct { } }; +/// Parse a POSIX TZ rule string, `std offset[dst[offset][,start[/time],end[/time]]]`. +/// A name is three or more letters, or three or more characters in `<>`; +/// an offset is `[+-]hh[:mm[:ss]]` west of UTC. Without its offset, +/// daylight time is one hour ahead of standard time; without rules it runs +/// from the second Sunday in March to the first Sunday in November, and a +/// rule without a time changes at 02:00. Anything else, trailing text +/// included, is `error.Bad`. pub fn parsePosix(s: []const u8) !Posix { var p: Parser = .{ .s = s }; try p.name(); diff --git a/src/main.zig b/src/main.zig index f40e892..c182756 100644 --- a/src/main.zig +++ b/src/main.zig @@ -14,6 +14,8 @@ const scan = @import("scan.zig"); const Allocator = std.mem.Allocator; const tool = "eb-keep-logs"; +/// The version `--version` prints after the tool's name. `.version` in +/// build.zig.zon names the same one, and a release changes both. pub const version = "0.2.1"; const usage_text = @@ -643,6 +645,10 @@ fn cmdRotate(c: Ctx, args: []const [:0]const u8) u8 { return 0; } +/// The command line. `failed` and `rotate` run those commands; `--help` or +/// `-h` prints the usage and `--version` the version line, both returning +/// 0. No command prints the usage and returns 2, and an unknown one is +/// refused with 2. pub fn main(init: std.process.Init) u8 { const gpa = init.gpa; const args = init.minimal.args.toSlice(init.arena.allocator()) catch die("cannot read the arguments", .{}); From 1558bc05e8d2f2611861f20c870cdb929ec6a65f Mon Sep 17 00:00:00 2001 From: Rohit Goswami Date: Mon, 16 Nov 2026 17:59:47 +0000 Subject: [PATCH 3/4] docs: COMPAT.md lists the differences that are bugs COMPAT.md says the Zig build dates runs as date -d does, TZ rules included, and refuses an EB_KEEP_LOGS_NOW that is not an integer. Run side by side with the shell script, it differs in three cases that no row covers: - EB_KEEP_LOGS_NOW set but empty is refused with exit 2; the shell script takes the current time. - With TZDIR set but empty, a zone name in TZ is looked up relative to the working directory, so the zone is UTC; date reads it under /usr/share/zoneinfo. - A TZ with a leading ':' that names no file, such as ':CET-1CEST,M3.5.0,M10.5.0/3', is UTC; date reads the rule after the ':'. A new table lists them as unintended differences, and the two rows that claimed more now say less. The code is unchanged. --- COMPAT.md | 14 ++++++++++++-- changelog.d/+compat-unintended.doc.md | 1 + 2 files changed, 13 insertions(+), 2 deletions(-) create mode 100644 changelog.d/+compat-unintended.doc.md diff --git a/COMPAT.md b/COMPAT.md index ab50eee..367dfeb 100644 --- a/COMPAT.md +++ b/COMPAT.md @@ -15,7 +15,7 @@ on the same invocations. | `eb` | `eb --last-log [--tmp-logdir=TMP_LOGDIR] --output-style=basic`, and the same without `--output-style` when that fails or prints nothing; the last line printed is the log | | stdout | `Failed build log: LOGDIR/NAME.failed.ebout.log`, `Failed command output: LOGDIR/NAME.failed.command-{out,err}.txt`, `Failed meson test log: LOGDIR/NAME.failed.meson-testlog.txt`, `Failed command output not kept: EASYBUILD_TMPDIR is not set.`, `Failed command output not kept: PATH is not under EASYBUILD_TMPDIR.`, `Failed command output not kept: PATH belongs to another user.`, `No EasyBuild log to keep for NAME.`, `No EasyBuild log to keep for NAME: eb is not on PATH.`, `No EasyBuild log to keep for NAME: eb --last-log exited N.`, `No EasyBuild log to keep for NAME: PATH is another build's log.`, `eb-keep-logs rotate: N files compressed, M runs deleted under ROOT`, with `1 file` and `1 run` for a count of one; LOGDIR in these lines without its trailing slashes | | files | kept files closed to others (command streams mode 0600), their resolved paths appended to `LOGDIR/.licensed-logs` unless already listed; on a failure, `NAME.stdout.log`, a TMP_LOGDIR below LOGDIR and the regular files directly in it closed to others, a symbolic link left as it is; `rotate` writes `FILE.gz` with the file's mode and updates `.licensed-logs` to the `.gz` path | -| run ages | days from the local midnight of the date in the run's name, as `date -d YYYYMMDD` computes it, including TZ rules; a run whose local midnight does not exist is skipped | +| run ages | days from the local midnight of the date in the run's name, as `date -d YYYYMMDD` computes it, including TZ rules, except in the two cases of `TZ` and `TZDIR` under unintended differences; a run whose local midnight does not exist is skipped | | the run in progress | `rotate` neither compresses nor deletes the run that holds its stdout or stderr, when either is a regular file, or `EB_PIPELINE_LOG_DIR` | ## Deliberate differences @@ -25,7 +25,7 @@ on the same invocations. | no arguments, `--help` | prints a trailing half sentence from the script's header | stops after the `--version` line | | `--version` | `eb-keep-logs 0.1.0` | `eb-keep-logs 0.2.1 (TARGET, MODE, zig VERSION, COMMIT)`; the first two words are unchanged | | `--compress-after` or `--delete-after` with no value after it | never returns | refused, exit 2 | -| `EB_KEEP_LOGS_NOW` not an integer | evaluated as shell arithmetic | refused, exit 2 | +| `EB_KEEP_LOGS_NOW` not empty and not an integer | evaluated as shell arithmetic | refused, exit 2 | | a copy into LOGDIR fails | error from cp, then the file is still listed and reported | error on stderr; the file is neither listed nor reported | | a copy into an existing LOGDIR file fails part way (a full disk) | cp truncates the file first, so the previous bytes are gone | the previous file is left unchanged; nothing is listed or reported | | a symbolic link or non-regular file at a destination name in LOGDIR | cp writes through it | refused, reported on stderr | @@ -38,3 +38,13 @@ on the same invocations. | a log larger than 1 GiB | scanned | copied, not checked for another build and not scanned for the command output or meson paths, with a message on stderr | | a meson testlog larger than 1 GiB | kept unless its summary shows every test passing | kept without reading the summary, with a message on stderr | | a log with NUL bytes | `grep` reports a binary match and the scan finds nothing | scanned as text | + +## Unintended differences + +The Zig build differs here without meaning to; each is a bug in the Zig build. + +| case | shell script | Zig build | +|---|---|---| +| `EB_KEEP_LOGS_NOW` set but empty | the current time | refused, exit 2: `eb-keep-logs: EB_KEEP_LOGS_NOW must be seconds since the epoch, not ''` | +| `TZDIR` set but empty, `TZ` naming a zone file | the file under `/usr/share/zoneinfo`, as `date` reads it | the name is looked up relative to the working directory, so the zone is UTC unless a file of that name is there | +| `TZ` with a leading `:` that names no file, such as `:CET-1CEST,M3.5.0,M10.5.0/3` | the rule string after the `:`, as `date` reads it | UTC | diff --git a/changelog.d/+compat-unintended.doc.md b/changelog.d/+compat-unintended.doc.md new file mode 100644 index 0000000..ab54ae7 --- /dev/null +++ b/changelog.d/+compat-unintended.doc.md @@ -0,0 +1 @@ +COMPAT.md lists three differences between the Zig build and the shell script that are bugs, not choices: an empty `EB_KEEP_LOGS_NOW` is refused instead of meaning the current time, an empty `TZDIR` leaves a zone name relative to the working directory, and a `TZ` with a leading `:` that names no file is UTC. Its rows on `EB_KEEP_LOGS_NOW` and on run ages no longer claim more than the Zig build does. From 6d0051b9d684f8b1c95f4f796706de94e1ed99d8 Mon Sep 17 00:00:00 2001 From: Rohit Goswami Date: Mon, 16 Nov 2026 18:28:28 +0000 Subject: [PATCH 4/4] docs: how-to guides, explanations and the cli reference The first pages covered one task and one design choice. These are the rest: - how-to guides: rotate a log tree, and mark logs that may carry a licence number; - explanation: how a run's age is reckoned from its name in local time; - reference: the eb-keep-logs command, with its arguments, options, environment, exit statuses, every message it prints and the files it reads and writes, each checked against src/main.zig. The commands on each how-to page were run as the page says, on the run the tutorial made, and their output is pasted from that run. The tutorial, the pipeline how-to and the first explanation link to the new pages, and an italic lead in that explanation no longer holds a literal, which reStructuredText cannot nest. --- changelog.d/+docs-pages.doc.md | 1 + docs/orgmode/explanation/index.org | 1 + docs/orgmode/explanation/local-time.org | 53 ++++++ docs/orgmode/explanation/why-eb-last-log.org | 5 +- docs/orgmode/howto/call-from-a-pipeline.org | 2 + docs/orgmode/howto/index.org | 2 + docs/orgmode/howto/mark-licensed-logs.org | 86 +++++++++ docs/orgmode/howto/rotate-a-log-tree.org | 81 +++++++++ docs/orgmode/reference/cli.org | 166 ++++++++++++++++++ docs/orgmode/reference/index.org | 1 + .../tutorials/keep-a-failed-build-log.org | 3 + 11 files changed, 399 insertions(+), 2 deletions(-) create mode 100644 changelog.d/+docs-pages.doc.md create mode 100644 docs/orgmode/explanation/local-time.org create mode 100644 docs/orgmode/howto/mark-licensed-logs.org create mode 100644 docs/orgmode/howto/rotate-a-log-tree.org create mode 100644 docs/orgmode/reference/cli.org diff --git a/changelog.d/+docs-pages.doc.md b/changelog.d/+docs-pages.doc.md new file mode 100644 index 0000000..c4e1f55 --- /dev/null +++ b/changelog.d/+docs-pages.doc.md @@ -0,0 +1 @@ +The site has how-to guides for rotating a log tree and marking logs that may carry a licence number; an explanation of how a run's age is reckoned from its name in local time; and a reference of the `eb-keep-logs` command: its arguments, options, environment variables, exit statuses, every message it prints and the files it reads and writes. diff --git a/docs/orgmode/explanation/index.org b/docs/orgmode/explanation/index.org index 26390be..5a83a46 100644 --- a/docs/orgmode/explanation/index.org +++ b/docs/orgmode/explanation/index.org @@ -12,4 +12,5 @@ Nothing here is a step to follow. :maxdepth: 1 why-eb-last-log + local-time #+end_export diff --git a/docs/orgmode/explanation/local-time.org b/docs/orgmode/explanation/local-time.org new file mode 100644 index 0000000..58dbde0 --- /dev/null +++ b/docs/orgmode/explanation/local-time.org @@ -0,0 +1,53 @@ +#+TITLE: Run ages and local time +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* Run ages and local time + +How does =eb-keep-logs rotate= tell how old a run is, and why from the date in the run's name, counted in local time, not from the directory's modification time? + +** The problem + +=rotate= decides for each run whether to compress its logs, remove it, or leave it, and that decision is only as good as the run's age. +A directory's modification time is not the run's age: it moves whenever an entry is added, removed or renamed in it. +Compressing a run renames every log in it to a =.gz= file, so a run =rotate= compressed would look new again, and so would a run a retried build wrote into. + +The pipeline names each run by the local time it started, =date +%Y%m%d_%H%M%S=, and the shell script dated runs with =date -d YYYYMMDD +%s=, the epoch second of the local midnight of that date. +The Zig build has to give the same ages without =date=: it is one static binary with no C library, so there is no =mktime(3)= to ask. + +** How eb-keep-logs handles it + +=rotate= takes the run's age from its name. + +1. Only a directory directly under the root whose name is =YYYYMMDD_HHMMSS=, fifteen characters with digits around the underscore, and whose date exists in the calendar, is a run. + Anything else, including a name that starts with a dot, is left alone, with no message. +2. The age is the number of whole days from the local midnight of the run's date to now, in days of 86,400 seconds. + The time in the name is not used, so every run of one day ages together. +3. Local midnight follows the time zone the C library would use: =TZ=, or =/etc/localtime= when =TZ= is unset. + [[zig:eb-keep-logs.localtime.load]] reads the zone file itself, using its transitions and then the rule at its end for later dates, and [[zig:eb-keep-logs.localtime.Zone.fromLocal]] turns the local midnight into an epoch second. +4. Where a change to daylight saving time skips midnight, the clock jumping from 00:00 to 01:00, that date's midnight does not exist. + =date -d= refuses such a date, and =rotate= skips the run, as the shell script did. + +=EB_KEEP_LOGS_NOW= replaces now with a time of your choosing, in seconds since the epoch; nothing else changes. + +** What was considered and turned down + +- /The run directory's modification time./ + It moves when the run is compressed or written to, as above. +- /Asking the date command for each run, as the shell script does./ + It starts a =date -d= process per run and needs GNU =date=, where the binary needs nothing but =eb=, and =rotate= does not even need that. +- /Linking a C library./ + It would give =mktime(3)= to =rotate=, but the Zig tools are built without one, for the reasons in [[site:zig-common:explanation/system-calls-without-libc][System calls without a C library]]. + +** Limits + +- Days are 86,400 seconds long, as in the shell script, so for an hour around the midnight after a daylight saving change a run's age is a day off the calendar: just after midnight following the change to summer time, a run from two days before counts as one day old. +- A run dated in the future is younger than 0 days and is left alone, except one dated less than a day ahead, which counts as 0 days old. +- Only the date is checked: =HHMMSS= has to be six digits, not a time that exists. +- The zone is read as glibc reads it except in two cases, an empty =TZDIR= and a =TZ= with a leading =:= that names no file, which [[file:../reference/compatibility.org][Compatibility]] lists under unintended differences. + +** Further reading + +- [[file:../howto/rotate-a-log-tree.org][Rotate a log tree]] +- [[file:../reference/api/zig/eb-keep-logs.localtime.md][The localtime module's API]] +- [[man:tzfile(5)]], the format of a zone file, and [[man:tzset(3)]], how the C library reads =TZ=. diff --git a/docs/orgmode/explanation/why-eb-last-log.org b/docs/orgmode/explanation/why-eb-last-log.org index 52f7cca..3c71751 100644 --- a/docs/orgmode/explanation/why-eb-last-log.org +++ b/docs/orgmode/explanation/why-eb-last-log.org @@ -52,8 +52,8 @@ A log that shows EasyBuild processing an easyconfig and never names =NAME.eb= is The session log covers the whole =eb= run, including what EasyBuild did before it reached the easyconfig that failed. - /Keeping the last command's output whatever its outcome./ After a sanity check fails, that is the output of a command that worked. -- /Waiting for =eb --last-log= without a limit./ - The shell script does; the binary does not, as [[file:../reference/compatibility.org][Compatibility]] records. +- /Waiting for EasyBuild without a limit./ + The shell script waits for =eb --last-log= as long as it takes; the binary does not, as [[file:../reference/compatibility.org][Compatibility]] records. ** Limits @@ -66,5 +66,6 @@ A log that shows EasyBuild processing an easyconfig and never names =NAME.eb= is ** Further reading - [[file:../howto/call-from-a-pipeline.org][Call eb-keep-logs from a build pipeline]] +- [[file:../reference/cli.org][The eb-keep-logs command]], every message =failed= prints. - EasyBuild's pages on [[https://docs.easybuild.io/log-files/][log files]] and on [[https://docs.easybuild.io/easybuild-v5/run_shell_cmd/][run_shell_cmd]], which saves each command's output. - [[site:zig-common:explanation/process-groups-and-deadlines][Process groups and deadlines]], how the deadline stops =eb= and whatever it started. diff --git a/docs/orgmode/howto/call-from-a-pipeline.org b/docs/orgmode/howto/call-from-a-pipeline.org index d325e30..a0071bf 100644 --- a/docs/orgmode/howto/call-from-a-pipeline.org +++ b/docs/orgmode/howto/call-from-a-pipeline.org @@ -86,5 +86,7 @@ Each build has =NAME.stdout.log= and its =--tmp-logdir= under =easybuild-logs/=; ** Related +- [[file:rotate-a-log-tree.org][Rotate a log tree]] - [[file:../explanation/why-eb-last-log.org][Finding a failed build's log]] +- [[file:../reference/cli.org][The eb-keep-logs command]] - [[file:../tutorials/keep-a-failed-build-log.org][Keep a failed build's logs]] diff --git a/docs/orgmode/howto/index.org b/docs/orgmode/howto/index.org index ffe3918..1a99c99 100644 --- a/docs/orgmode/howto/index.org +++ b/docs/orgmode/howto/index.org @@ -12,4 +12,6 @@ The title names the task. :maxdepth: 1 call-from-a-pipeline + rotate-a-log-tree + mark-licensed-logs #+end_export diff --git a/docs/orgmode/howto/mark-licensed-logs.org b/docs/orgmode/howto/mark-licensed-logs.org new file mode 100644 index 0000000..88b9917 --- /dev/null +++ b/docs/orgmode/howto/mark-licensed-logs.org @@ -0,0 +1,86 @@ +#+TITLE: Mark logs that may carry a licence number +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* Mark logs that may carry a licence number + +Use this to find which files of a run must not leave it, for example before you attach a build's logs to a ticket. +A failed compile line of licensed software can print the licence number, so =eb-keep-logs failed= closes the copies it keeps to other users and lists them in =.licensed-logs= in the run directory, one absolute path per line. +The build's output and the files EasyBuild wrote to the =--tmp-logdir= hold the same lines, and EasyBuild's test report there holds the build's environment; =failed= closes them too, but does not list them. +This guide lists them, then shows what is left. + +** Before you start + +- A run directory in which =eb-keep-logs failed= kept a build's logs, such as the one from [[file:../tutorials/keep-a-failed-build-log.org][Keep a failed build's logs]], and =LOGDIR= set to it, as the tutorial sets it. +- =realpath=, =grep= and =find=. + +** Steps + +1. Read the list: + + #+begin_src bash + cat "$LOGDIR/.licensed-logs" + #+end_src + + #+begin_example + /home/alice/build-logs/20261116_175326/Example-1.0.failed.ebout.log + /home/alice/build-logs/20261116_175326/Example-1.0.failed.command-out.txt + #+end_example + +2. Add the files =failed= closed: the build's output, and the regular files directly in the =--tmp-logdir=. + Add each once, by its absolute path with symbolic links resolved, as =failed= lists a file: + + #+begin_src bash + { realpath "$LOGDIR/Example-1.0.stdout.log" + find "$LOGDIR/easybuild-logs/Example-1.0" -maxdepth 1 -type f -exec realpath {} + + } | while read -r p; do + grep -qxF "$p" "$LOGDIR/.licensed-logs" || printf '%s\n' "$p" >> "$LOGDIR/.licensed-logs" + done + #+end_src + + Close a file you add to other users as well, unless =failed= already has: =chmod o-rwx FILE=. +3. List the files of the run that are not on the list: + + #+begin_src bash + find "$LOGDIR" -type f ! -name .licensed-logs -exec realpath {} + \ + | grep -vxF -f "$LOGDIR/.licensed-logs" + #+end_src + + #+begin_example + /home/alice/build-logs/20261116_175326/easybuild-logs/Example-1.0/reprod_20261116175326_9014/Example-1.0.eb + /home/alice/build-logs/20261116_175326/easybuild-logs/Example-1.0/reprod_20261116175326_9014/easyblocks/binary.py + #+end_example + + Here they are the copies of the easyconfig and the easyblock that EasyBuild keeps to reproduce the build. + Look at any file before you share it: the list says which files are known to hold such lines, not that the others are free of them. + +** Check that it worked + +The list names the build's output and the three files of the =--tmp-logdir= after the two copies: + +#+begin_src bash +cat "$LOGDIR/.licensed-logs" +#+end_src + +#+begin_example +/home/alice/build-logs/20261116_175326/Example-1.0.failed.ebout.log +/home/alice/build-logs/20261116_175326/Example-1.0.failed.command-out.txt +/home/alice/build-logs/20261116_175326/Example-1.0.stdout.log +/home/alice/build-logs/20261116_175326/easybuild-logs/Example-1.0/easybuild-Example-1.0-20261116.175326.iEeXN_test_report.md +/home/alice/build-logs/20261116_175326/easybuild-logs/Example-1.0/easybuild-id6ffdi2.log +/home/alice/build-logs/20261116_175326/easybuild-logs/Example-1.0/easybuild-Example-1.0-20261116.175326.iEeXN.log +#+end_example + +When =eb-keep-logs rotate= compresses the run, it changes each listed path to that of the =.gz= file, so the marks stay with the logs. + +** If it fails + +| Message or symptom | Cause | What to do | +|---------------------------------------------------------+-------------------------------------------------------------------------------+--------------------------------------------------------------------------| +| =cat: LOGDIR/.licensed-logs: No such file or directory= | =failed= kept nothing in this run, so it wrote no list. | To mark files anyway, create the list: =touch "$LOGDIR/.licensed-logs"=. | +| After =rotate=, a line still names a file without =.gz= | The line names the file by another path, such as one through a symbolic link. | List the path =realpath= prints, as in step 2. | + +** Related + +- [[file:rotate-a-log-tree.org][Rotate a log tree]] +- [[site:zig-common:howto/compress-and-mark-logs][Compress logs and keep them marked]], for a tool that compresses marked logs itself, and [[zig:zig_common.logs.licensed_list]], the list's name. diff --git a/docs/orgmode/howto/rotate-a-log-tree.org b/docs/orgmode/howto/rotate-a-log-tree.org new file mode 100644 index 0000000..fdbb8b7 --- /dev/null +++ b/docs/orgmode/howto/rotate-a-log-tree.org @@ -0,0 +1,81 @@ +#+TITLE: Rotate a log tree +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* Rotate a log tree + +Use this to keep a directory of build runs from growing without end: compress the logs of runs some days old, and remove runs older still. +=eb-keep-logs rotate= works on the run directories directly under the directory you give it, named by their date and time, =YYYYMMDD_HHMMSS=, as [[file:call-from-a-pipeline.org][Call eb-keep-logs from a build pipeline]] makes them. + +** Before you start + +- =eb-keep-logs= on your =PATH=; [[file:../tutorials/keep-a-failed-build-log.org][Keep a failed build's logs]] installs it. +- A log tree, here =~/build-logs=, and write access to its runs: =rotate= replaces each log with a =.gz= file beside it, and removes whole runs. + +** Steps + +1. Choose two ages, in days. + A run's age is the number of whole days from the local midnight of the date in its name. + =--compress-after DAYS= compresses the =*.log= and =*.txt= files of runs at least =DAYS= old, at any depth. + =--delete-after DAYS= removes runs at least =DAYS= old, and must be larger; without it, no run is removed. +2. Try the ages on a copy of the tree, at a later date. + =EB_KEEP_LOGS_NOW= sets the time =rotate= takes as now, in seconds since the epoch: + + #+begin_src bash + cp -a ~/build-logs /tmp/build-logs-preview + EB_KEEP_LOGS_NOW=$(date -d 2027-01-01 +%s) \ + eb-keep-logs rotate /tmp/build-logs-preview --compress-after 30 --delete-after 365 + #+end_src + + #+begin_example + eb-keep-logs rotate: 5 files compressed, 0 runs deleted under /tmp/build-logs-preview + #+end_example + + On 2027-01-01 the run is 46 days old: at least 30, less than 365. +3. Rotate the tree: + + #+begin_src bash + eb-keep-logs rotate ~/build-logs --compress-after 30 --delete-after 365 + #+end_src + + #+begin_example + eb-keep-logs rotate: 0 files compressed, 0 runs deleted under /home/alice/build-logs + #+end_example + + No run is 30 days old yet, so nothing changed. + Run the same command at the end of each pipeline run, as the pipeline how-to does, or from a daily job. + +** Check that it worked + +The summary line counts the files =rotate= compressed and the runs it removed. +In a compressed run, each log is a =.gz= file with the log's mode: + +#+begin_src bash +ls -l /tmp/build-logs-preview/*/ +#+end_src + +#+begin_example +total 20 +-rw------- 1 alice alice 165 Nov 16 17:53 Example-1.0.failed.command-out.txt.gz +-rw------- 1 alice alice 5791 Nov 16 17:53 Example-1.0.failed.ebout.log.gz +-rw-rw---- 1 alice alice 939 Nov 16 17:53 Example-1.0.stdout.log.gz +drwxrwxr-x 3 alice alice 4096 Nov 16 17:53 easybuild-logs +#+end_example + +** If it fails + +| Message | Cause | What to do | +|--------------------------------------------------------------------+------------------------------------------------------------------------------------------------------+-----------------------------------------------------------------------| +| =eb-keep-logs: --compress-after needs a number of days= | The option is missing, or its value is not a whole number, like =30d=. | Give a number of days: =--compress-after 30=. | +| =eb-keep-logs: --delete-after must be later than --compress-after= | =--delete-after= is not larger than =--compress-after=. | Raise =--delete-after=, or leave it out to remove nothing. | +| =eb-keep-logs: unknown option --dry-run= | =rotate= has no dry run. | Try the ages on a copy, as in step 2. | +| =eb-keep-logs: ROOT PATH is not a directory= | The path is wrong, or names a run, not the tree. | Give the directory that holds the runs. | +| =eb-keep-logs: cannot compress PATH: TooManyLinks= | The log has other hard links. The shell script prints =gzip='s own message. | Nothing: like =gzip=, =rotate= leaves it as it is. | +| =eb-keep-logs: cannot compress PATH: Exists= | =PATH.gz= exists already. The shell script prints =gzip='s own message. | Remove or rename one of the two, and rotate again. | +| A run is not compressed, and there is no message | Its name is not =YYYYMMDD_HHMMSS=, or it holds the output of this =rotate= or =EB_PIPELINE_LOG_DIR=. | Rename it, or leave it to the next =rotate=, after the run has ended. | + +** Related + +- [[file:mark-licensed-logs.org][Mark logs that may carry a licence number]]: =rotate= renames the lines of =.licensed-logs= to the =.gz= files. +- [[file:../explanation/local-time.org][Run ages and local time]] +- [[file:../reference/cli.org][The eb-keep-logs command]] diff --git a/docs/orgmode/reference/cli.org b/docs/orgmode/reference/cli.org new file mode 100644 index 0000000..d5079df --- /dev/null +++ b/docs/orgmode/reference/cli.org @@ -0,0 +1,166 @@ +#+TITLE: The eb-keep-logs command +#+OPTIONS: toc:nil todo:nil num:nil author:nil title:nil +#+STARTUP: content + +* The eb-keep-logs command + +=eb-keep-logs= keeps the logs of a failed EasyBuild build, and compresses and removes the old runs of a log tree. +This page describes the Zig build; the shell script =eb-keep-logs= in the repository behaves the same, except as [[file:compatibility.org][Compatibility]] lists. + +** Synopsis + +#+begin_example +eb-keep-logs failed STATUS NAME LOGDIR [TMP_LOGDIR] +eb-keep-logs rotate ROOT --compress-after DAYS [--delete-after DAYS] +eb-keep-logs --help | --version +#+end_example + +** Arguments + +| Argument | Command | Meaning | +|--------------+----------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| =STATUS= | =failed= | The exit status =eb= returned, in decimal digits. A status of only zeros keeps and changes nothing, once =LOGDIR= has been checked. | +| =NAME= | =failed= | The easyconfig's name without =.eb=, as in =LOGDIR/NAME.stdout.log=; it names the copies, and without =TMP_LOGDIR= it tells the build's own log from another build's. | +| =LOGDIR= | =failed= | The run's directory, which holds =NAME.stdout.log= and gets the copies and =.licensed-logs=; a symbolic link to a directory is followed. | +| =TMP_LOGDIR= | =failed= | The =--tmp-logdir= =eb= ran with, passed on to =eb --last-log=. Empty is the same as not given: =eb --last-log= then names the newest log in EasyBuild's default place. Arguments after it are ignored. | +| =ROOT= | =rotate= | The directory that holds the runs. A run is a directory directly under it, not a symbolic link, named =YYYYMMDD_HHMMSS= with a date that exists; everything else under it is left alone. | + +** Options + +| Option | Command | Meaning | +|--------------------------------------------------+----------+----------------------------------------------------------------------------------------------------------------------------------------------| +| =--compress-after DAYS=, =--compress-after=DAYS= | =rotate= | Required. Compress the =*.log= and =*.txt= files, at any depth, of runs at least =DAYS= old. =DAYS= is decimal digits. | +| =--delete-after DAYS=, =--delete-after=DAYS= | =rotate= | Remove whole runs at least =DAYS= old. =DAYS= must be larger than =--compress-after=. Without it, or with an empty value, no run is removed. | +| =-h=, =--help= | | Print the usage on stdout and exit 0. | +| =--version= | | Print the version line on stdout and exit 0. | + +- A run's age is the number of whole days from the local midnight of the date in its name; [[file:../explanation/local-time.org][Run ages and local time]] gives the details. +- =rotate='s options and =ROOT= come in any order; the value of an option is the next argument, whatever it is. + An option given twice takes its last value. +- =-h=, =--help= and =--version= count only in the place of the command. +- =failed= takes no options. + +** Environment + +| Variable | Command | Meaning | +|-----------------------+----------+-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| =PATH= | =failed= | Where =eb= is looked up. =eb= runs with the environment =failed= got. | +| =EASYBUILD_TMPDIR= | =failed= | A failed command's output is copied only from below this directory, both paths resolved. Unset or empty, it is not copied. | +| =EB_KEEP_LOGS_NOW= | =rotate= | The time =rotate= takes as now, in seconds since the epoch. When set, it must be an integer; an empty value is refused too, where the shell script takes the current time. | +| =EB_PIPELINE_LOG_DIR= | =rotate= | The run that holds this path is left alone: it is the run eb-pipeline writes into. Unset, empty, or a path that does not exist, it changes nothing. | +| =TZ= | =rotate= | The time zone of the local midnight: unset, =/etc/localtime=; empty, UTC; otherwise a zone file, by name under =TZDIR= or by absolute path, or a POSIX rule string such as =CET-1CEST,M3.5.0,M10.5.0/3=. A value starting with =:= is a zone file only, where the shell script's =date= reads a rule string after the =:= too. A zone that cannot be read is UTC. | +| =TZDIR= | =rotate= | The directory of zone files, =/usr/share/zoneinfo= when unset. Set but empty, a zone name is looked up relative to the working directory, where the shell script's =date= uses =/usr/share/zoneinfo=. | + +** Exit status + +| Status | Meaning | +|--------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| 0 | =--help= or =--version=, or a =failed= or =rotate= that accepted its arguments, whatever it could keep, compress or remove: what it could not do is reported, and is no failure. | +| 2 | The invocation was refused, with =eb-keep-logs: MESSAGE= on stderr; or no command was given, and the usage is on stdout. | + +| =MESSAGE= | Cause | +|-----------------------------------------------------------------+-----------------------------------------------------------------------------------------------| +| =unknown command 'WORD' (failed, rotate, --help)= | The first argument is none of the commands. | +| =failed needs STATUS NAME LOGDIR [TMP_LOGDIR]= | =failed= got fewer than three arguments. | +| =STATUS must be a number, not 'STATUS'= | =STATUS= is empty or holds something other than digits. | +| =LOGDIR LOGDIR is not a directory= | =LOGDIR= does not name a directory that can be opened. | +| =rotate needs ROOT= | =rotate= got no =ROOT=, or an empty one. | +| =rotate takes one ROOT= | =rotate= got two arguments that are not options. | +| =unknown option OPTION= | =rotate= got an argument starting with =-= that is none of its options. | +| =ROOT ROOT is not a directory= | =ROOT= does not name a directory that can be opened. | +| =OPTION needs a number of days= | =--compress-after= is missing, or a value is missing, empty, not decimal digits or too large. | +| =--delete-after must be later than --compress-after= | =--delete-after= is not larger than =--compress-after=. | +| =EB_KEEP_LOGS_NOW must be seconds since the epoch, not 'VALUE'= | =EB_KEEP_LOGS_NOW= is set, and is not an integer. | +| =cannot read ROOT ROOT=, =cannot read ROOT ROOT: ERROR= | =ROOT= could not be listed. | +| =cannot read the arguments= | The arguments could not be read into memory. | + +=rotate= checks =ROOT= before its options' values, and =failed= checks =STATUS= and then =LOGDIR=. + +** Files + +*** failed + +| File | Use | +|--------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| =LOGDIR/NAME.stdout.log= | Read: the last =.../run-shell-cmd-output/DIR/out.txt= path in it names the failed command's output. Closed to others, not through a symbolic link. | +| the session log =eb --last-log= names | Read, and copied to =LOGDIR/NAME.failed.ebout.log=. When =NAME.stdout.log= names no =out.txt=, the last one the session log names is taken, unless the log records that command completing successfully. | +| =LOGDIR/NAME.failed.ebout.log= | The session log. | +| =LOGDIR/NAME.failed.command-out.txt=, =-err.txt= | The failed command's =out.txt= and, when there is one, =err.txt=, mode 0600. A stream that is a symbolic link is not opened. | +| =LOGDIR/NAME.failed.meson-testlog.txt= | =meson-logs/testlog.txt= of the last =meson test -C DIR= the session log names, unless every test in it passed. | +| =LOGDIR/.licensed-logs= | Each copy's absolute path, with symbolic links resolved, is appended unless the list has it. | +| =TMP_LOGDIR= | Closed to others, with the regular files directly in it, when it lies below =LOGDIR=. | + +Each copy is written to a temporary file in =LOGDIR= and renamed over the name, so a copy that fails part way leaves an earlier one as it was. +A copy takes the source's mode, or the mode and, when permitted, the owner of the file it replaces, without others' bits; the command's streams are mode 0600. +A symbolic link, a directory or another file that is not a regular one at a copy's name is not written through: the copy is refused, with =eb-keep-logs: cannot keep LOGDIR/FILE: ERROR= on stderr. +What =failed= prints on stdout: + +| Line | When | +|-----------------------------------------------------------------------+----------------------------------------------------------------------------------------------------------------------------| +| =Failed build log: LOGDIR/NAME.failed.ebout.log= | The session log was kept. | +| =Failed command output: LOGDIR/NAME.failed.command-out.txt= | A command stream was kept, one line for each. | +| =Failed meson test log: LOGDIR/NAME.failed.meson-testlog.txt= | The meson test log was kept. | +| =No EasyBuild log to keep for NAME: eb is not on PATH.= | =eb= is not on =PATH=; nothing is kept. | +| =No EasyBuild log to keep for NAME: eb --last-log exited N.= | =eb --last-log= failed; nothing is kept. | +| =No EasyBuild log to keep for NAME.= | =eb --last-log= printed nothing, named no log that could be opened, or did not return within 300 seconds; nothing is kept. | +| =No EasyBuild log to keep for NAME: PATH is another build's log.= | Without =TMP_LOGDIR=, the newest log is another build's; the command output =NAME.stdout.log= names is still kept. | +| =Failed command output not kept: EASYBUILD_TMPDIR is not set.= | =EASYBUILD_TMPDIR= is unset or empty. | +| =Failed command output not kept: PATH is not under EASYBUILD_TMPDIR.= | The stream lies elsewhere. | +| =Failed command output not kept: PATH belongs to another user.= | The stream is not the caller's. | + +=LOGDIR= appears in these lines without its trailing slashes. +What =failed= cannot do it reports on stderr as =eb-keep-logs: MESSAGE=, and goes on with the rest: + +| =MESSAGE= | Cause | +|---------------------------------------------+--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| =cannot keep LOGDIR/FILE: ERROR= | The copy could not be written: =LOGDIR= is not writable, or =FILE= is a symbolic link, a directory or not a regular file. | +| =cannot stat PATH: ERROR= | A copy, =NAME.stdout.log=, =TMP_LOGDIR= or a file in it could not be examined; it is not closed to others. | +| =cannot close PATH to others: ERROR= | Its mode could not be changed. | +| =cannot resolve a kept file: ERROR= | A copy's absolute path could not be found; it is not listed. | +| =cannot list PATH in .licensed-logs: ERROR= | The line could not be appended to =.licensed-logs=. | +| =cannot scan PATH: ERROR= | The session log, =NAME.stdout.log= or the meson test log could not be read, or is larger than 1 GiB. Such a session log is still copied, but nothing is taken from it; for such a =NAME.stdout.log=, the session log is searched instead; such a meson test log is still kept. | + +*** rotate + +| File | Use | +|-------------------------------------+---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| +| =ROOT/RUN/.../FILE.log=, =FILE.txt= | In a run old enough, replaced by =FILE.gz= with the file's mode, as =gzip -9= does; a symbolic link is not followed, and a file with other hard links or an existing =FILE.gz= is left as it is, with a message on stderr. | +| =ROOT/RUN/.../.licensed-logs= | In a run in which files were compressed, a line that names one of them, by its absolute path with symbolic links resolved, is changed to name its =.gz= file. A list that changes keeps its owner when permitted, its mode and its access control list. | +| =ROOT/RUN= | Removed with everything in it, when old enough for =--delete-after=, without being compressed first. A symbolic link in it is removed, not followed. Removal stops at the first error. | + +A run that holds the file =rotate='s standard output or standard error goes to, or =EB_PIPELINE_LOG_DIR=, is left alone; the next =rotate= takes it. +On stdout =rotate= prints one line, with =ROOT= as given: + +#+begin_example +eb-keep-logs rotate: N files compressed, M runs deleted under ROOT +#+end_example + +with =1 file= and =1 run= for a count of one. +What =rotate= cannot do it reports on stderr as =eb-keep-logs: MESSAGE=, and goes on with the rest; a file or run it reports is not counted: + +| =MESSAGE= | Cause | +|-----------------------------------------+-------------------------------------------------------------------------------------------------------------------------------------| +| =cannot compress PATH: ERROR= | =PATH= is left as it is: it has other hard links (=TooManyLinks=), =PATH.gz= exists (=Exists=), or it could not be read or written. | +| =cannot open PATH: ERROR= | A run, or a directory in a run, could not be opened; nothing in it is compressed. | +| =cannot read PATH: ERROR= | Listing a run, or a directory in it, failed part way; nothing in it is compressed. | +| =cannot resolve a run directory: ERROR= | The absolute path of a run, or of a directory in it, could not be found; nothing in it is compressed. | +| =cannot read a .licensed-logs: ERROR= | A list could not be read, or is larger than 64 MiB; it is left as it is. | +| =cannot update a .licensed-logs: ERROR= | A list could not be replaced; it is left as it is. | +| =cannot delete ROOT/RUN: ERROR= | The run could not be removed completely; what was removed stays removed. | + +*** --version + +The version line follows the [[site:zig-common:reference/cli-conventions][command-line conventions]] of the stackhands Zig tools. +Version 0.2.1, built with =zig build -Drelease=true -Dcommit=5ceaead=: + +#+begin_example +eb-keep-logs 0.2.1 (x86_64-linux-musl, safe, zig 0.17.1, 5ceaead) +#+end_example + +** See also + +- [[file:../tutorials/keep-a-failed-build-log.org][Keep a failed build's logs]] +- [[file:../howto/call-from-a-pipeline.org][Call eb-keep-logs from a build pipeline]], [[file:../howto/rotate-a-log-tree.org][Rotate a log tree]] and [[file:../howto/mark-licensed-logs.org][Mark logs that may carry a licence number]] +- [[file:../explanation/why-eb-last-log.org][Finding a failed build's log]] and [[file:../explanation/local-time.org][Run ages and local time]] +- [[file:compatibility.org][Compatibility]], the differences from the shell script. +- [[file:api/zig/eb-keep-logs.md][The Zig API]], from the doc comments of the source. diff --git a/docs/orgmode/reference/index.org b/docs/orgmode/reference/index.org index e657b89..e88ab06 100644 --- a/docs/orgmode/reference/index.org +++ b/docs/orgmode/reference/index.org @@ -11,6 +11,7 @@ Each page states facts in the order the thing itself has them. .. toctree:: :maxdepth: 1 + cli compatibility api #+end_export diff --git a/docs/orgmode/tutorials/keep-a-failed-build-log.org b/docs/orgmode/tutorials/keep-a-failed-build-log.org index 07964a9..e4b14a7 100644 --- a/docs/orgmode/tutorials/keep-a-failed-build-log.org +++ b/docs/orgmode/tutorials/keep-a-failed-build-log.org @@ -179,10 +179,13 @@ cat "$LOGDIR/.licensed-logs" 2. The build's output named the file that holds the failed command's output. It lay under =EASYBUILD_TMPDIR= and belonged to you, so =failed= copied it. 3. A failed compile line of licensed software can print the licence number, so =failed= closed both copies, the build's output and the =--tmp-logdir= to other users, and listed the copies in =.licensed-logs=. + [[file:../howto/mark-licensed-logs.org][Mark logs that may carry a licence number]] shows how to use the list. 4. The run directory's name holds its date, from which =eb-keep-logs rotate= later decides to compress the run's logs and then to remove the run. ** Next steps - [[file:../howto/call-from-a-pipeline.org][Call eb-keep-logs from a build pipeline]] +- [[file:../howto/rotate-a-log-tree.org][Rotate a log tree]] +- [[file:../reference/cli.org][The eb-keep-logs command]] Checked with EasyBuild 5.4.2, Lmod 8.6.19 and eb-keep-logs at commit 5ceaead on 2026-11-16.