iconipy


Nameiconipy JSON
Version 0.3.2 PyPI version JSON
download
home_pageNone
SummaryCreate icons for user interfaces directly from your Python code.
upload_time2024-08-09 22:24:45
maintainerNone
docs_urlNone
authorNone
requires_python>=3.8
licenseNone
keywords ui gui icons image icon
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # iconipy
Say goodbye to the tedious hassle of graphic programs! Now you can create stunning icons directly from your code. With the look and feel defined right in the code, adjustments are a breeze. Plus, the included icon sets can easily be expanded with your own sets based on font files. 🎨✨

**Installation**

    pip install iconipy

**Usage**

First you initialize an "IconFactory" with an icon set and look-and-feel settings like this:

    from iconipy import IconFactory 
    
    create_button_icon = IconFactory(
                            icon_set = 'lucide', 
                            icon_size = 64, 
                            font_size = 38,  
                            font_color = (0, 0, 0, 255), # black solid
                            outline_color = 'dimgrey', 
                            outline_width = 6,
                            background_color = 'silver', 
                            background_radius = 10
    ) 
    
Then you create your icons: 

    icon_home = create_button_icon.asPil('house') # PIL Image
    icon_reload = create_button_icon.asQPixmap('refresh-cw') # Qt based frameworks
    icon_files = create_button_icon.asTkPhotoImage('files') # tkinter, ttkbootstrap, PySimpleGUI, FreeSimpleGUI
    icon_exit_app = create_button_icon.asRawList('log-out') # DearPyGUI

Depending on your GUI toolkit's whims, you can create PIL Image Objects, ByteIO Objects, Byte-Strings, Raw Pixel Lists, TkPhotoImage Objects, QImage Objects, save to file, and more.

You need to preview an icon? Here we go:

    create_button_icon.show('house')

The icon sets you can choose from include: lucide, boxicons, lineicons, material_icons_regular, material_icons_round_regular, material_icons_sharp_regular, and material_icons_outlined_regular.

Feeling adventurous? Dump all the icons to your hard drive and explore:

    create_button_icon.saveAll(<path to target directory>)

You need a hand? Check what the icon set has to offer:

    print(create_button_icon.search('hand'))

Just want a list with all icon names? No problem:

    print(create_button_icon.icon_names)
        
**More info**
    
Visit https://github.com/digidigital/iconipy or https://iconipy.digidigital.de for sample code for the most popular GUI toolkits and detailed documentation.

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "iconipy",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.8",
    "maintainer_email": null,
    "keywords": "UI, GUI, icons, image, icon",
    "author": null,
    "author_email": "Bj\u00f6rn Seipel <support@digidigital.de>",
    "download_url": "https://files.pythonhosted.org/packages/e2/66/018c0bdc0eb999c55a9b3ec8b3480f56f3739208578c4af9585b9ebf65eb/iconipy-0.3.2.tar.gz",
    "platform": null,
    "description": "# iconipy\nSay goodbye to the tedious hassle of graphic programs! Now you can create stunning icons directly from your code. With the look and feel defined right in the code, adjustments are a breeze. Plus, the included icon sets can easily be expanded with your own sets based on font files. \ud83c\udfa8\u2728\n\n**Installation**\n\n    pip install iconipy\n\n**Usage**\n\nFirst you initialize an \"IconFactory\" with an icon set and look-and-feel settings like this:\n\n    from iconipy import IconFactory \n    \n    create_button_icon = IconFactory(\n                            icon_set = 'lucide', \n                            icon_size = 64, \n                            font_size = 38,  \n                            font_color = (0, 0, 0, 255), # black solid\n                            outline_color = 'dimgrey', \n                            outline_width = 6,\n                            background_color = 'silver', \n                            background_radius = 10\n    ) \n    \nThen you create your icons: \n\n    icon_home = create_button_icon.asPil('house') # PIL Image\n    icon_reload = create_button_icon.asQPixmap('refresh-cw') # Qt based frameworks\n    icon_files = create_button_icon.asTkPhotoImage('files') # tkinter, ttkbootstrap, PySimpleGUI, FreeSimpleGUI\n    icon_exit_app = create_button_icon.asRawList('log-out') # DearPyGUI\n\nDepending on your GUI toolkit's whims, you can create PIL Image Objects, ByteIO Objects, Byte-Strings, Raw Pixel Lists, TkPhotoImage Objects, QImage Objects, save to file, and more.\n\nYou need to preview an icon? Here we go:\n\n    create_button_icon.show('house')\n\nThe icon sets you can choose from include: lucide, boxicons, lineicons, material_icons_regular, material_icons_round_regular, material_icons_sharp_regular, and material_icons_outlined_regular.\n\nFeeling adventurous? Dump all the icons to your hard drive and explore:\n\n    create_button_icon.saveAll(<path to target directory>)\n\nYou need a hand? Check what the icon set has to offer:\n\n    print(create_button_icon.search('hand'))\n\nJust want a list with all icon names? No problem:\n\n    print(create_button_icon.icon_names)\n        \n**More info**\n    \nVisit https://github.com/digidigital/iconipy or https://iconipy.digidigital.de for sample code for the most popular GUI toolkits and detailed documentation.\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "Create icons for user interfaces directly from your Python code.",
    "version": "0.3.2",
    "project_urls": {
        "Documentation": "https://iconipy.digidigital.de",
        "Homepage": "https://github.com/digidigital/iconipy",
        "Issues": "https://github.com/digidigital/iconipy/issues",
        "SampleCode": "https://github.com/digidigital/iconipy/tree/main/demo_programs"
    },
    "split_keywords": [
        "ui",
        " gui",
        " icons",
        " image",
        " icon"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "a8272b14ec45d042487465c5639d4de54c71c281cea789c9cecb7b8dfb1644e2",
                "md5": "de9d38e2c8569b484cf353d175a6b020",
                "sha256": "73677eb389a3839dd7a7a9611d8447cb8ef15caee7376f58e5d19ae0409d89a7"
            },
            "downloads": -1,
            "filename": "iconipy-0.3.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "de9d38e2c8569b484cf353d175a6b020",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.8",
            "size": 1428918,
            "upload_time": "2024-08-09T22:24:42",
            "upload_time_iso_8601": "2024-08-09T22:24:42.935867Z",
            "url": "https://files.pythonhosted.org/packages/a8/27/2b14ec45d042487465c5639d4de54c71c281cea789c9cecb7b8dfb1644e2/iconipy-0.3.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "e266018c0bdc0eb999c55a9b3ec8b3480f56f3739208578c4af9585b9ebf65eb",
                "md5": "1f85266ddc39434f760f0b7a5b143946",
                "sha256": "f8af79f866da501a68744ae4578ae909fc682e935a7ce44e84934bd1da592e9e"
            },
            "downloads": -1,
            "filename": "iconipy-0.3.2.tar.gz",
            "has_sig": false,
            "md5_digest": "1f85266ddc39434f760f0b7a5b143946",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.8",
            "size": 1434652,
            "upload_time": "2024-08-09T22:24:45",
            "upload_time_iso_8601": "2024-08-09T22:24:45.579219Z",
            "url": "https://files.pythonhosted.org/packages/e2/66/018c0bdc0eb999c55a9b3ec8b3480f56f3739208578c4af9585b9ebf65eb/iconipy-0.3.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2024-08-09 22:24:45",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "digidigital",
    "github_project": "iconipy",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "lcname": "iconipy"
}
        
Elapsed time: 1.25978s