{"id":34083828,"url":"https://github.com/promto-c/tabler-qicon","last_synced_at":"2026-03-17T20:12:39.475Z","repository":{"id":184321345,"uuid":"671667351","full_name":"promto-c/tabler-qicon","owner":"promto-c","description":"Python package that provides easy access to Tabler Icons for PyQt and PySide applications.","archived":false,"fork":false,"pushed_at":"2024-03-12T17:03:42.000Z","size":2382,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-12-16T15:36:21.016Z","etag":null,"topics":["icons","pyqt","pyqt-icons","pyqt5","pyqt6","pyside2","pyside6","qicon","qt-icons","qtpy","tabler","tabler-icons","tabler-qicon"],"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/promto-c.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2023-07-27T21:22:09.000Z","updated_at":"2024-08-11T04:44:21.000Z","dependencies_parsed_at":"2023-07-27T23:47:16.843Z","dependency_job_id":"b4448cc1-88da-485e-a8ac-e4044e40d06e","html_url":"https://github.com/promto-c/tabler-qicon","commit_stats":{"total_commits":58,"total_committers":2,"mean_commits":29.0,"dds":"0.12068965517241381","last_synced_commit":"25bb35f98cb3b384db585cca224c3ea60717f8e3"},"previous_names":["promto-c/tabler-qicon"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/promto-c/tabler-qicon","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/promto-c%2Ftabler-qicon","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/promto-c%2Ftabler-qicon/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/promto-c%2Ftabler-qicon/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/promto-c%2Ftabler-qicon/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/promto-c","download_url":"https://codeload.github.com/promto-c/tabler-qicon/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/promto-c%2Ftabler-qicon/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30630274,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-17T17:32:55.572Z","status":"ssl_error","status_checked_at":"2026-03-17T17:32:38.732Z","response_time":56,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["icons","pyqt","pyqt-icons","pyqt5","pyqt6","pyside2","pyside6","qicon","qt-icons","qtpy","tabler","tabler-icons","tabler-qicon"],"created_at":"2025-12-14T12:58:13.928Z","updated_at":"2026-03-17T20:12:39.470Z","avatar_url":"https://github.com/promto-c.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Tabler QIcon\n\n\u003c!-- Badges --\u003e\n[![GitHub](https://img.shields.io/github/license/promto-c/tabler-qicon)](https://github.com/promto-c/tabler-qicon/blob/main/LICENSE)\n[![GitHub Repo](https://img.shields.io/badge/GitHub-Repo-blue.svg)](https://github.com/promto-c/tabler-qicon)\n[![PyPI Version](https://img.shields.io/pypi/v/tabler-qicon)](https://pypi.org/project/tabler-qicon/)\n\n`Tabler QIcon` is a Python package that provides easy access to [Tabler Icons](https://tabler-icons.io/) [[Preview]](https://tabler-icons.io/) [[GitHub]](https://github.com/tabler/tabler-icons) for PyQt and PySide applications. It uses SVGs from Tabler Icons and converts them into QIcon objects, which can be used in PyQt and PySide applications.\n\nThis package also supports icon customization such as changing color, size, view box size, stroke width, opacity, and applying transformations like flip and flop.\n\n`Tabler QIcon v0.3.0` is currently synced with [tabler-icons](https://github.com/tabler/tabler-icons) version 3.0. Please refer to the [update.log](./tablerqicon/icons/update.log) file for more details on the last sync.\n\u003cdetails\u003e\n  \u003csummary\u003e\u003cb\u003ePreview icons\u003c/b\u003e\u003c/summary\u003e\n\n  ![Tabler Icons](https://raw.githubusercontent.com/tabler/tabler-icons/master/.github/preview/icons-outline.png)\n\n\u003c/details\u003e\n\n## 🚀 Features\n\n- **Customizable Icons**: Adjust color, size, view box size, stroke width, opacity, and apply transformations like flip and flop.\n- **Developer-Friendly**: Python stubs enhance code autocompletion and type-checking in your IDE.\n  Code Autocompletion\n    ![Code Autocompletion](https://raw.githubusercontent.com/promto-c/tabler-qicon/main/screenshots/autocompletion_screenshot.png)\n- **Broad Compatibility**: Supports PyQt5, PyQt6, PySide2, and PySide6.\n- **Transformation Features**: Flip and flop transformations can be applied to icons easily. (introduced in v0.2.2)\n\n## 📋 Prerequisites\n\n- Python 3.7 or later\n- One of the following: PyQt5, PyQt6, PySide2, or PySide6\n\n## 💻 Installation\n\nYou can install `tabler-qicon` from PyPI using pip:\n\n```bash\npip install tabler-qicon\n```\n\nAlternatively, you can install it directly from the GitHub repository:\n\n```bash\npip install git+https://github.com/promto-c/tabler-qicon.git\n```\n\nUsing PyQt5? Install it separately:\n\n```bash\npip install PyQt5\n```\n\n## 🖌️ Usage\n\n### Setting the Backend\n\n#### Using Environment Variables (with `qtpy`)\n\nIf you're using `qtpy` to maintain compatibility across different PyQt/PySide backends, you'll need to specify the backend before importing other modules:\n\n```python\nimport os\nos.environ['QT_API'] = 'PyQt5'  # Change 'PyQt5' to your desired backend\n\nfrom tablerqicon import TablerQIcon\n\n# ... Additional code ...\n```\n\n#### Using the `use_backend` method\n\nAlternatively, you can also set the backend directly using the `use_backend` method:\n\n```python\nimport tablerqicon\ntablerqicon.use_backend('PyQt5')\n\nfrom tablerqicon import TablerQIcon\n\n# ... Additional code ...\n```\n\n### Default Usage\n\nDirectly access icons with default properties:\n\n```python\nfrom PyQt5 import QtWidgets\nfrom tablerqicon import TablerQIcon\n\n# ... Additional code ...\n\nrefresh_button = QtWidgets.QPushButton(\"Refresh\")\n\n# Set the QIcon for the refresh_button using the 'refresh' icon name as an attribute\nrefresh_button.setIcon(TablerQIcon.refresh)\n```\n\n### Customized Icons\n\n1. Instantiate `TablerQIcon` with your desired properties.\n2. Access icons using icon names.\n3. Utilize `flip` and `flop` transformations for versatile usage of icons.\n\n```python\nfrom PyQt5 import QtWidgets\nfrom tablerqicon import TablerQIcon\n\n# ... Additional code ...\n\n# Example: Using a custom opacity\ntabler_icon = TablerQIcon(opacity=0.6)\n\nrefresh_button = QtWidgets.QPushButton('Refresh')\nword_wrap_button = QtWidgets.QPushButton('Word Wrap')\nplay_backward_button = QtWidgets.QPushButton('Play Backward')\n\n# Set the QIcon for the refresh_button using the 'refresh' icon name as an attribute\nrefresh_button.setIcon(tabler_icon.refresh)\n# Set the QIcon for the word_wrap_button using the 'text_wrap' icon name as an attribute\nword_wrap_button.setIcon(tabler_icon.text_wrap)\n# Applying flip and flop transformations before setting the icon\nplay_backward_button.setIcon(tabler_icon.flip.flop.player_play)\n```\n\n### Retrieve All Icon Names\n\n```python\nprint(TablerQIcon.get_icon_names())\n```\n\n## 🛠️ Development\n\n### Syncing Icons\nTo sync icons, we use a shell script that clones the icons from the `tabler-icons` repository and generates a `.pyi` file to facilitate type hints and autocompletion in IDEs.\n\nIf you are a contributor or a developer working on this project and need to sync icons, follow the steps below:\n\n1. **Run the Sync Script:**\n   ```bash\n   ./sync_tabler_icons.sh\n   ```\n   This script will:\n   - Clone the latest icons from the `tabler-icons` repository.\n   - Copy the icons to the target directory.\n   - Generate a `.pyi` file to facilitate type hints and autocompletion.\n\n2. **Check the Update Log:**\n   After running the script, check the `update.log` file in the `icons` directory to ensure that the sync was successful and to view details of the sync.\n\n3. **Commit Changes:**\n   After successfully syncing the icons and generating the `.pyi` file, commit these changes to the version control system.\n\n### Note to Contributors\n- Please do not edit the generated `.pyi` file directly. It is auto-generated by the sync script.\n- Ensure that you have run the sync script and tested the changes locally before submitting a pull request.\n\n### Running Tests\nRun the tests to ensure that your changes do not break existing functionality.\n```bash\npytest tests\n```\n\n## 🖋️ Coding Style\n\nAdhering to PEP 8 with [flake8](https://flake8.pycqa.org/en/latest/) oversight. Auto-formatting via [yapf](https://github.com/google/yapf). Our docstrings embrace the [Google Python Style Guide](https://google.github.io/styleguide/pyguide.html) for clarity and consistency.\n\n## 📜 License\n\n`Tabler QIcon` is licensed under the [MIT License](LICENSE).\n\n\u003e **Note:** This `README.md` file was generated by ChatGPT.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpromto-c%2Ftabler-qicon","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpromto-c%2Ftabler-qicon","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpromto-c%2Ftabler-qicon/lists"}