ctk-theme-builder 3.2.3__tar.gz

ctk_theme_builder-3.2.3/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023 avalon60 (Clive Bostock)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

ctk_theme_builder-3.2.3/PKG-INFO

@@ -0,0 +1,132 @@
+Metadata-Version: 2.4
+Name: ctk-theme-builder
+Version: 3.2.3
+Summary: A desktop theme editor for building and previewing CustomTkinter themes.
+License-Expression: MIT
+License-File: LICENSE
+Keywords: customtkinter,tkinter,theme,gui,desktop
+Author: Clive Bostock
+Requires-Python: >=3.10,<3.14
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: X11 Applications
+Classifier: Environment :: Win32 (MS Windows)
+Classifier: Environment :: MacOS X
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: MacOS
+Classifier: Operating System :: Microsoft :: Windows
+Classifier: Operating System :: POSIX :: Linux
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Software Development :: User Interfaces
+Requires-Dist: CTkMessagebox (==2.5)
+Requires-Dist: bump2version (>=1.0.1,<2.0.0)
+Requires-Dist: colorharmonies (==1.0.5)
+Requires-Dist: colour (==0.1.5)
+Requires-Dist: contourpy (==1.3.2)
+Requires-Dist: ctkfontawesome[images] (>=0.6.0,<0.7.0)
+Requires-Dist: ctktooltip (==0.9)
+Requires-Dist: customtkinter (==5.2.2)
+Requires-Dist: cycler (==0.12.1)
+Requires-Dist: darkdetect (==0.8.0)
+Requires-Dist: distro (==1.9.0)
+Requires-Dist: fonttools (==4.59.0)
+Requires-Dist: importlib-resources (==6.1.1)
+Requires-Dist: kiwisolver (==1.4.8)
+Requires-Dist: loguru (==0.7.2)
+Requires-Dist: matplotlib (==3.10.5)
+Requires-Dist: numpy (==2.2.6)
+Requires-Dist: packaging (==23.2)
+Requires-Dist: pathvalidate (==3.2.0)
+Requires-Dist: pillow (==11.3.0)
+Requires-Dist: pyparsing (==3.1.1)
+Requires-Dist: pyperclip (==1.8.2)
+Requires-Dist: python-dateutil (==2.8.2)
+Requires-Dist: scikit-build (==0.17.6)
+Requires-Dist: six (==1.16.0)
+Requires-Dist: tomli (==2.0.1)
+Requires-Dist: zipp (==3.15.0)
+Project-URL: Homepage, https://github.com/avalon60/ctk_theme_builder
+Project-URL: Issues, https://github.com/avalon60/ctk_theme_builder/issues
+Project-URL: Repository, https://github.com/avalon60/ctk_theme_builder
+Description-Content-Type: text/markdown
+
+# CTk Theme Builder
+
+CTk Theme Builder is a desktop editor for creating, previewing, and refining themes for [CustomTkinter](https://github.com/TomSchimansky/CustomTkinter) applications.
+
+It provides a live preview workflow for adjusting colours, geometry, palettes, and theme metadata without editing theme JSON files by hand.
+
+## Features
+
+- Visual theme editing with live preview
+- Support for light and dark theme variants
+- Theme geometry editing for supported widget properties
+- Palette management and colour harmonics tools
+- Theme merge and import/export support
+- Provenance tracking for theme metadata
+- Built-in theme and palette assets to get started quickly
+
+## Installation
+
+Recommended installation from PyPI, using a virtual environment:
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install ctk-theme-builder
+```
+
+On Windows PowerShell:
+
+```powershell
+python -m venv .venv
+.venv\Scripts\Activate.ps1
+pip install ctk-theme-builder
+```
+
+Alternative install methods for users who already use `uv`:
+
+```bash
+uv pip install ctk-theme-builder
+uvx --from ctk-theme-builder ctk-theme-builder
+```
+
+## Usage
+
+Launch the application:
+
+```bash
+ctk-theme-builder
+```
+
+Optional command-line arguments:
+
+```bash
+ctk-theme-builder --set-appearance Dark
+ctk-theme-builder --set-theme /path/to/theme.json
+```
+
+To migrate themes and palettes from a legacy installation:
+
+```bash
+ctktb-migrate-assets /path/to/old/install
+```
+
+## Requirements
+
+- Python 3.10 to 3.13
+- A desktop environment capable of running Tk-based GUI applications
+
+## Documentation
+
+- Installation and upgrade notes: [docs/installs-upgrades.md](docs/installs-upgrades.md)
+- User guides and release notes: [project wiki](https://github.com/avalon60/ctk_theme_builder/wiki)
+- Source code and issue tracker: [GitHub repository](https://github.com/avalon60/ctk_theme_builder)
+
+## Licence
+
+Released under the MIT Licence. See [LICENSE](LICENSE).
+

ctk_theme_builder-3.2.3/README.md

@@ -0,0 +1,76 @@
+# CTk Theme Builder
+
+CTk Theme Builder is a desktop editor for creating, previewing, and refining themes for [CustomTkinter](https://github.com/TomSchimansky/CustomTkinter) applications.
+
+It provides a live preview workflow for adjusting colours, geometry, palettes, and theme metadata without editing theme JSON files by hand.
+
+## Features
+
+- Visual theme editing with live preview
+- Support for light and dark theme variants
+- Theme geometry editing for supported widget properties
+- Palette management and colour harmonics tools
+- Theme merge and import/export support
+- Provenance tracking for theme metadata
+- Built-in theme and palette assets to get started quickly
+
+## Installation
+
+Recommended installation from PyPI, using a virtual environment:
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install ctk-theme-builder
+```
+
+On Windows PowerShell:
+
+```powershell
+python -m venv .venv
+.venv\Scripts\Activate.ps1
+pip install ctk-theme-builder
+```
+
+Alternative install methods for users who already use `uv`:
+
+```bash
+uv pip install ctk-theme-builder
+uvx --from ctk-theme-builder ctk-theme-builder
+```
+
+## Usage
+
+Launch the application:
+
+```bash
+ctk-theme-builder
+```
+
+Optional command-line arguments:
+
+```bash
+ctk-theme-builder --set-appearance Dark
+ctk-theme-builder --set-theme /path/to/theme.json
+```
+
+To migrate themes and palettes from a legacy installation:
+
+```bash
+ctktb-migrate-assets /path/to/old/install
+```
+
+## Requirements
+
+- Python 3.10 to 3.13
+- A desktop environment capable of running Tk-based GUI applications
+
+## Documentation
+
+- Installation and upgrade notes: [docs/installs-upgrades.md](docs/installs-upgrades.md)
+- User guides and release notes: [project wiki](https://github.com/avalon60/ctk_theme_builder/wiki)
+- Source code and issue tracker: [GitHub repository](https://github.com/avalon60/ctk_theme_builder)
+
+## Licence
+
+Released under the MIT Licence. See [LICENSE](LICENSE).