{"id":24538394,"url":"https://github.com/ajaysinghnp/ha-sapi","last_synced_at":"2025-03-16T02:24:47.989Z","repository":{"id":272201831,"uuid":"915813415","full_name":"ajaysinghnp/ha-sapi","owner":"ajaysinghnp","description":"This custom integration allows you to use SAPI services within Home Assistant.","archived":false,"fork":false,"pushed_at":"2025-02-20T05:23:33.000Z","size":209,"stargazers_count":0,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-20T06:26:40.711Z","etag":null,"topics":["custom-integration","hacs","home-assistant","homeassistant","sapi"],"latest_commit_sha":null,"homepage":"https://ajaysingh.com.np/ha-sapi","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/ajaysinghnp.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-12T21:34:20.000Z","updated_at":"2025-02-20T05:23:29.000Z","dependencies_parsed_at":"2025-01-12T22:29:42.257Z","dependency_job_id":"84cc6c00-4a0d-4aff-a32e-b7998e973fdd","html_url":"https://github.com/ajaysinghnp/ha-sapi","commit_stats":null,"previous_names":["ajaysinghnp/ha-sapi"],"tags_count":32,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajaysinghnp%2Fha-sapi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajaysinghnp%2Fha-sapi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajaysinghnp%2Fha-sapi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ajaysinghnp%2Fha-sapi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ajaysinghnp","download_url":"https://codeload.github.com/ajaysinghnp/ha-sapi/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243814979,"owners_count":20352077,"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":["custom-integration","hacs","home-assistant","homeassistant","sapi"],"created_at":"2025-01-22T15:13:14.992Z","updated_at":"2025-03-16T02:24:47.376Z","avatar_url":"https://github.com/ajaysinghnp.png","language":"Python","readme":"# SAPI Integration for Home Assistant\n\nThis custom integration allows you to use SAPI services from the API within Home Assistant.\n\n## Features include\n\n- [x] Nepali Date\n- [ ] Nepali - International Date Conversion\n- [x] Password generation\n- [x] PIN generation\n- [ ] Nepali PAN Search\n- [x] Electricity bill queries\n- [ ] Utility: Number Formatting and text\n- [ ] State based Icons\n\n## Installation\n\n### HACS (Recommended)\n\n1. Open HACS in your Home Assistant instance.\n2. Click on Integrations.\n3. Click the `+` button.\n4. Search for \"SAPI\".\n5. Click Install.\n\n### Manual Installation\n\n1. Copy the `custom_components/sapi` directory to your Home Assistant's `custom_components` directory\n2. Restart Home Assistant\n\n## Configuration\n\n1. Go to Settings \u003e Devices \u0026 Services\n2. Click \"+ Add Integration\"\n3. Search for \"SAPI\"\n4. Enter your `API_KEY`, API `base_url` and optionally a `name`\n5. Choose an `area` if you are asked to choose if you want or continue.\n6. Done !\n\n## Services\n\nThe integration provides the following services:\n\n### get_nepali_date ✅\n\nGet the current Nepali date.\n\n### generate_password ✅\n\nGenerate a secure password with customizable parameters.\n\n### generate_pin ✅\n\nGenerate a numeric PIN of specified length.\n\n### convert_date ❌\n\nConvert dates between Nepali and English calendars.\n\n### query_bill ✅\n\nQuery utility bill information for various services.\n\n## Support\n\nFor bugs and feature requests, please create an issue on GitHub.\n\n## Development Checklist\n\n- [ ] All communication to external devices or services must be wrapped in an external Python library hosted on [pypi](https://pypi.org/).\n  - [ ] The library must have source distribution packages available; it's not allowed to rely on packages that only have binary distribution packages.\n  - [ ] Issue trackers must be enabled for external Python libraries that communicate with external devices or services.\n  - [ ] If the library is mainly used for Home Assistant and you are a code owner of the integration, it is encouraged to use an issue template picker with links to [Home Assistant Core Issues](https://github.com/home-assistant/core/issues). For example: [zwave-js-server-python - New Issue](https://github.com/home-assistant-libs/zwave-js-server-python/issues/new/choose)\n- [ ] New dependencies are added to `requirements_all.txt` (if applicable), using `python3 -m script.gen_requirements_all`\n- [x] New codeowners are added to `CODEOWNERS` (if applicable), using `python3 -m script.hassfest`\n- [ ] The `.strict-typing` file is updated to include your code if it provides a fully type hinted source.\n- [x] The code is formatted using Ruff (`ruff format`).\n- [ ] Documentation is developed for [home-assistant.io](https://home-assistant.io/)\n  - [x] Visit the [website documentation](https://developers.home-assistant.io/docs/documenting) for more information about contributing to [home-assistant.io](https://github.com/home-assistant/home-assistant.io).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajaysinghnp%2Fha-sapi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fajaysinghnp%2Fha-sapi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fajaysinghnp%2Fha-sapi/lists"}