.github/ISSUE_TEMPLATE/1_pypa.yml

@@ -0,0 +1,43 @@
+# SPDX-FileCopyrightText: 2025 geisserml <geisserml@gmail.com>
+# SPDX-License-Identifier: CC-BY-4.0
+
+# TODO add separate template for source install issues?
+
+# NOTE we'd like a slightly longer description, but GH seems to impose some length limit (undocumented?, feels like 200 chars or something)
+name: PyPA install
+description: If you installed via pip (or other PyPA format tool), and encountered an issue with the library. Use even if you believe it is not a package problem. Default template.
+
+body:
+
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      description: |
+        There might be unofficial PyPA packages of pypdfium2 in the wild.
+        **We do not support third-party builds, and they are not eligible for a bug report.** Please make sure to use our official packages.
+      options:
+        - label: I confirm to be using an **official package** of `pypdfium2` from `PyPI` or `GitHub/pypdfium2-team`.
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: Please explain your problem.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Install Info
+      render: shell
+      description: |
+        To provide information about your install, please run the following commands and paste the output into the field below.
+        If the install failed, the last 2 commands may be skipped.
+        ```shell
+        python -VV
+        python -c "import platform as p; print(p.platform())"
+        python -m pypdfium2 -v
+        python -m pip show pypdfium2
+        ```
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/2_conda.yml

@@ -0,0 +1,52 @@
+# SPDX-FileCopyrightText: 2025 geisserml <geisserml@gmail.com>
+# SPDX-License-Identifier: CC-BY-4.0
+
+name: Conda install
+description: If you installed via conda, and encountered an issue with the library. Use even if you believe it is not a package problem.
+
+body:
+
+  # use a separate md section instead of a checklist description for better visibility since it's rather likely to come across an unofficial build with conda
+  - type: markdown
+    attributes:
+      value: |
+        #### Package origin
+        There may be unofficial conda packages of pypdfium2/pdfium-binaries in other channels, including anaconda or conda-forge defaults. **We do not support third-party builds, and they are not eligible for a bug report.** Please use our official packages instead.
+  
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      options:
+        - label: I have verified to be using the **official packages** from the `pypdfium2-team` and `bblanchon` channels.
+          required: true
+        - label: I confirm **requirements are satisfied** and **no conflicting builds** of pypdfium2/pdfium-binaries installed at the same time.
+          required: true
+        - label: I confirm to be working with the **conda env in question, and its proper python executable** (not system python).
+          required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: Please explain your problem.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Install Info
+      render: shell
+      description: |
+        To provide information about your install, please run the following commands **with the right conda env and python executable**, and paste the output into the field below.
+        If the install failed, the last 3 commands may be skipped.
+        ```shell
+        which python
+        python -VV
+        python -c "import platform as p; print(p.platform())"
+        conda list --show-channel-urls "pypdfium2|pdfium-binaries"
+        conda config --show-sources
+        python -m pypdfium2 -v
+        python -m pip show pypdfium2_raw
+        python -m pip show pypdfium2_helpers
+        ```
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/3_other.yml

@@ -0,0 +1,32 @@
+# SPDX-FileCopyrightText: 2025 geisserml <geisserml@gmail.com>
+# SPDX-License-Identifier: CC-BY-4.0
+
+name: Other issue
+description: Generic issue template (e.g. for docs, setup). Do not use for issues with the core library.
+
+body:
+
+  - type: checkboxes
+    attributes:
+      label: Checklist
+      options:
+        - label: I confirm this is **not a question or feature request**. *Otherwise, use the Discussions page.*
+          required: true
+        - label: I confirm this is **not an issue encountered with an installed build of pypdfium2, but about some other aspect of the project** (specify below). *Otherwise, use one of the package templates (PyPA/conda), even if you believe this is not a package-specific issue.*
+          required: true
+        - label: I confirm this is **not about an unofficial build of pypdfium2**. *We do not support third-party builds, and they are not eligible for a bug report.*
+          required: true
+
+  - type: input
+    attributes:
+      label: Reason for Generic issue (keyword/topic)
+      description: Briefly **justify** why you are using the Generic issue form.
+    validations:
+      required: true
+
+  - type: textarea
+    attributes:
+      label: Description
+      description: Please explain your problem.
+    validations:
+      required: true

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,11 @@
+# SPDX-FileCopyrightText: 2025 geisserml <geisserml@gmail.com>
+# SPDX-License-Identifier: CC-BY-4.0
+
+blank_issues_enabled: false
+contact_links:
+  - name: pypdfium2 discussions
+    url: https://github.com/pypdfium2-team/pypdfium2/discussions
+    about: pypdfium2 community support
+  - name: PDFium mailing list
+    url: https://groups.google.com/g/pdfium/
+    about: PDFium community support

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,41 @@
+**Important:** External contributors are required to comply with the template.
+
+## Description
+
+*Explain your changes here*
+
+## Checklist
+
+<!--
+- Answer the questions below, choosing the section(s) relevant to your PR. Non-applying sections shall be set to `closed`.
+- Place an `x` in the [ ] for yes, leave it empty for no. If a question is not applicable, remove the [ ], but keep the message in place.
+- Use the Preview tab to confirm the PR will render correctly.
+-->
+
+<details open><summary>Helpers</summary>
+
+- [ ] This PR changes helpers code.
+- [ ] The change comes with sufficient test cases to confirm correct functionality.
+- [ ] Any new test files are under a suitable license and have been registered in `REUSE.toml`.
+
+</details>
+<details open><summary>Setup</summary>
+
+- [ ] This PR changes setup code (`setupsrc/`, `setup.py` etc.).
+- [ ] I have read through relevant doc sections [Installation -> From source][1] and [Setup Magic][2].
+- [ ] I have tested the change does not break internal callers.
+- [ ] I believe the change is maintainable and does not cause unreasonable complexity or code fragmentation.
+- [ ] The change does not shift a maintenance burden or upstream downstream tasks. *Keep handlers generic, avoid overly downstream-specific or (for us) effectively dead code passages.*
+- [ ] I have assessed that the targeted use case cannot reasonably be satisfied by existing means, such as [Caller-provided data files][3], or the change forms a notable improvement over possible alternatives.
+- [ ] I believe the targeted use case is supported by pypdfium2-team. *Note that we may not want to support esoteric or artificially restricted setup envs.*
+
+[1]: https://github.com/pypdfium2-team/pypdfium2?tab=readme-ov-file#install-source
+[2]: https://github.com/pypdfium2-team/pypdfium2?tab=readme-ov-file#setup-magic
+[3]: https://github.com/pypdfium2-team/pypdfium2?tab=readme-ov-file#install-source-caller
+
+</details>
+<details open><summary>Other</summary>
+
+- [ ] This PR changes other things, namely: ... <!-- sum up change (keyword/topic) -->
+
+</details>

.github/dependabot.yml

@@ -0,0 +1,17 @@
+# SPDX-FileCopyrightText: 2024 GitHub
+# SPDX-FileCopyrightText: 2025 geisserml <geisserml@gmail.com>
+# SPDX-License-Identifier: LicenseRef-FairUse OR CC-BY-4.0
+
+# Set update schedule for GitHub Actions
+
+version: 2
+updates:
+
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      # Check for updates to GitHub Actions every week
+      interval: "weekly"
+    ignore:
+      - dependency-name: "benc-uk/workflow-dispatch"
+        versions: ["121"]  # presumably an upstream accident

.github/workflows/conda.yaml

@@ -0,0 +1,171 @@
+# SPDX-FileCopyrightText: 2025 geisserml <geisserml@gmail.com>
+# SPDX-License-Identifier: Apache-2.0 OR BSD-3-Clause
+
+name: Conda packaging
+on:
+  workflow_dispatch:
+    inputs:
+      package:
+        type: choice
+        default: raw
+        options:
+          - raw
+          - helpers
+      pdfium_ver:
+        default: 'latest'
+        type: string
+      new_only:
+        # only with package == "raw", ignored otherwise (actually the default should be false in that case, but I don't know if GH supports dynamic defaults depending on other inputs)
+        default: true
+        type: boolean
+      test:
+        default: true
+        type: boolean
+      publish:
+        default: false
+        type: boolean
+      py_version:
+        default: '3.12'
+        type: string
+
+# This is required for setup-miniconda / conda init
+# see https://github.com/conda-incubator/setup-miniconda#important
+defaults:
+  run:
+    shell: bash -el {0}
+
+# TODO it might be nice to support building both packages in one run and testing the helpers package with the newly-built raw package, but this may be fairly complicated
+# TODO add ability to rebuild helpers with different pdfium version bounds
+
+jobs:
+
+  build:
+
+    runs-on: ubuntu-latest
+    steps:
+
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ github.repository }}
+          fetch-depth: 0
+
+      - name: Miniconda setup
+        uses: conda-incubator/setup-miniconda@v3
+        with:
+          auto-update-conda: true
+          python-version: ${{ inputs.py_version }}
+          channels: pypdfium2-team,bblanchon
+          channel-priority: strict
+
+      - name: Prepare
+        run: |
+          python -VV
+          conda install -y conda-build conda-verify
+          git config --global user.email "geisserml@gmail.com"
+          git config --global user.name "geisserml"
+          python -m pip install -U -r req/setup.txt
+      
+      # TODO might be able to unify with ${{ inputs.package == 'raw' && inputs.new_only && '--new-only' || '' }} or something
+
+      - name: Build package
+        if: ${{ inputs.package == 'helpers' || !inputs.new_only }}
+        run: ./run craft-conda ${{ inputs.package }} --pdfium-ver ${{ inputs.pdfium_ver }}
+
+      - name: Build package (new only)
+        if: ${{ inputs.package == 'raw' && inputs.new_only }}
+        run: ./run craft-conda ${{ inputs.package }} --pdfium-ver ${{ inputs.pdfium_ver }} --new-only
+
+      - name: Upload artifact
+        uses: actions/upload-artifact@v4
+        with:
+          name: conda_package
+          path: conda/${{ inputs.package }}/out/
+
+  test:
+
+    if: ${{ inputs.test }}
+    needs: build
+
+    strategy:
+      fail-fast: false
+      matrix:
+        # NOTE On GH actions, macOS <=13 is Intel, whereas macOS >=14 will be ARM64
+        os: ['ubuntu-latest', 'ubuntu-24.04-arm', 'macos-13', 'macos-14', 'windows-latest']
+        py: ['3.8', '3.9', '3.10', '3.11', '3.12', '3.13']
+
+    runs-on: ${{ matrix.os }}
+
+    steps:
+
+      - name: Check out repository
+        uses: actions/checkout@v4
+        with:
+          repository: ${{ github.repository }}
+
+      - name: Miniconda setup
+        uses: conda-incubator/setup-miniconda@v3
+        with:
+          auto-update-conda: true
+          python-version: ${{ matrix.py }}
+
+      - name: Download artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: conda_package
+          path: conda_dist/
+
+      - name: Show debug info
+        run: |
+          python -VV
+          ls -l conda_dist/
+      
+      # according to the docs, --override-channels disables searching config file channels, and -c options priority decreases from left to right
+      - name: Install/Test raw package
+        if: inputs.package == 'raw'
+        run: |
+          conda install -y pypdfium2_${{ inputs.package }} --override-channels -c ./conda_dist/ -c bblanchon -c defaults
+          python conda/raw/minitest.py
+      
+      - name: Install/Test helpers package
+        if: inputs.package == 'helpers'
+        run: |
+          conda install -y pytest pillow numpy
+          conda install -y pypdfium2_${{ inputs.package }} --override-channels -c ./conda_dist/ -c pypdfium2-team -c bblanchon -c defaults
+          pytest tests/
+  
+  publish:
+
+    if: ${{ inputs.publish }}
+    needs: [build, test]
+    runs-on: ubuntu-latest
+
+    # TODO upload as GH release as well
+
+    steps:
+
+      # FIXME custom channels probably not necessary here
+      - name: Miniconda setup
+        uses: conda-incubator/setup-miniconda@v3
+        with:
+          auto-update-conda: true
+          python-version: ${{ matrix.py }}
+          channels: pypdfium2-team,bblanchon
+          channel-priority: strict
+
+      - name: Install deps
+        run: conda install -y anaconda-client
+
+      - name: Download artifact
+        uses: actions/download-artifact@v4
+        with:
+          name: conda_package
+          path: conda_dist/
+
+      - name: Upload to Anaconda
+        env:
+          ANACONDA_API_TOKEN: ${{ secrets.ANACONDA_API_TOKEN }}
+        run: |
+          ARTIFACT_PATH=conda_dist/noarch/pypdfium2_${{ inputs.package }}-*.conda
+          file $ARTIFACT_PATH
+          anaconda upload $ARTIFACT_PATH