{"id":13758727,"url":"https://github.com/OpenVoiceOS/ovos-utils","last_synced_at":"2025-05-10T08:30:43.539Z","repository":{"id":37844982,"uuid":"420661365","full_name":"OpenVoiceOS/ovos-utils","owner":"OpenVoiceOS","description":null,"archived":false,"fork":false,"pushed_at":"2025-04-29T00:47:35.000Z","size":1992,"stargazers_count":4,"open_issues_count":21,"forks_count":9,"subscribers_count":3,"default_branch":"dev","last_synced_at":"2025-05-03T00:20:34.193Z","etag":null,"topics":["hacktoberfest","openvoiceos"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/OpenVoiceOS.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},"funding":{"github":["OpenVoiceOS"],"patreon":"openvoiceos","liberapay":"OpenVoiceOS-Foundation","custom":"https://paypal.me/openvoiceos"}},"created_at":"2021-10-24T11:11:55.000Z","updated_at":"2025-04-29T00:47:38.000Z","dependencies_parsed_at":"2022-06-23T00:04:00.033Z","dependency_job_id":"2669b8f8-53af-493d-8ec3-3cca8eae4211","html_url":"https://github.com/OpenVoiceOS/ovos-utils","commit_stats":{"total_commits":460,"total_committers":16,"mean_commits":28.75,"dds":0.6717391304347826,"last_synced_commit":"3609c3e7ad058bb288ad4e6f93eaaac33c22b912"},"previous_names":["openvoiceos/ovos_utils"],"tags_count":216,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-utils","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-utils/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-utils/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/OpenVoiceOS%2Fovos-utils/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/OpenVoiceOS","download_url":"https://codeload.github.com/OpenVoiceOS/ovos-utils/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253389509,"owners_count":21900767,"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":["hacktoberfest","openvoiceos"],"created_at":"2024-08-03T13:00:35.512Z","updated_at":"2025-05-10T08:30:41.487Z","avatar_url":"https://github.com/OpenVoiceOS.png","language":"Python","readme":"# OVOS-utils\n\ncollection of simple utilities for use across the mycroft ecosystem\n\n## Install\n\n```bash\npip install ovos_utils\n```\n\n## Commandline scripts\n### ovos-logs\n Small helper tool to quickly navigate the logs, create slices and quickview errors  \n\n---------------\n- **ovos-logs slice [options]**\n\n  **Slice logs of a given time period. Defaults on the last service start (`-s`) until now (`-u`)**\n\n  _Different logs can be picked using the `-l` option. All logs will be included if not specified._  \n  _Optionally the directory where the logs are stored (`-p`) and the file where the slices should be dumped (`-f`) can be specified._\n    \n\n  _[ex: `ovos-logs slice`]_  \n  \u003csup\u003e_Slice all logs from service start up until now._\u003c/sup\u003e\n  \n  _[ex: `ovos-logs slice -s 17:05:20 -u 17:05:25`]_  \n  \u003csup\u003e_Slice all logs from 17:05:20 until 17:05:25._\u003c/sup\u003e    \n  \u003csup\u003e_**no logs in that timeframe in other present logs_\u003c/sup\u003e\n  \u003cimg width=\"1898\" alt=\"Screenshot 2023-12-25 185004\" src=\"https://github.com/emphasize/ovos-utils/assets/25036977/c7918bd6-0e13-46af-8016-55486b9a786e\"\u003e  \n   \n  _[ex: `ovos-logs slice -s 17:05:20 -u 17:05:25 -l skills`]_  \n  \u003csup\u003e_Slice skills.log from 17:05:20 until 17:05:25._\u003c/sup\u003e\n  \n  _[ex: `ovos-logs slice -s 17:05:20 -u 17:05:25 -f ~/testslice.log`]_  \n  \u003csup\u003e_Slice the logs from 17:05:20 until 17:05:25 on all log files and dump the slices in the file ~/testslice.log (default: `~/slice_\u003ctimestamp\u003e.log`)._\u003c/sup\u003e\n  \u003cimg width=\"1246\" alt=\"Screenshot 2023-12-25 190732\" src=\"https://github.com/emphasize/ovos-utils/assets/25036977/dda99d8a-2739-4872-b81a-f44902b43d7d\"\u003e\n--------------\n\n- **ovos-logs list [-e|-w|-d|-x] [options]**\n\n  **List logs by severity (error/warning/debug/exception). A log level has to be specified - more than one can be listed**  \n\n  _A start and end date can be specified using the `-s` and `-u` options. Defaults to the last service start until now._  \n  _Different logs can be picked using the `-l` option. All logs will be included if not specified._  \n  _Optionally, the directory where the logs are stored (`-p`) and the file where the slices should be dumped (`-f`) can be passed as arguments._  \n\n  _[ex: `ovos-logs list -x`]_  \n  \u003csup\u003e_List the logs with level EXCEPTION (plus tracebacks) from the last service start until now._\u003c/sup\u003e\n  \u003cimg width=\"992\" alt=\"Screenshot 2023-12-25 184321\" src=\"https://github.com/emphasize/ovos-utils/assets/25036977/da8be23a-4268-4647-8dd3-32c1a889440c\"\u003e\n  \n  _[ex: `ovos-logs list -w -e -s 20-12-2023 -l bus -l skills`]_  \n  \u003csup\u003e_List the logs with level WARNING and ERROR from the 20th of December 2023 until now from the logs bus.log and skills.log._\u003c/sup\u003e\n  \u003cimg width=\"1898\" alt=\"Screenshot 2023-12-25 173739\" src=\"https://github.com/emphasize/ovos-utils/assets/25036977/c5703195-4393-4989-ae40-b37638438c92\"\u003e\n---------------------\n\n- **ovos-logs reduce [options]**\n  \n  **Downsize logs to a given size (in bytes) or remove entries before a given date.**  \n    \n  _Different logs can be included using the `-l` option. If not specified, all logs will be included._  \n  _Optionally the directory where the logs are stored (`-p`) can be specified._  \n  \n  _[ex: `ovos-logs reduce`]_  \n  \u003csup\u003e_Downsize all logs to 0 bytes_\u003c/sup\u003e  \n\n  _[ex: `ovos-logs reduce -s 1000000`]_  \n  \u003csup\u003e_Downsize all logs to ~1MB (latest logs)_\u003c/sup\u003e  \n\n  _[ex: `ovos-logs reduce -d \"1-12-2023 17:00\"`]_  \n  \u003csup\u003e_Downsize all logs to entries after the specified date/time_\u003c/sup\u003e  \n\n  _[ex: `ovos-logs reduce -s 1000000 -l skills -l bus`]_  \n  \u003csup\u003e_Downsize skills.log and bus.log to ~1MB (latest logs)_\u003c/sup\u003e  \n\n---------------------\n\n- **ovos-logs show -l [servicelog]**\n\n  **Show logs**\n\n  _[ex: `ovos-logs show -l bus`]_  \n  \u003csup\u003e_Show the logs from bus.log._\u003c/sup\u003e  \n\n  _[ex: wrong servicelog]_  \n  \u003csup\u003e_**logs shown depending on the logs present in the folder_\u003c/sup\u003e\n\n","funding_links":["https://github.com/sponsors/OpenVoiceOS","https://patreon.com/openvoiceos","https://liberapay.com/OpenVoiceOS-Foundation","https://paypal.me/openvoiceos"],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOpenVoiceOS%2Fovos-utils","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FOpenVoiceOS%2Fovos-utils","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FOpenVoiceOS%2Fovos-utils/lists"}