{"id":19302480,"url":"https://github.com/bitlytwiser/youshallpass","last_synced_at":"2026-04-17T14:36:54.367Z","repository":{"id":129166967,"uuid":"252066397","full_name":"BitlyTwiser/YouShallPass","owner":"BitlyTwiser","description":"Generates Passwords","archived":false,"fork":false,"pushed_at":"2020-04-23T18:00:03.000Z","size":1105,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-01-05T23:25:39.230Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Go","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/BitlyTwiser.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":"2020-04-01T03:52:42.000Z","updated_at":"2024-09-17T01:49:13.000Z","dependencies_parsed_at":"2023-07-27T10:15:49.703Z","dependency_job_id":null,"html_url":"https://github.com/BitlyTwiser/YouShallPass","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitlyTwiser%2FYouShallPass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitlyTwiser%2FYouShallPass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitlyTwiser%2FYouShallPass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/BitlyTwiser%2FYouShallPass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/BitlyTwiser","download_url":"https://codeload.github.com/BitlyTwiser/YouShallPass/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240404656,"owners_count":19796062,"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":"2024-11-09T23:22:19.146Z","updated_at":"2026-04-17T14:36:49.324Z","avatar_url":"https://github.com/BitlyTwiser.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"```\n                   __  _             _  _    ___                 \n/\\_/\\ ___   _   _ / _\\| |__    __ _ | || |  / _ \\ __ _  ___  ___ \n\\_ _// _ \\ | | | |\\ \\ | '_ \\  / _` || || | / /_)// _` |/ __|/ __|\n / \\| (_) || |_| |_\\ \\| | | || (_| || || |/ ___/| (_| |\\__ \\\\__ \\\n \\_/ \\___/  \\__,_|\\__/|_| |_| \\__,_||_||_|\\/     \\__,_||___/|___/\n \n //Curator: Bitly Twiser\n                                                                 \n```\n# YouShallPass\n- Password Generator\n- Utilized as a web UI, API to query, or command line application.\n\n# Usage:\n- Run install script which will perform the following actions:\n1. Compile go binary\n2. Place binary within /usr/local/bin to be executed by calling the program name. Default name is \"ysp\"\n- Change name?\n- Simply edit the Install File and alter the \"binName\" variable. Run install script after making modification.\n\n## Command Line:\n- After installing binary just call the following:\n```ysp --help```\n- This will display help menu on program usage.\n- Help Menu Output: \n```\n  -length int\n        Length of the password to generate. (default 8)\n  -server\n        Starts an Rest API to be queried for passwords. Also will generate a web UI running on port 8080\n  -special\n        Determines if one desires to DISABLE special characters within the generated password. (default true)\n  -upper\n        Determines if one desires to have upper case characters within the generated password. (default true)\n  -wordlist string\n        Location of wordlist to utilize for password generation\n ```\n\n## Web UI:\n- To run the web us perform the following:\n```ysp -server=true```\n- This will start to webserver, browse to port 8080 on localhost to view/use web UI.\n\n## API:\n- If the webserver option is utilized on can use the application's built in API to obtain a password.\n- The port utilized for the API is __8002__\n- The following example uses the HTTPIE project.\n- Link: https://httpie.org/\n- Usage:\n```\nhttp -f POST 127.0.0.1:8002/password length=15 uppercase=false specchar=false\n```\n- NOTE: __Ensure the webserver is running in order to use API!__\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitlytwiser%2Fyoushallpass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbitlytwiser%2Fyoushallpass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbitlytwiser%2Fyoushallpass/lists"}