{"id":13648306,"url":"https://github.com/d0c-s4vage/pfp","last_synced_at":"2025-04-05T13:05:16.789Z","repository":{"id":29385936,"uuid":"32920954","full_name":"d0c-s4vage/pfp","owner":"d0c-s4vage","description":"pfp - Python Format Parser - a python-based 010 Editor template interpreter","archived":false,"fork":false,"pushed_at":"2023-07-19T05:02:06.000Z","size":17655,"stargazers_count":195,"open_issues_count":49,"forks_count":37,"subscribers_count":18,"default_branch":"master","last_synced_at":"2025-03-29T12:08:38.116Z","etag":null,"topics":["010editor","binary-data","dataparsing","interpreter","python"],"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/d0c-s4vage.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2015-03-26T10:27:05.000Z","updated_at":"2025-02-16T15:33:17.000Z","dependencies_parsed_at":"2022-09-02T08:32:38.191Z","dependency_job_id":"589360bb-a7b2-4117-95d1-69552aeb2839","html_url":"https://github.com/d0c-s4vage/pfp","commit_stats":{"total_commits":212,"total_committers":6,"mean_commits":"35.333333333333336","dds":"0.49056603773584906","last_synced_commit":"0b2045b76346ff576115bd148e0e5aa19ba21420"},"previous_names":[],"tags_count":37,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d0c-s4vage%2Fpfp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d0c-s4vage%2Fpfp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d0c-s4vage%2Fpfp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/d0c-s4vage%2Fpfp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/d0c-s4vage","download_url":"https://codeload.github.com/d0c-s4vage/pfp/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247339155,"owners_count":20923014,"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":["010editor","binary-data","dataparsing","interpreter","python"],"created_at":"2024-08-02T01:04:07.871Z","updated_at":"2025-04-05T13:05:16.767Z","avatar_url":"https://github.com/d0c-s4vage.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"[![Master Build Status](https://travis-ci.org/d0c-s4vage/pfp.svg?branch=master)](https://travis-ci.org/d0c-s4vage/pfp)\n[![PyPI Statistics](https://img.shields.io/pypi/dm/pfp)](https://pypistats.org/packages/pfp)\n[![Latest Release](https://img.shields.io/pypi/v/pfp)](https://pypi.python.org/pypi/pfp/)\n[![Documentation Status](https://readthedocs.org/projects/pfp/badge/?version=latest)](https://pfp.readthedocs.io/en/latest/)\n[![Coverage Status](https://coveralls.io/repos/github/d0c-s4vage/pfp/badge.svg?branch=master)](https://coveralls.io/github/d0c-s4vage/pfp?branch=master)\n\n[![Twitter Follow](https://img.shields.io/twitter/follow/d0c_s4vage?style=plastic)](https://twitter.com/d0c_s4vage)\n\n# pfp\n\n`pfp` is a python-based interpreter for 010 template scripts.\n\nSee the main documentation on [Read the Docs](http://pfp.readthedocs.org/en/latest/)\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md)\n\n## Installation\n\nInstall pfp with\n\n\tpip install --upgrade pfp\n\n## Tl;DR\n\n### CLI\n\n```bash\npfp -t path/to/template input_file\n```\n\nAll available options for the pfp CLI:\n\n```\nusage: pfp [-h] -t TEMPLATE [--show-offsets] [-k] input\n\nRun pfp on input data using a specified 010 Editor template for parsing\n\npositional arguments:\n  input                 The input data stream or file to parse. Use '-' for\n                        piped data\n\noptional arguments:\n  -h, --help            show this help message and exit\n  -t TEMPLATE, --template TEMPLATE\n                        The template to parse with\n  --show-offsets        Show offsets in the parsed data of parsed fields\n  -k, --keep            Keep successfully parsed data on error\n```\n\n### Python Library\n\nThis should get you started parsing something using 010 templates:\n\n```python\nimport pfp\n\ndom = pfp.parse(\n\tdata_file=\"~/Desktop/image.png\",\n\ttemplate_file=\"~/Desktop/PNGTemplate.bt\"\n)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd0c-s4vage%2Fpfp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fd0c-s4vage%2Fpfp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fd0c-s4vage%2Fpfp/lists"}