{"id":15009305,"url":"https://github.com/vvzen/parse-exr-header","last_synced_at":"2025-04-09T17:23:51.274Z","repository":{"id":45255756,"uuid":"213178302","full_name":"vvzen/parse-exr-header","owner":"vvzen","description":"Pure Python (no additional dependencies) helper module to read metadata from the header of OpenEXR files.","archived":false,"fork":false,"pushed_at":"2024-04-13T23:29:40.000Z","size":33,"stargazers_count":40,"open_issues_count":3,"forks_count":10,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-04-02T20:06:28.802Z","etag":null,"topics":["metadata-extraction","openexr","python","python27","python3","vfx"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vvzen.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-10-06T13:58:26.000Z","updated_at":"2025-03-17T00:25:56.000Z","dependencies_parsed_at":"2024-12-03T16:10:47.368Z","dependency_job_id":"532d73c3-4f3f-444c-9c7e-8501e518e049","html_url":"https://github.com/vvzen/parse-exr-header","commit_stats":{"total_commits":36,"total_committers":4,"mean_commits":9.0,"dds":"0.16666666666666663","last_synced_commit":"d76f7aba51272564e775edbb938c058ba8ffd9d2"},"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvzen%2Fparse-exr-header","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvzen%2Fparse-exr-header/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvzen%2Fparse-exr-header/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vvzen%2Fparse-exr-header/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vvzen","download_url":"https://codeload.github.com/vvzen/parse-exr-header/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248075456,"owners_count":21043590,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["metadata-extraction","openexr","python","python27","python3","vfx"],"created_at":"2024-09-24T19:24:21.336Z","updated_at":"2025-04-09T17:23:51.253Z","avatar_url":"https://github.com/vvzen.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# parse-exr-header\n[![license](https://img.shields.io/github/license/vvzen/parse-exr-header)](https://github.com/vvzen/parse-exr-header/blob/master/LICENSE)\n\n\nPure Python (no additional dependencies) helper functions to read metadata from the header of EXR files.\n\n# Reasons\nIn the VFX world we've got tons of great open source initiatives, like ILM's OpenEXR and Sony's OpenImageIO.\nBoth are great C++ projects (and OIIO also provides bindings for Python), so I definitely recommend using them.\n\nBUT maybe your package manager doesn't have a specific version and compiling them from scratch can be a long process that could get you stuck in many, many different \u0026 non well documented cmake issues.\n\nIf you only need to do something as trivial as reading the metadata of an EXR file and you don't need to do any image manipulation stuff, it's just not worth the hassle.\nThat's why I've written this very small python module (currently ~360 LOCs) that simply reads the header of an exr file, according to the official EXR documentation available here: https://www.openexr.com/documentation/openexrfilelayout.pdf (now moved to https://openexr.com/en/latest/OpenEXRFileLayout.html)\n\n# Dependencies\nOptional, for tests:\n`pytest==4.2.0`\n\nOptional, for formatting:\n`yapf==0.30.0`\n\n# Support\n\n## Python version\nThis repo now supports both Python2.7 and also Python3.8.\nThanks to [jonaskluger](https://github.com/jonaskluger) for providing python3 support.\n\n## Multipart files\nSupport for multipart files is on its way but it will need a bit of work since the original design of this hobby project was a bit naive. A PR is currently pending.\n\n# Install\nThis script is not packaged in any fancy way. Just grab the `parse_metadata.py` and put it wherever you want.\n\n_Update (2021/12/27)_: Now there is also a tiny cli (`bin/vv-exr-metadata`) that you can use, if you want, to list the metadata of a file from a shell session. It supports the wildcard notation (*) if you want to look at multiple files at once.\n\n# Tests\nI'm not a TDD guy (yet) - so there are very few tests. I'm planning to write more of them as soon as I can breathe a little.\nYou can run tests by typing: `pytest tests` from the root dir of this repo.\n\nYou will need also the git submodule that contains all the exr images, so you need to clone the repo like this:\n\n`git clone --recurse-submodules git@github.com:vvzen/parse-exr-header.git`\n\n# PR \u0026 Bugs\nFill free to submit Pull Requests if you notice anything wrong. I'm more than happy to merge them and adapt them to my coding style (which is just PEP8 stuff with some additional things like lowercase functions args in order to distinguish arguments from variables inside the scope of a function - very useful in my opinion and blog post coming soon).\n\nNote: Whenever you submit a PR, the CI should automatically run the tests for you using Github Actions.\n\n### Formatting\nI use [yapf](https://github.com/google/yapf) to end all style wars and let it do all of the formatting for me. After you made a PR, you can run it like this:\n```\nyapf --in-place src/*.py\n```\n\nThis of course requires you to have `yapf` installed locally or somewhere in your `$PATH`.\nYapf will simply read the `.style.yapf` file that is hosted in this repo and format the file according to these rules.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvvzen%2Fparse-exr-header","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvvzen%2Fparse-exr-header","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvvzen%2Fparse-exr-header/lists"}