{"id":24064132,"url":"https://github.com/liu-yucheng/aidesign-widgets","last_synced_at":"2025-02-26T17:21:18.960Z","repository":{"id":100692901,"uuid":"384843163","full_name":"liu-yucheng/AIDesign-Widgets","owner":"liu-yucheng","description":"AIDesign Widget Collection Application","archived":false,"fork":false,"pushed_at":"2023-10-18T07:14:43.000Z","size":238,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-09T10:07:10.118Z","etag":null,"topics":["app-collection","efficiency","gnu-gplv3","gpl3","gplv3","image-processing","pillow","python","python3","text-processing","widget-collection","widgets"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/liu-yucheng.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}},"created_at":"2021-07-11T02:18:04.000Z","updated_at":"2024-05-24T03:51:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"97137864-b35f-4e0b-892b-fd51bc80d4a0","html_url":"https://github.com/liu-yucheng/AIDesign-Widgets","commit_stats":null,"previous_names":[],"tags_count":51,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liu-yucheng%2FAIDesign-Widgets","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liu-yucheng%2FAIDesign-Widgets/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liu-yucheng%2FAIDesign-Widgets/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/liu-yucheng%2FAIDesign-Widgets/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/liu-yucheng","download_url":"https://codeload.github.com/liu-yucheng/AIDesign-Widgets/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240898755,"owners_count":19875249,"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":["app-collection","efficiency","gnu-gplv3","gpl3","gplv3","image-processing","pillow","python","python3","text-processing","widget-collection","widgets"],"created_at":"2025-01-09T10:07:13.652Z","updated_at":"2025-02-26T17:21:18.934Z","avatar_url":"https://github.com/liu-yucheng.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!---\nCopyright 2022 Yucheng Liu. GNU GPL3 license.\nGNU GPL3 license copy: https://www.gnu.org/licenses/gpl-3.0.txt\nFirst added by username: liu-yucheng\nLast updated by username: liu-yucheng\n---\u003e\n\n# AIDesign-Widgets\n\nAIDesign widget collection application.\n\n# Installation (Using `pip`)\n\n1. Go to the root directory of this repository.\n2. If you are using GUI, open a command line window in the directory.\n3. Run the `pip install -r ./requirement.txt` command. This will install the dependencies.\n4. See below. Choose your installation type and follow the instructions.\n\n## Editable Installation\n\n1. Run the `pip install -e ./` command. This will install the application under the editable mode.\n2. If you change the source code, you do not need to reinstall the package to reflect the changes.\n\n## ~~Deployment Installation~~ (Temporarily Unavailable)\n\n1. ~~Run the `pip install ./` command. This will install the application.~~\n2. ~~If you need to update the app or change the code, you will need to reinstall the package.~~\n\n# Usage (From Command Line Shell)\n\n`widgets`: The main command, which provides you the access to all the subcommands of the app.\n\n`widgets help`: The help subcommand, which tells you the details about how to use the app.\n\n# `widgets help` Help Page\n\n```powershell\n\u003e widgets help\nUsage: widgets \u003ccommand\u003e ...\n==== Commands ====\nhelp:\n    When:   You need help info. For example, now.\n    How-to: widgets help\ninfo:\n    When:   You need package info.\n    How-to: widgets info\ngrid-crop:\n    When:   You want to crop a large image into small pieces, with the crop positions having a grid-like alignment.\n    How-to: widgets grid-crop\nrand-crop:\n    When:   You want to crop a large image into small pieces, with randomly picked crop positions.\n    How-to: widgets rand-crop\npath-name:\n    When:   You want to show a path name as an escaped string with quotes, which can be directly used in JSON.\n    How-to: widgets path-name \u003crelative-path\u003e\nbulk-crop:\n    When:   You want to crop all the images in a folder and save the crops into subfolders of another folder.\n    How-to: widgets bulk-crop \u003ccommand\u003e ...\n    ==== Commands ====\n    grid:\n        When:   You want to start a bulk grid cropping session.\n        How-to: widgets bulk-crop grid\n    rand:\n        When:   You want to start a bulk random cropping session.\n        How-to: widgets bulk-crop rand\n```\n\n# Dependencies\n\nSee `\u003cthis-repo\u003e/requirements.txt`.\n\n# Testing\n\nYou can test this application by running `python \u003cthis-repo\u003e/test_all.py`.\n\n# Python Code Style\n\nFollows [PEP8](https://peps.python.org/pep-0008/) with the exceptions shown in the following VSCode `settings.json` code fragment.\n\n```json\n{\n  ...,\n  \"python.formatting.provider\": \"autopep8\",\n  \"python.formatting.autopep8Args\": [\n    \"--max-line-length=119\"\n  ],\n  \"python.linting.enabled\": true,\n  \"python.linting.pycodestyleEnabled\": true,\n  \"python.linting.pycodestyleArgs\": [\n    \"--max-line-length=119\"\n  ],\n  ...\n}\n```\n\n# Other `README` Files\n\nOther `README.*` files in this repository are listed below.\n\n- [Widgets application data `README`](aidesign_widgets_default_configs/app_data/README.md)\n\n# Miscellaneous\n## Developer's Notes :memo: And Warnings :warning:\n### Notes :memo:\n\nThis application is distributed under the **GNU GPL3 license**.\n\nA subsequent work of this application is a work that satisfies **any one** of the following:\n\n- Is a variant of any form of this application.\n- Contains a part, some parts, or all parts of this application.\n- Integrates a part, some parts, or all parts of this application.\n\nAll subsequent works of this application **must also be distributed under the GNU GPL3 license, and must also open their source codes to the public**.\n\nAn output of this application is a file that satisfies **all** of the following:\n\n- Is directly produced by running one or more commands provided by this application.\n- Is directly produced by conducting one or more operations on the GUI of this application.\n\nThe outputs of this application do not have to be distributed under the GNU GPL3 license.\n\nThe non-subsequent works that uses the outputs of this application do not have to be distributed under the GNU GPL3 license.\n\n### Warnings :warning:\n\nMaking a **closed-source** subsequent work (as defined above) of this application, and distribute it to the public is **unlawful**, no matter if such work makes a profit.\n\nDoing the above may result in severe civil and criminal penalties.\n\nI reserve the rights, funds, time, and efforts to prosecute those who violate the license of this application to the maximum extent under applicable laws.\n\n## Versions\n### Versioning\n\n```text\nThe versioning of this application is based on Semantic Versioning.\nYou can see the complete Semantic Versioning specification from\n  https://semver.org/.\nBasically, the version name of this application is in the form of:\n  x.y.z\n  Where x, y, and z are integers that are greater than or equal to 0.\n  Where x, y, and z are separated by dots.\n  x stands for the major version and indicates non-compatible major changes to\n    the application.\n  y stands for the minor version and indicates forward compatible minor\n    changes to the application.\n  z stands for the patch version and indicates bug fixes and patches to the\n    application.\n```\n\n### Version Tags\n\n```text\nThe version tags of this repository has the form of a letter \"v\" followed by a\n  semantic version.\nGiven a semantic version:\n  $x.$y.$z\n  Where $x, $y, and $z are the semantic major, minor, and patch versions.\nThe corresponding version tag would be:\n  v$x.$y.$z\nThe version tags are on the main branch.\n```\n\n## Copyright\n### Short Version\n\n```text\nCopyright (C) 2022 Yucheng Liu. GNU GPL3 license (GNU General Public License\n  Version 3).\nYou should have and keep a copy of the above license. If not, please get it\n  from https://www.gnu.org/licenses/gpl-3.0.txt.\n```\n\n### Long Version\n\n```text\nAIDesign-Widgets, AIDesign widget collection application.\nCopyright (C) 2022 Yucheng Liu. GNU GPL3 license (GNU General Public License\n  Version 3).\n\nThis program is free software: you can redistribute it and/or modify it under\n  the terms of the GNU General Public License as published by the Free\n  Software Foundation, either version 3 of the License, or (at your option)\n  any later version.\n\nThis program is distributed in the hope that it will be useful, but WITHOUT\n  ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or\n  FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for\n  more details.\n\nYou should have received a copy of the GNU General Public License along with\n  this program. If not, see:\n  1. The LICENSE file in this repository.\n  2. https://www.gnu.org/licenses/#GPL.\n  3. https://www.gnu.org/licenses/gpl-3.0.txt.\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliu-yucheng%2Faidesign-widgets","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fliu-yucheng%2Faidesign-widgets","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fliu-yucheng%2Faidesign-widgets/lists"}