{"id":18649532,"url":"https://github.com/k4j8/watson-graphing","last_synced_at":"2025-10-26T23:07:06.724Z","repository":{"id":174219057,"uuid":"651941032","full_name":"k4j8/watson-graphing","owner":"k4j8","description":"Create graphs from Watson time-tracking data","archived":false,"fork":false,"pushed_at":"2025-09-23T22:41:28.000Z","size":128,"stargazers_count":2,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-10-06T14:48:39.189Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/k4j8.png","metadata":{"files":{"readme":"README.md","changelog":null,"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":"2023-06-10T15:07:42.000Z","updated_at":"2025-09-23T22:41:31.000Z","dependencies_parsed_at":null,"dependency_job_id":"81faea22-7b64-43b0-867f-3cd08a5f8426","html_url":"https://github.com/k4j8/watson-graphing","commit_stats":null,"previous_names":["k4j8/watson-graphing"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/k4j8/watson-graphing","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k4j8%2Fwatson-graphing","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k4j8%2Fwatson-graphing/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k4j8%2Fwatson-graphing/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k4j8%2Fwatson-graphing/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/k4j8","download_url":"https://codeload.github.com/k4j8/watson-graphing/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/k4j8%2Fwatson-graphing/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":281185454,"owners_count":26457747,"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","status":"online","status_checked_at":"2025-10-26T02:00:06.575Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-07T06:38:53.990Z","updated_at":"2025-10-26T23:07:06.680Z","avatar_url":"https://github.com/k4j8.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# watson-graphing\n\nwatson-graphing is a command-line program that generates graphs from [Watson](https://tailordev.github.io/Watson/), a command-line manual time-tracking tool.\n\n## Basic Example\n\nTo plot data from the past week using defaults, just run the program with no options:\n```\n$ watson-graphing\n```\n![watson_graphing_basic](example-images/watson_graphing_basic.png)\n\n## Detailed Example\n\nTo plot Watson data for the specified plots (hours, attributes, and location), with the totals bar chart, by month, sorting alphabetically, truncating project names before the first period, showing the date range in the title of each chart, using data from the past year, and excluding the projects `break` and `pto`, run:\n```\n$ watson-graphing --plot hours attributes location --totals --period month --sort name --truncate --date year ignore-project break ignore-project pto\n```\n![watson_graphing_full_1](example-images/watson_graphing_full_1.png)\n![watson_graphing_full_2](example-images/watson_graphing_full_2.png)\n\n## Getting Started\n\n### Installation\n\nThis project is not published on PyPI (pip) yet. If you would like it to be, please open an issue.\n\nTo install, clone/download the repository and then install.\n```\n$ git clone https://github.com/k4j8/watson-graphing.git\n$ pip install --editable watson-graphing\n```\n\nTo update, just run `git pull`.\n\n### Usage\n\nWatson must also be installed and have at least one frame to show for watson-graphing to work. Commands take the form `watson-graphing [options] WATSON_ARGS...`.\n\n- `[options]` are available via `watson-graphing --help`\n- `WATSON_ARGS` are inputs to the cammand `watson log...` WITHOUT hyphens. (Weird, I know, but it works.)\n\nFor example, to plot the result of `watson log --project voyager2 --project apollo11`, run `watson-graphing project voyager2 project apollo11`.\n\nKeep in mind `watson log` defaults to the past 7 days, so to get more data you need to include `year`, `all`, or any other option available via `watson log`.\n\nwatson-graphing splits Watson's tags into two categories: attributes and locations. Locations are tags beginning with `@` such as `@office` or `@home`. Attributes are all other tags.\n\n## Contributing\n\nThis is a personal project, but I'm willing to make it more universal if there's an interest. Please use the issue tracker if you have suggestions, feedback, or want to contribute.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fk4j8%2Fwatson-graphing","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fk4j8%2Fwatson-graphing","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fk4j8%2Fwatson-graphing/lists"}