{"id":26774744,"url":"https://github.com/kenzycodex/securepass","last_synced_at":"2025-03-29T02:18:05.302Z","repository":{"id":284288812,"uuid":"954322770","full_name":"kenzycodex/securepass","owner":"kenzycodex","description":"A secure, cross-platform password generator with clipboard integration and advanced features.","archived":false,"fork":false,"pushed_at":"2025-03-25T05:16:22.000Z","size":8,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T06:23:38.249Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/kenzycodex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-03-24T22:52:18.000Z","updated_at":"2025-03-25T05:16:25.000Z","dependencies_parsed_at":"2025-03-25T06:33:54.175Z","dependency_job_id":null,"html_url":"https://github.com/kenzycodex/securepass","commit_stats":null,"previous_names":["kenzycodex/securepass"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kenzycodex%2Fsecurepass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kenzycodex%2Fsecurepass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kenzycodex%2Fsecurepass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/kenzycodex%2Fsecurepass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/kenzycodex","download_url":"https://codeload.github.com/kenzycodex/securepass/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246126716,"owners_count":20727595,"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":[],"created_at":"2025-03-29T02:18:03.941Z","updated_at":"2025-03-29T02:18:05.295Z","avatar_url":"https://github.com/kenzycodex.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SecurePass\n\nA secure, cross-platform password generator with clipboard integration.\n\n![Python Versions](https://img.shields.io/badge/python-3.8%2B-blue)\n![License](https://img.shields.io/badge/license-MIT-green)\n![Test Coverage](https://img.shields.io/badge/coverage-71%25-yellow)\n\n## Features\n\n- Generate secure random passwords with customizable parameters\n- Cross-platform clipboard integration (Windows, macOS, Linux)\n- Multiple clipboard backend support (PowerShell, pbcopy, xclip, wl-copy, CopyQ, pyperclip)\n- Command-line interface for quick password generation\n- Comprehensive test suite with platform-specific tests\n- Backward compatibility with previous `password_generator` package\n\n## Installation\n\n```bash\n# Install from PyPI\npip install securepass\n\n# Or install from source\ngit clone https://github.com/yourusername/securepass.git\ncd securepass\npip install -e .\n```\n\n## Usage\n\n### Command Line\n\n```bash\n# Generate a 16-character alphanumeric password\npassgen -l 16 -c alnum\n\n# Generate a password with all character types and copy to clipboard\npassgen -l 20 -c all --copy\n\n# Generate a password with verbose output\npassgen -l 12 -c special -v\n\n# Using the installed command\npassgen --length 16 --charset full\n\n# With options\npassgen -l 20 -c alnum -v\n\n# Direct module execution\npython -m securepass --length 24 --charset full\n```\n\n### Python API\n\n```python\nfrom securepass import PasswordGenerator, ClipboardDriver\n\n# Create a password generator\ngenerator = PasswordGenerator()\n\n# Generate a secure password\npassword = generator.generate(length=16, char_types=\"alnum\")\nprint(f\"Generated password: {password}\")\n\n# Copy password to clipboard\nClipboardDriver.copy_password(password, secure=True)\n```\n\n## Configuration\n\nThe following character types are supported:\n\n- `alpha`: Lowercase and uppercase letters\n- `alnum`: Letters and numbers\n- `digit`: Numbers only\n- `lower`: Lowercase letters only\n- `upper`: Uppercase letters only\n- `special`: Special characters only\n- `all`: All character types\n\n## Clipboard Support\n\nSecurePass provides cross-platform clipboard support with multiple backends:\n\n| Platform | Supported Backends |\n|----------|-------------------|\n| Windows  | PowerShell, pyperclip, CopyQ |\n| macOS    | pbcopy, pyperclip, CopyQ |\n| Linux    | xclip, wl-copy, pyperclip, CopyQ |\n\nThe clipboard system automatically tries different methods until it finds one that works on your system.\n\n## Development\n\n### Setting up the development environment\n\n```bash\n# Clone the repository\ngit clone https://github.com/yourusername/securepass.git\ncd securepass\n\n# Create a virtual environment\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n\n# Install in development mode\npip install -e .\n\n# Install development dependencies\npip install pytest pytest-cov pytest-mock\n```\n\n### Running tests\n\nThe project includes a comprehensive test suite with platform-specific tests:\n\n```bash\n# Run all tests appropriate for your platform\npython run_tests.py\n\n# Run tests with coverage report\npython run_tests.py --coverage\n\n# Run specific test modules\npython run_tests.py --module clipboard,generator\n```\n\n### Refreshing the package installation\n\nIf you encounter issues with the package installation or entry points, you can use the refresh script:\n\n```bash\npython refresh_package.py\n```\n\n## Compatibility\n\nSecurePass provides backward compatibility with the previous `password_generator` package. Old import statements and class names should continue to work but will raise deprecation warnings:\n\n```python\n# Old import (will work but shows deprecation warning)\nfrom password_generator import PasswordGenerator\n\n# New import (recommended)\nfrom securepass import PasswordGenerator\n```\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create a feature branch\n3. Add your changes\n4. Run tests to ensure they pass\n5. Submit a pull request\n\n## Acknowledgments\n\n- Thanks to all the contributors who have helped improve this project.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkenzycodex%2Fsecurepass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkenzycodex%2Fsecurepass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkenzycodex%2Fsecurepass/lists"}