{"id":22781851,"url":"https://github.com/extratone/squares","last_synced_at":"2026-02-08T06:37:55.419Z","repository":{"id":261360888,"uuid":"884077778","full_name":"extratone/squares","owner":"extratone","description":"Python-based command-line application that finds the two closest square numbers to a given input number.","archived":false,"fork":false,"pushed_at":"2024-11-06T05:26:23.000Z","size":16,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-15T16:29:47.555Z","etag":null,"topics":["cli","pypi","pypi-package","python","python-script","squareroot"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/squares-cli","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/extratone.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},"funding":{"github":["extratone"],"patreon":"extratone","liberapay":"davidblue","ko_fi":"extratone","open_collective":"blue"}},"created_at":"2024-11-06T05:11:06.000Z","updated_at":"2024-11-28T17:54:28.000Z","dependencies_parsed_at":"2024-11-06T06:24:38.582Z","dependency_job_id":"97c2ae05-c3bc-4897-940c-9784e2ad760d","html_url":"https://github.com/extratone/squares","commit_stats":null,"previous_names":["extratone/squares"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extratone%2Fsquares","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extratone%2Fsquares/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extratone%2Fsquares/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/extratone%2Fsquares/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/extratone","download_url":"https://codeload.github.com/extratone/squares/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":249107866,"owners_count":21213929,"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":["cli","pypi","pypi-package","python","python-script","squareroot"],"created_at":"2024-12-11T21:08:55.553Z","updated_at":"2026-02-08T06:37:50.399Z","avatar_url":"https://github.com/extratone.png","language":"Python","readme":"![squares](https://github.com/user-attachments/assets/703c25c9-37fe-4c96-bf6b-e0624c2fb819)\n\n# `squares`\n\n`squares` is a Python-based command-line application that finds the two closest square numbers to a given input number.\n\n## Installation\n\nTo install `squares`, use `pip`:\n\n```bash\npip install squares-cli\n```\n\nThis will install the `squares` command, allowing you to find the closest square numbers directly from the command line.\n\n## Usage\n\nThe `squares` command can find the two closest square numbers (one above and one below) to a given input number. You can use it in various ways, specifying options to control the output.\n\n### Basic Command\n\n```bash\nsquares [OPTIONS] \u003cnumber\u003e\n```\n\nIf no options are specified, `squares` will output both the closest square number below and the closest square number above the given input, separated by a comma.\n\n### Options\n\n- `--below` - Outputs only the closest square below the input number.\n- `--above` - Outputs only the closest square above the input number.\n- `--both`  - Outputs both the closest squares (this is the default behavior if no option is specified).\n- `-h` or `--help` - Displays the help message.\n\n### Examples\n\nHere are some example commands and their expected outputs:\n\n#### Default (Both Closest Squares)\n\n```bash\nsquares 12\n```\n\n**Output:**\n```\n9, 16\n```\n\nIn this example, `squares 12` finds the closest squares around 12, returning both the closest square below (9) and the closest square above (16).\n\n#### Closest Square Below\n\n```bash\nsquares --below 12\n```\n\n**Output:**\n```\n9\n```\n\nThis example uses `--below` to return only the closest square below 12, which is 9.\n\n#### Closest Square Above\n\n```bash\nsquares --above 12\n```\n\n**Output:**\n```\n16\n```\n\nHere, `--above` is used to return only the closest square above 12, which is 16.\n\n#### Explicitly Returning Both (Same as Default)\n\n```bash\nsquares --both 12\n```\n\n**Output:**\n```\n9, 16\n```\n\nUsing `--both` explicitly returns both closest squares around 12. This produces the same result as the default behavior.\n\n### Man Page\n\nA man page is also included in the installation. You can access it by typing:\n\n```bash\nman squares\n```\n\nThis will display comprehensive information about the command, options, and examples, similar to what is provided in this README.\n\n## Additional Notes\n\n- **Operating System Compatibility**: `squares` is compatible with UNIX-like systems (Linux and macOS) and Windows, though the man page installation may vary depending on the OS.\n- **Python Version**: This package requires Python 3.6 or higher.[\n\n## License\n\nThis project is licensed under the MIT License.\n\n---\n\nThis `README.md` provides a clear description of what the package does, how to install and use it, and includes examples and notes for further clarification. Let me know if there’s anything else you’d like added or modified!]\n","funding_links":["https://github.com/sponsors/extratone","https://patreon.com/extratone","https://liberapay.com/davidblue","https://ko-fi.com/extratone","https://opencollective.com/blue"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fextratone%2Fsquares","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fextratone%2Fsquares","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fextratone%2Fsquares/lists"}