{"id":17226848,"url":"https://github.com/dantleech/pttlog","last_synced_at":"2025-04-14T01:12:58.682Z","repository":{"id":62631622,"uuid":"556256554","full_name":"dantleech/pttlog","owner":"dantleech","description":"Plain Text Time Logger","archived":false,"fork":false,"pushed_at":"2025-03-26T23:33:50.000Z","size":197,"stargazers_count":7,"open_issues_count":4,"forks_count":0,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-03-27T00:26:58.755Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dantleech.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}},"created_at":"2022-10-23T12:42:22.000Z","updated_at":"2025-03-26T23:33:54.000Z","dependencies_parsed_at":"2023-01-24T03:16:10.851Z","dependency_job_id":null,"html_url":"https://github.com/dantleech/pttlog","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dantleech%2Fpttlog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dantleech%2Fpttlog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dantleech%2Fpttlog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dantleech%2Fpttlog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dantleech","download_url":"https://codeload.github.com/dantleech/pttlog/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248804825,"owners_count":21164135,"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-10-15T04:17:23.541Z","updated_at":"2025-04-14T01:12:58.655Z","avatar_url":"https://github.com/dantleech.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"Plain Text Time Logger\n======================\n\nThis is a project to create a plain text time logger in Rust.\n\n![Plain text time logger](https://user-images.githubusercontent.com/530801/204399421-aa353f56-07e7-4bb4-afb8-b85410bfd60e.gif)\n\n- Read-only TUI for a **plain-text timesheet**.\n- Supports parsing tags and tickets.\n- Day, week and year views.\n\nThis is my first Rust project, it's not pretty, but it's useful 😅\n\nUsage\n-----\n\nCreate a plain text file, and add entries to it, an entry is a `YYYY-MM-DD`\ndate followed by time ranges and descriptions. The `@` symbol can be used to\ncategorise the entry:\n\n```\n2022-11-06\n\n09:00 talking to family @personal\n09:10 walking the cat @personal\n10:45-12:00 working on @pttlog\n15:00 pairing on that difficult task @pairing\n15:23 reviewing JIRA-1234 @reviewing\n16:00 @commuting to the office\n\n2022-11-06\n\n09:00 shouting at clouds @personal\n09:30-09:40 eating breakfast @personal\n10:00 ...\n```\n\nNow run `pttlogger` with the path to your timesheet:\n\n```\n$ pttlogger mytimesheet\n```\n\nFilter\n------\n\nYou can filter the entries by hitting `f`. The grammar is _something_ like\nthis:\n\n```\nTICKET: \"\u003cticket prefix\u003e-.*\"\nTAG: alphanumeric*\nCRITERIA: TICKET|TAG|OR|AND\nOR: CRITERIA CRITERIA\nAND: CRITERIA CRITERIA\nNOT: CRITERIA\n```\n\nShow only entries tagged with `@pttlog`:\n\n```\n@pttlog\n```\n\nWith `@pttlog` and part of ticket `JIRA-1234`:\n\n```\nAND @pttlog JIRA-1234\n```\n\nWith `@pttlog` and part of ticket `JIRA-1234` OR anything which is not\n`@lunch`:\n\n```\nOR AND @pttlog JIRA-1234 NOT @lunch\n```\n\nInstallation\n------------\n\nGrab the latest release from the [releases](https://github.com/dantleech/pttlog/releases) page.\n\nConfiguration\n-------------\n\nIn order for `pttlogger` to parse and report on ticket identifiers create or\nmodify:\n\n```toml\n[[projects]]\nname=\"My Work Project\"\nticket_prefix=\"JIRA-\"\n\n[[projects]]\nname=\"Phpactor\"\nticket_prefix=\"PHPACTOR-\"\n```\n\nIn the above example \"ticket\" identiiers such as `JIRA-1234` and `PHPACTOR-1`\nwill be recognized and time will be summarised for them.\n\n\nContributing\n------------\n\nAny contributions are welcome.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdantleech%2Fpttlog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdantleech%2Fpttlog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdantleech%2Fpttlog/lists"}