password-generator-app 1.0.0__tar.gz

password_generator_app-1.0.0/CHANGELOG.md

@@ -0,0 +1,60 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on Keep a Changelog:
+https://keepachangelog.com/en/1.1.0/
+
+This project follows Semantic Versioning:
+https://semver.org/
+
+---
+
+## [1.0.0] - 2026-05-24
+
+### Added
+- Modern Material-style graphical user interface built with PySide6
+- Full command-line interface (CLI)
+- `passgen` executable command support
+- Password generation with configurable:
+  - length
+  - lowercase characters
+  - uppercase characters
+  - digits
+  - punctuation symbols
+- Clipboard copy support
+- Password strength indicator
+- Persistent local settings storage
+- Light and dark theme support
+- Accent color customization
+- Settings reset functionality
+- Cross-platform Python package structure
+- PyPI-ready packaging configuration
+- GitHub-ready project structure
+- README screenshots and usage examples
+- Batch launcher for Windows (`passgen.bat`)
+
+### Improved
+- Refactored application architecture using:
+  - `core/`
+  - `ui/`
+  - `src/` package layout
+- Improved UI sizing and spacing
+- Improved theme consistency across widgets
+- Improved button and textbox styling
+- Improved CLI usability and argument handling
+- Improved packaging metadata
+
+### Fixed
+- Fixed GUI theme rendering issues
+- Fixed dark/light mode text color inconsistencies
+- Fixed PySide6 icon compatibility issues
+- Fixed `QProgressBar` import issues
+- Fixed relative import execution problems
+- Fixed CLI module discovery issues
+- Fixed settings persistence bugs
+- Fixed widget sizing inconsistencies
+- Fixed multiple startup crashes
+
+### Security
+- Secure password generation using Python's `secrets` module

password_generator_app-1.0.0/LICENSE

@@ -0,0 +1,17 @@
+MIT License
+
+Copyright (c) 2026 Vahed MamGhaderi
+
+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.

password_generator_app-1.0.0/MANIFEST.in

@@ -0,0 +1,5 @@
+include README.md
+include LICENSE
+include CHANGELOG.md
+
+recursive-include imgs *.png

password_generator_app-1.0.0/PKG-INFO

@@ -0,0 +1,276 @@
+Metadata-Version: 2.4
+Name: password-generator-app
+Version: 1.0.0
+Summary: A lightweight password generator with a PySide6 GUI and CLI.
+Author: Vahed MamGhaderi
+License-Expression: MIT
+Keywords: password,password-generator,pyside6,gui,cli,security,material-design
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Security
+Classifier: Topic :: Utilities
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: PySide6>=6.7.0
+Dynamic: license-file
+
+# Password Generator App
+
+A clean and lightweight password generator built with **PySide6** and Python.  
+The project provides both a graphical user interface and a command-line interface.
+
+## Features
+
+- Simple Material-style GUI
+- Dark and light themes
+- Accent color selection
+- Password generation with configurable character groups
+- Clipboard copy
+- Persistent local settings stored beside the project
+- CLI support for terminal-based use
+- Small, readable UI with responsive spacing
+
+## Screenshots
+
+### CLI
+
+![CLI screenshot](imgs/CLI.png)
+
+### GUI
+
+![GUI screenshot](imgs/GUI.png)
+
+## Installation
+
+### From source
+
+```powershell
+pip install -r requirements.txt
+pip install -e .
+```
+
+### From PyPI
+
+```powershell
+pip install password-generator-app
+```
+
+## Run the application
+
+The main command is `passgen`.  
+The alias `password-generator` is also available after installation.
+
+### From a local source checkout without installation
+
+```powershell
+$env:PYTHONPATH = "src"
+python -m password_generator_app.cli gui
+python -m password_generator_app.cli --length 32 --copy
+```
+
+### After installation
+
+```powershell
+passgen gui
+passgen --length 32 --copy
+password-generator gui
+password-generator --length 32 --copy
+```
+
+### Direct module execution
+
+```powershell
+python -m password_generator_app.cli gui
+python -m password_generator_app.cli --length 32 --copy
+```
+
+## GUI usage
+
+Launch the graphical interface:
+
+```powershell
+passgen gui
+```
+
+Or:
+
+```powershell
+password-generator gui
+```
+
+The GUI allows you to:
+
+- Generate secure passwords visually
+- Configure character groups
+- Set minimum character counts
+- Switch between dark and light themes
+- Customize accent colors
+- Copy passwords directly to the clipboard
+
+## CLI usage
+
+Generate a password with default settings:
+
+```powershell
+passgen
+```
+
+Generate a password with a custom length and copy it to the clipboard:
+
+```powershell
+passgen --length 32 --copy
+```
+
+Show help:
+
+```powershell
+passgen -h
+```
+
+The same CLI commands can also be executed with:
+
+```powershell
+password-generator
+```
+
+## CLI options
+
+- `--length`, `-l` — password length
+- `--lowercase / --no-lowercase`
+- `--uppercase / --no-uppercase`
+- `--digits / --no-digits`
+- `--punctuation / --no-punctuation`
+- `--min-lowercase`
+- `--min-uppercase`
+- `--min-digits`
+- `--min-punctuation`
+- `--copy`, `-c` — copy the generated password to the clipboard
+
+## Python API
+
+You can also use the generator directly from Python code:
+
+```python
+from password_generator_app.core.password_generator import (
+    PasswordGenerator,
+    PasswordConfig,
+)
+
+config = PasswordConfig(
+    length=18,
+    include_lowercase=True,
+    include_uppercase=True,
+    include_digits=True,
+    include_punctuation=True,
+    min_lowercase=3,
+    min_uppercase=3,
+    min_digits=3,
+    min_punctuation=3,
+)
+
+password = PasswordGenerator(config)
+
+for _ in range(5):
+    print(password.generate())
+```
+
+## Settings
+
+The application stores its settings in the project directory as `settings.json`.
+
+Saved values include:
+
+- theme
+- accent color
+- window size
+- password generation options
+
+## Project Structure
+
+```text
+password_generator_app_v1/
+├── imgs/
+├── scripts/
+│   ├── cleanup.ps1
+│   ├── build.ps1
+│   ├── rebuild.ps1
+│   └── rebuild.bat
+├── src/
+│   └── password_generator_app/
+├── tests/
+├── CHANGELOG.md
+├── LICENSE
+├── MANIFEST.in
+├── pyproject.toml
+└── README.md
+```
+
+## Windows Batch Launcher
+
+You can place `passgen.bat` inside your `commands` folder and update the project path in the file.  
+After that, the app can be launched directly from the terminal without installing the package.
+
+```powershell
+passgen gui
+passgen --length 32 --copy
+password-generator gui
+password-generator --length 32 --copy
+```
+
+## Running Tests
+
+Install pytest:
+
+```bash
+pip install pytest
+```
+
+Run all tests:
+
+```bash
+pytest -v
+```
+
+The project includes:
+
+- Core password generator tests
+- Validation tests
+- CLI tests
+
+## Development Utilities
+
+### Rebuild local package
+
+Run the complete local development workflow:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\scripts\rebuild.ps1
+```
+
+Or:
+
+```powershell
+.\scripts\rebuild.bat
+```
+
+This process will:
+
+- Clean the project
+- Remove old local installations
+- Run tests
+- Build package distributions
+- Validate distributions using Twine
+- Reinstall the latest local build
+
+## Author
+
+Developed by Vahed MamGhaderi
+
+## License
+
+This project is licensed under the MIT License.
+
+See the [LICENSE](LICENSE) file for details.

password_generator_app-1.0.0/README.md

@@ -0,0 +1,257 @@
+# Password Generator App
+
+A clean and lightweight password generator built with **PySide6** and Python.  
+The project provides both a graphical user interface and a command-line interface.
+
+## Features
+
+- Simple Material-style GUI
+- Dark and light themes
+- Accent color selection
+- Password generation with configurable character groups
+- Clipboard copy
+- Persistent local settings stored beside the project
+- CLI support for terminal-based use
+- Small, readable UI with responsive spacing
+
+## Screenshots
+
+### CLI
+
+![CLI screenshot](imgs/CLI.png)
+
+### GUI
+
+![GUI screenshot](imgs/GUI.png)
+
+## Installation
+
+### From source
+
+```powershell
+pip install -r requirements.txt
+pip install -e .
+```
+
+### From PyPI
+
+```powershell
+pip install password-generator-app
+```
+
+## Run the application
+
+The main command is `passgen`.  
+The alias `password-generator` is also available after installation.
+
+### From a local source checkout without installation
+
+```powershell
+$env:PYTHONPATH = "src"
+python -m password_generator_app.cli gui
+python -m password_generator_app.cli --length 32 --copy
+```
+
+### After installation
+
+```powershell
+passgen gui
+passgen --length 32 --copy
+password-generator gui
+password-generator --length 32 --copy
+```
+
+### Direct module execution
+
+```powershell
+python -m password_generator_app.cli gui
+python -m password_generator_app.cli --length 32 --copy
+```
+
+## GUI usage
+
+Launch the graphical interface:
+
+```powershell
+passgen gui
+```
+
+Or:
+
+```powershell
+password-generator gui
+```
+
+The GUI allows you to:
+
+- Generate secure passwords visually
+- Configure character groups
+- Set minimum character counts
+- Switch between dark and light themes
+- Customize accent colors
+- Copy passwords directly to the clipboard
+
+## CLI usage
+
+Generate a password with default settings:
+
+```powershell
+passgen
+```
+
+Generate a password with a custom length and copy it to the clipboard:
+
+```powershell
+passgen --length 32 --copy
+```
+
+Show help:
+
+```powershell
+passgen -h
+```
+
+The same CLI commands can also be executed with:
+
+```powershell
+password-generator
+```
+
+## CLI options
+
+- `--length`, `-l` — password length
+- `--lowercase / --no-lowercase`
+- `--uppercase / --no-uppercase`
+- `--digits / --no-digits`
+- `--punctuation / --no-punctuation`
+- `--min-lowercase`
+- `--min-uppercase`
+- `--min-digits`
+- `--min-punctuation`
+- `--copy`, `-c` — copy the generated password to the clipboard
+
+## Python API
+
+You can also use the generator directly from Python code:
+
+```python
+from password_generator_app.core.password_generator import (
+    PasswordGenerator,
+    PasswordConfig,
+)
+
+config = PasswordConfig(
+    length=18,
+    include_lowercase=True,
+    include_uppercase=True,
+    include_digits=True,
+    include_punctuation=True,
+    min_lowercase=3,
+    min_uppercase=3,
+    min_digits=3,
+    min_punctuation=3,
+)
+
+password = PasswordGenerator(config)
+
+for _ in range(5):
+    print(password.generate())
+```
+
+## Settings
+
+The application stores its settings in the project directory as `settings.json`.
+
+Saved values include:
+
+- theme
+- accent color
+- window size
+- password generation options
+
+## Project Structure
+
+```text
+password_generator_app_v1/
+├── imgs/
+├── scripts/
+│   ├── cleanup.ps1
+│   ├── build.ps1
+│   ├── rebuild.ps1
+│   └── rebuild.bat
+├── src/
+│   └── password_generator_app/
+├── tests/
+├── CHANGELOG.md
+├── LICENSE
+├── MANIFEST.in
+├── pyproject.toml
+└── README.md
+```
+
+## Windows Batch Launcher
+
+You can place `passgen.bat` inside your `commands` folder and update the project path in the file.  
+After that, the app can be launched directly from the terminal without installing the package.
+
+```powershell
+passgen gui
+passgen --length 32 --copy
+password-generator gui
+password-generator --length 32 --copy
+```
+
+## Running Tests
+
+Install pytest:
+
+```bash
+pip install pytest
+```
+
+Run all tests:
+
+```bash
+pytest -v
+```
+
+The project includes:
+
+- Core password generator tests
+- Validation tests
+- CLI tests
+
+## Development Utilities
+
+### Rebuild local package
+
+Run the complete local development workflow:
+
+```powershell
+powershell -ExecutionPolicy Bypass -File .\scripts\rebuild.ps1
+```
+
+Or:
+
+```powershell
+.\scripts\rebuild.bat
+```
+
+This process will:
+
+- Clean the project
+- Remove old local installations
+- Run tests
+- Build package distributions
+- Validate distributions using Twine
+- Reinstall the latest local build
+
+## Author
+
+Developed by Vahed MamGhaderi
+
+## License
+
+This project is licensed under the MIT License.
+
+See the [LICENSE](LICENSE) file for details.

password_generator_app-1.0.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "password-generator-app"
+version = "1.0.0"
+description = "A lightweight password generator with a PySide6 GUI and CLI."
+readme = { file = "README.md", content-type = "text/markdown" }
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+    { name = "Vahed MamGhaderi" }
+]
+
+keywords = [
+    "password",
+    "password-generator",
+    "pyside6",
+    "gui",
+    "cli",
+    "security",
+    "material-design"
+]
+
+classifiers = [
+    "Development Status :: 5 - Production/Stable",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Topic :: Security",
+    "Topic :: Utilities",
+]
+
+dependencies = [
+    "PySide6>=6.7.0"
+]
+
+[project.scripts]
+passgen = "password_generator_app.cli:main"
+password-generator = "password_generator_app.cli:main"
+password-generator-app = "password_generator_app.cli:main"
+
+[tool.setuptools]
+package-dir = { "" = "src" }
+include-package-data = true
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+password_generator_app = [
+    "resources/styles/*.qss"
+]

password_generator_app-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

password_generator_app-1.0.0/src/password_generator_app/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.0.0"

password_generator_app-1.0.0/src/password_generator_app/__main__.py

@@ -0,0 +1,4 @@
+from .app import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())