{"id":20625736,"url":"https://github.com/python-pillow/pillow-perf","last_synced_at":"2025-04-15T15:10:45.343Z","repository":{"id":42360618,"uuid":"59910423","full_name":"python-pillow/pillow-perf","owner":"python-pillow","description":"Pillow Performance Tests","archived":false,"fork":false,"pushed_at":"2024-06-17T22:32:51.000Z","size":36375,"stargazers_count":18,"open_issues_count":22,"forks_count":8,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-04-09T09:51:43.010Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://python-pillow.org/pillow-perf/","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/python-pillow.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}},"created_at":"2016-05-28T19:08:59.000Z","updated_at":"2024-09-11T08:19:30.000Z","dependencies_parsed_at":"2023-02-14T07:15:56.010Z","dependency_job_id":"856f56d2-d674-4a31-9a94-4f10c7ce5043","html_url":"https://github.com/python-pillow/pillow-perf","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/python-pillow%2Fpillow-perf","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/python-pillow%2Fpillow-perf/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/python-pillow%2Fpillow-perf/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/python-pillow%2Fpillow-perf/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/python-pillow","download_url":"https://codeload.github.com/python-pillow/pillow-perf/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249094932,"owners_count":21211837,"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":[],"created_at":"2024-11-16T13:10:47.235Z","updated_at":"2025-04-15T15:10:45.325Z","avatar_url":"https://github.com/python-pillow.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Test Suites\n\n[![Test](https://github.com/python-pillow/pillow-perf/workflows/Test/badge.svg)](https://github.com/python-pillow/pillow-perf/actions)\n\nPerformance tests divided into suites.\n\n### Prerequisites\n\n* [Any Pillow version](https://pillow.readthedocs.io/en/latest/installation.html#basic-installation)\n* [ImageMagick dev package for Wand](http://docs.wand-py.org/en/0.4.4/#requirements)\n* OpenCV for Python, for example through\n[opencv-python](https://pypi.org/project/opencv-python/) binary package\n\n### Install and run\n\n```bash\n$ cd testsuite\n$ pip install -r ./requirements.txt\n$ ./run.py test_suite [test_suite ...]\n```\n\n`test_suite` is one of available test suites:\n\n```\nload, convert, composition, rotate_right, scale,\nblur, wand_load, wand_convert, wand_composition,\nwand_rotate_right, wand_scale, wand_blur, cv2_load,\ncv2_rotate_right, cv2_scale, cv2_blur\n```\n\nThe list can grow, please refer to:\n\n```bash\n$ ./run.py --help\n```\n\n### CLI\n\n```bash\n$ ./run.py scale --progress\n$ ./run.py scale --mode RGBA\n$ ./run.py scale --runs 50\n$ ./run.py scale --size 512x512\n```\n\nFor some suites the chosen mode (`scale`, `blur`) does matter,\nwhile others (`convert`, `composition`) work regardless of current mode.\n\n\n# Automatic test\n\nAutomatic test launches test suites against relevant Pillow versions\nincluding SSE4 and AVX2.\nCurrently it only works on Linux Ubuntu.\n\nYou have two ways to run the test:\nVagrant or host (tested on Ubuntu 14.04 and 16.04).\n\n### Run in Vagrant\n\nPlease, ensure that you are using Vagrant version 1.8.7 or later.\n\n```bash\n$ cd auto\n$ vagrant up\n```\n\nIt will automatically start a full test\nwhich can take over 10 minutes.\nRun the test again:\n\n```bash\n$ vagrant provision --provision-with run\n```\n\n### Run on the host\n\nFirst you need to install the prerequisites:\n\n```bash\n$ cd auto\n$ sudo ./install_ubuntu.sh\n```\n\nScript options:\n\n```bash\n$ cd auto\n$ ./run.sh                # Run all tests\n$ ./run.sh no             # Skip AVX2 tests\n$ ./run.sh - --json       # Pass extra arguments to test suite\n$ ./run.sh no --json      # Pass extra arguments and skip AVX2 tests\n$ CC=\"ccache cc\" ./run.sh # Speed up subsequent builds using CC cache\n```\n\n### Submit results\n\n1. Before running any tests, please ensure that\nyou have exited all browsers on the host machine,\nclosed all audio players and stopped any backup systems.\nThe full test lasts up to 15 minutes.\n\n2. Run [automatic test](#automatic-test) with `--json` option.\nPlease avoid custom `--size`, `--mode` and `--runs` settings.\n\n    ```bash\n    $ ./run.sh - --json\n    ```\n\n3. Collect the following information about your system:\nname, OS version, CPU. For example:\n\n    * Name: MacBook Pro (Retina, 13-inch, Late 2013)\n    * OS: Ubuntu 14.04.4 LTS 64bit\n    * CPU: Intel® Core™ i5-4258U CPU @ 2.40GHz\n\n4. Create an [issue](https://github.com/python-pillow/pillow-perf/issues)\nwith the collected information and test output.\n\n\n# Docs\n\nThe docs can be found on the [public page](https://python-pillow.org/pillow-perf/)\nwith benchmark results and details.\n\n### Build once\n\n```bash\n$ cd docs\n$ npm install\n$ npm run build\n```\n\n### Serve locally \u0026 rebuild\n\n```bash\n$ python3 -m http.server \u0026\n$ npm run watch\n```\n\n`--watch-poll` will help if you have any problems with auto reload.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpython-pillow%2Fpillow-perf","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpython-pillow%2Fpillow-perf","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpython-pillow%2Fpillow-perf/lists"}