{"id":20716380,"url":"https://github.com/mvladislav/vm-clockify","last_synced_at":"2025-10-11T04:36:27.131Z","repository":{"id":58541642,"uuid":"425046330","full_name":"MVladislav/vm-clockify","owner":"MVladislav","description":"lazy:: only done because of logging time in clockify and too lazy to manually copy and paste them into youtrack","archived":false,"fork":false,"pushed_at":"2025-05-29T18:45:16.000Z","size":288,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-29T19:52:21.595Z","etag":null,"topics":["clockify","python3","youtrack-api"],"latest_commit_sha":null,"homepage":"","language":"Python","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/MVladislav.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-11-05T18:23:03.000Z","updated_at":"2025-04-04T19:48:07.000Z","dependencies_parsed_at":"2023-02-13T01:10:15.892Z","dependency_job_id":"30d95b43-0541-4ffc-a741-f0f54a085261","html_url":"https://github.com/MVladislav/vm-clockify","commit_stats":null,"previous_names":[],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/MVladislav/vm-clockify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MVladislav%2Fvm-clockify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MVladislav%2Fvm-clockify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MVladislav%2Fvm-clockify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MVladislav%2Fvm-clockify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/MVladislav","download_url":"https://codeload.github.com/MVladislav/vm-clockify/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/MVladislav%2Fvm-clockify/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259719716,"owners_count":22901238,"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":["clockify","python3","youtrack-api"],"created_at":"2024-11-17T03:05:38.467Z","updated_at":"2025-10-11T04:36:22.077Z","avatar_url":"https://github.com/MVladislav.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Python CLI Clockify API\n\n```sh\n    MVladislav\n```\n\n[![Python DEV CI](https://github.com/MVladislav/vm-clockify/actions/workflows/python-dev.yml/badge.svg)](https://github.com/MVladislav/vm-clockify/actions/workflows/python-dev.yml)\n[![Create Release](https://github.com/MVladislav/vm-clockify/actions/workflows/python-release.yml/badge.svg)](https://github.com/MVladislav/vm-clockify/actions/workflows/python-release.yml)\n\n---\n\n- [Python CLI Clockify API](#python-cli-clockify-api)\n  - [information](#information)\n    - [example usage](#example-usage)\n    - [clockify task-name and project-name usage](#clockify-task-name-and-project-name-usage)\n    - [config](#config)\n  - [install](#install)\n\n---\n\nproject to use api from [clockify](https://clockify.me/developers-api) to collect work-time\n\nin a combined way by `[day, project, task]`\n\n## information\n\n### example usage\n\nget 2-days of work from clockify with start day `2023-02-07`\n\n- `-d 1` =\u003e will return 2 days, the requested day + the day before\n- `-p 1000` =\u003e allow to include 1000 entries from clockify over 2 days\n- `-sp '2023-02-07'` =\u003e the start day to collect work from\n\n```sh\n$vm-clockify clockify times -d 1 -p 1000 -sp '2023-02-07'\n```\n\nupload the gathered work from command above into youtrack\n\n```sh\n$vm-clockify youtrack upload\n```\n\n### clockify task-name and project-name usage\n\nthis script will parse the **task**-name and **project**-name usage and search for brackets like `\u003cDESCRIPTION\u003e [\u003cURL-PARAM-SYNTAX\u003e]`\nwhere you can write **issue-id** in it, for example:\n\n\u003e only the last bracket in a description will be checked\n\n- `i` =\u003e issue-id\n- `t` =\u003e issue-type-name\n\n```txt\nsome description task [i=ISSUE-666]\n```\n\nor\n\n```txt\nsome description task [i=ISSUE-666\u0026t=Training]\n```\n\nThis **issue-id** can than be used to import the time into services like youtrack, and **issue-type-name** to mark the issue in youtrack with an type.\n\n### config\n\nsetup `.env` file with following possible params:\n\n```env\n# optional\nLOGGING_LEVEL=DEBUG\nLOGGING_VERBOSE=3\n\n# need to be correct set, to work with youtrack correct\nTIME_ZONE=Europe/Berlin\n\n# optional\nWORK_TIME_DEFAULT_ISSUE=\u003cADD_ISSUE_HERE\u003e\nWORK_TIME_DEFAULT_COMMENT=\u003cADD_TEXT_HERE\u003e\n\n# -\u003e if get worktime from clockify is used\n# https://clockify.me/user/settings\nCLOCKIFY_API_KEY=\u003cADD_KEY_HERE\u003e\n# get by use command 'api user'\nCLOCKIFY_API_WORKSPACE_ID=\u003cADD_ID_HERE\u003e\nCLOCKIFY_API_USER_ID=\u003cADD_ID_HERE\u003e\n\n# -\u003e if upload to youtrack is used\n# https://www.jetbrains.com/help/youtrack/devportal/Manage-Permanent-Token.html#obtain-permanent-token\nYOUTRACK_API_KEY=\u003cADD_HERE\u003e\nYOUTRACK_API_ENDPOINT=\u003cADD_HERE\u003e\n\n# -\u003e if upload to landwehr is used\nLANDWEHR_API_URL=\u003cADD_HERE\u003e\nLANDWEHR_API_ENDPOINT=/index.php\nLANDWEHR_COMPANY=\u003cADD_HERE\u003e\nLANDWEHR_MAND_NR=\u003cADD_HERE\u003e\nLANDWEHR_USERNAME=\u003cADD_HERE\u003e\nLANDWEHR_PASSWORD=\u003cADD_HERE\u003e\n```\n\n## install\n\n```sh\n$python3 -m pip install .\n```\n\nor\n\n```sh\n$python3 -m pip install virtualenv --break-system-packages\n$python3 -m venv venv\n$source ./venv/bin/activate\n$python3 -m pip install -v --editable .\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvladislav%2Fvm-clockify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmvladislav%2Fvm-clockify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmvladislav%2Fvm-clockify/lists"}