bioio-conversion 0.1.0__tar.gz

bioio_conversion-0.1.0/.github/CODEOWNERS

@@ -0,0 +1 @@
+* @bioio-devs/trusted-developers

bioio_conversion-0.1.0/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,31 @@
+---
+name: Bug Report
+about: Create a report to help us improve bioio-ome-zarr
+labels: bug
+---
+
+<!--
+  ⚠️⚠️ Please do the following before submitting: ⚠️⚠️
+
+  📖 Please read our Code of Conduct.
+  🔎 Please search existing issues to avoid creating duplicates.
+-->
+
+### Describe the Bug
+
+<!-- A clear and concise description of the bug. -->
+
+### Expected Behavior
+
+<!-- What did you expect to happen instead? -->
+
+### Reproduction
+
+<!-- Steps to reproduce the behavior and/or a minimal example that exhibits the behavior. -->
+
+### Environment
+
+<!-- Any additional information about your environment. -->
+
+-   OS Version: _[e.g. macOS 11.3.1]_
+-   bioio-ome-zarr Version: _[e.g. 0.5.0]_

bioio_conversion-0.1.0/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,28 @@
+---
+name: Feature Request
+about: Suggest a feature for bioio-ome-zarr
+labels: enhancement
+---
+
+<!--
+  ⚠️⚠️ Please do the following before submitting: ⚠️⚠️
+
+  📖 Please read our Code of Conduct.
+  🔎 Please search existing issues to avoid creating duplicates.
+-->
+
+### Feature Description
+
+<!-- A clear and concise description of the feature you're requesting. -->
+
+### Use Case
+
+<!-- Please provide a use case to help us understand your request in context. -->
+
+### Solution
+
+<!-- Please describe your ideal solution. -->
+
+### Alternatives
+
+<!-- Please describe any alternatives you've considered, even if you've dismissed them. -->

bioio_conversion-0.1.0/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,23 @@
+<!--
+  Thank you for submitting a pull request!
+
+  ⚠️⚠️ Please do the following before submitting: ⚠️⚠️
+
+  - Read the CONTRIBUTING.md guide and make sure you've followed all the steps given.
+  - Ensure that the code is up-to-date with the `main` branch.
+  - Provide or update documentation for any feature added by your pull request.
+  - Provide relevant tests for your feature or bug fix.
+
+  ❗️ Also: ❗️
+
+  Please name your pull request {development-type}/{short-description}.
+  For example: feature/read-tiff-files
+-->
+
+### Link to Relevant Issue
+
+This pull request resolves #
+
+### Description of Changes
+
+<!-- Include a description of the proposed changes. -->

bioio_conversion-0.1.0/.github/dependabot.yml

@@ -0,0 +1,10 @@
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "monthly"
+    commit-message:
+      prefix: "ci(dependabot):"

bioio_conversion-0.1.0/.github/workflows/ci.yml

@@ -0,0 +1,126 @@
+name: CI
+
+on:
+  push:
+    branches:
+      - main
+    tags:
+      - "v*"
+  pull_request:
+    branches:
+      - main
+  schedule:
+      # Run every Monday at 10:24:00 PST
+    - cron: "24 18 * * 1"
+  workflow_dispatch:
+
+jobs:
+  # Check that all files listed in manifest make it into build
+  check-manifest:
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v5
+      - uses: actions/setup-python@v6
+        with:
+          python-version: "3.x"
+      - run: pip install check-manifest && check-manifest
+  
+  # Check tests pass on multiple Python and OS combinations
+  test:
+    runs-on: ${{ matrix.os }}
+    strategy:
+      fail-fast: false
+      matrix:
+        python-version: [ 3.11, 3.12, 3.13]
+        os: [ubuntu-latest, macOS-latest, windows-latest]
+    permissions:
+      id-token: write   # This is required for requesting the JWT
+      contents: read    # This is required for actions/checkout
+
+    steps:
+    - uses: actions/checkout@v5
+      with: 
+        lfs: true # For test files
+    - uses: actions/setup-python@v6
+      with:
+        python-version: ${{ matrix.python-version }}
+    - uses: extractions/setup-just@v3
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    - name: Install Dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install .[test]
+    - name: Run Tests
+      run: just test
+    - name: Upload Codecov
+      uses: codecov/codecov-action@v5
+
+  # Check linting, formating, types, etc.
+  lint:
+    runs-on: ubuntu-latest
+
+    steps:
+    - uses: actions/checkout@v5
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: "3.13"
+    - uses: extractions/setup-just@v3
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    - name: Install Dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install .[lint]
+    - name: Lint
+      run: just lint
+
+  # Publish to PyPI if test, lint, and manifest checks passed
+  publish:
+    if: "success() && startsWith(github.ref, 'refs/tags/')"
+    needs: [check-manifest, test, lint]
+    runs-on: ubuntu-latest
+    environment: release
+    permissions:
+      id-token: write  # IMPORTANT: this permission is mandatory for trusted publishing
+
+    steps:
+    - uses: actions/checkout@v5
+    - name: Set up Python
+      uses: actions/setup-python@v6
+      with:
+        python-version: "3.11"
+    - name: Install Dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build wheel
+    - name: Build Package
+      run: |
+        python -m build
+    - name: Publish to PyPI
+      uses: pypa/gh-action-pypi-publish@release/v1
+
+  # GitHub does not provide a "all status checks must pass" option
+  # in branch protection settings. Instead, you have to specify exactly
+  # what status checks want to require to pass before merging. However,
+  # naming each individual check would be effectively impossible.
+  # Therefore, by creating this stage in every repo in the org we can
+  # require "Report Result" to pass before merging and this stage can
+  # represent the result of the other checks where it only passes if
+  # all the other checks pass.
+  results:
+    if: ${{ always() && github.event_name == 'pull_request' }}
+    needs: [check-manifest, test, lint]
+    runs-on: ubuntu-latest
+    name: Report Result
+    steps:
+      - run: exit 1
+        # see https://stackoverflow.com/a/67532120/4907315
+        if: >-
+          ${{
+                contains(needs.*.result, 'failure')
+            || contains(needs.*.result, 'cancelled')
+          }}
+

bioio_conversion-0.1.0/.gitignore

@@ -0,0 +1,113 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+env/
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# OS generated files
+.DS_Store
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+.hypothesis/
+.pytest_cache/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+docs/bioio.*rst
+docs/modules.rst
+
+# PyBuilder
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# pyenv
+.python-version
+
+# celery beat schedule file
+celerybeat-schedule
+
+# Dask
+dask-worker-space
+
+# SageMath parsed files
+*.sage.py
+
+# dotenv
+.env
+
+# virtualenv
+.venv
+venv/
+ENV/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+
+# VSCode
+.vscode

bioio_conversion-0.1.0/.pre-commit-config.yaml

@@ -0,0 +1,31 @@
+files: bioio_conversion
+repos:
+
+  - repo: https://github.com/PyCQA/isort
+    rev: 5.12.0
+    hooks:
+      - id: isort
+
+  - repo: https://github.com/myint/autoflake
+    rev: v2.2.0
+    hooks:
+      - id: autoflake
+        args: ["--in-place", "--remove-all-unused-imports"]
+
+  - repo: https://github.com/psf/black
+    rev: 23.3.0
+    hooks:
+      - id: black
+
+  - repo: https://github.com/PyCQA/flake8
+    rev: 6.0.0
+    hooks:
+      - id: flake8
+        additional_dependencies:
+          - flake8-typing-imports>=1.9.0
+          - flake8-pyprojecttoml
+
+  - repo: https://github.com/pre-commit/mirrors-mypy
+    rev: v1.4.1
+    hooks:
+      - id: mypy

bioio_conversion-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,73 @@
+# Contributor Covenant Code of Conduct
+
+## Our Pledge
+
+In the interest of fostering an open and welcoming environment, we as
+contributors and maintainers pledge to making participation in our project and
+our community a harassment-free experience for everyone, regardless of age, body
+size, disability, ethnicity, sex characteristics, gender identity and expression,
+level of experience, education, socio-economic status, nationality, personal
+appearance, race, religion, or sexual identity and orientation.
+
+## Our Standards
+
+Examples of behavior that contributes to creating a positive environment
+include:
+
+-   Using welcoming and inclusive language
+-   Being respectful of differing viewpoints and experiences
+-   Gracefully accepting constructive criticism
+-   Focusing on what is best for the community
+-   Showing empathy towards other community members
+
+Examples of unacceptable behavior by participants include:
+
+-   The use of sexualized language or imagery and unwelcome sexual attention or
+    advances
+-   Trolling, insulting/derogatory comments, and personal or political attacks
+-   Public or private harassment
+-   Publishing others' private information, such as a physical or electronic
+    address, without explicit permission
+-   Other conduct which could reasonably be considered inappropriate in a
+    professional setting
+
+## Our Responsibilities
+
+Project maintainers are responsible for clarifying the standards of acceptable
+behavior and are expected to take appropriate and fair corrective action in
+response to any instances of unacceptable behavior.
+
+Project maintainers have the right and responsibility to remove, edit, or
+reject comments, commits, code, wiki edits, issues, and other contributions
+that are not aligned to this Code of Conduct, or to ban temporarily or
+permanently any contributor for other behaviors that they deem inappropriate,
+threatening, offensive, or harmful.
+
+## Scope
+
+This Code of Conduct applies both within project spaces and in public spaces
+when an individual is representing the project or its community. Examples of
+representing a project or community include using an official project e-mail
+address, posting via an official social media account, or acting as an appointed
+representative at an online or offline event. Representation of a project may be
+further defined and clarified by project maintainers.
+
+## Enforcement
+
+Instances of abusive, harassing, or otherwise unacceptable behavior may be
+reported by contacting any of the maintainers of this project and
+we will attempt to resolve the issues with respect and dignity.
+
+Project maintainers who do not follow or enforce the Code of Conduct in good
+faith may face temporary or permanent repercussions as determined by other
+members of the project's leadership.
+
+## Attribution
+
+This Code of Conduct is adapted from the [Contributor Covenant][homepage], version 1.4,
+available at https://www.contributor-covenant.org/version/1/4/code-of-conduct.html
+
+[homepage]: https://www.contributor-covenant.org
+
+For answers to common questions about this code of conduct, see
+https://www.contributor-covenant.org/faq

bioio_conversion-0.1.0/Justfile

@@ -0,0 +1,52 @@
+# clean all build, python, and lint files
+clean:
+	rm -fr build
+	rm -fr docs/_build
+	rm -fr dist
+	rm -fr .eggs
+	find . -name '*.egg-info' -exec rm -fr {} +
+	find . -name '*.egg' -exec rm -f {} +
+	find . -name '*.pyc' -exec rm -f {} +
+	find . -name '*.pyo' -exec rm -f {} +
+	find . -name '*~' -exec rm -f {} +
+	find . -name '__pycache__' -exec rm -fr {} +
+	rm -fr .coverage coverage.xml htmlcov .pytest_cache .mypy_cache
+
+# install with all deps
+install:
+	pip install -e .[lint,test,docs,dev]
+	pre-commit install
+
+# lint, format, and check all files
+lint:
+	pre-commit run --all-files
+
+# run tests
+test:
+	pytest --cov-report xml --cov-report html --cov=bioio_conversion bioio_conversion/tests
+
+# run lint then tests
+build:
+	just lint
+	just test
+
+# generate Sphinx HTML documentation
+generate-docs:
+	rm -f docs/bioio_conversion*.rst
+	rm -f docs/modules.rst
+	sphinx-apidoc -o docs bioio_conversion **/tests
+	python -msphinx docs docs/_build
+
+# serve docs in browser
+serve-docs:
+	just generate-docs
+	python -m webbrowser -t "file://$(shell pwd | sed 's|\\|/|g')/docs/_build/index.html"
+
+# tag a new version
+tag-for-release version:
+	git tag -a "{{version}}" -m "{{version}}"
+	echo "Tagged: $(git tag --sort=-version:refname | head -n 1)"
+
+# push tags for release
+release:
+	git push --follow-tags

bioio_conversion-0.1.0/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2025, Bio IO Devs
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

bioio_conversion-0.1.0/MANIFEST.in

@@ -0,0 +1,2 @@
+exclude bioio_conversion/tests/**
+prune scripts