{"id":43352167,"url":"https://github.com/dimagi/dependency-metrics","last_synced_at":"2026-02-02T02:32:36.970Z","repository":{"id":153598037,"uuid":"613467392","full_name":"dimagi/dependency-metrics","owner":"dimagi","description":"Python tool to help monitor a project's dependencies and how out of date they are.","archived":false,"fork":false,"pushed_at":"2025-05-23T15:50:13.000Z","size":76,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":13,"default_branch":"main","last_synced_at":"2025-12-05T17:48:38.152Z","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":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dimagi.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,"zenodo":null}},"created_at":"2023-03-13T16:14:42.000Z","updated_at":"2025-05-23T15:50:14.000Z","dependencies_parsed_at":"2025-04-10T20:27:54.825Z","dependency_job_id":"9dffca6f-fa02-44c2-9384-c3d2261e2ac0","html_url":"https://github.com/dimagi/dependency-metrics","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/dimagi/dependency-metrics","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dimagi%2Fdependency-metrics","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dimagi%2Fdependency-metrics/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dimagi%2Fdependency-metrics/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dimagi%2Fdependency-metrics/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dimagi","download_url":"https://codeload.github.com/dimagi/dependency-metrics/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dimagi%2Fdependency-metrics/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29001654,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-02T01:32:03.847Z","status":"online","status_checked_at":"2026-02-02T02:00:07.448Z","response_time":58,"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":"2026-02-02T02:32:36.195Z","updated_at":"2026-02-02T02:32:36.963Z","avatar_url":"https://github.com/dimagi.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Welcome to dependency-metrics ##\r\n\r\n### Summary\r\nA command line tool to analyze and monitor how up-to-date dependencies of a project are. For more detail, see the [Usage](#usage) section below.\r\n\r\n#### Supported Package Managers\r\n- pip or uv\r\n- yarn\r\n\r\n#### Supported Application Monitoring Platforms\r\n- DataDog\r\n\r\n\r\n### Usage\r\nRun the `metrics` tool from within the repository you wish to generate metrics for.\r\n\r\n#### Default behavior\r\n\r\nAll that is needed is the package manager you want to generate metrics for, and `metrics` will output a table detailing\r\nhow out-of-date each dependency is.\r\n\r\n```commandline\r\n$ metrics pip\r\nBehind   Package                      Latest       Version\r\n0.1.0    my-depedency                 1.1.0        1.0.0\r\n2.0.0    my-other-dependency          3.2.1        1.2.3\r\n```\r\n\r\n#### --stats option\r\n\r\nUse the `--stats` option to generate a simple dictionary that displays the total number of outdated dependencies, as well as a breakdown detailing the number of outdated dependencies for each version type.\r\n\r\n```commandline\r\n$ metrics pip --stats\r\nTotal: 5\r\nOutdated: 2\r\nMulti-Major: 1\r\nMajor: 0\r\nMinor: 1\r\nPatch: 0\r\nUnknown: 0\r\n```\r\n\r\n#### --send option\r\n\r\n\u003e **NOTE:**  Additional setup is required to successfully post stats to a supported backend. See [platform setup](#application-monitoring-platform-setup) for further information.\r\n\r\nUse the `--send` option to post the same metrisc generated by `--stats` to an application monitoring platform.\r\n\r\n```commandline\r\n$ metrics pip --send\r\n```\r\n\r\n### Application Monitoring Platform Setup\r\nThis is required to make use of the `--send` option, enabling the ability to send generated stats to a backend of your choice.\r\n\r\n#### DataDog\r\nSet the `DATADOG_API_KEY` and `DATADOG_APP_KEY` environment variables in the environment you will run `metrics \u003cpackage_manager\u003e --send` from.\r\n\r\n### Development\r\n\r\n#### Requirements\r\n\r\n```commandline\r\npip install -e .  # installs dependencies defined in pyproject.toml\r\npip install -e .[test]  # installs test dependencies -- '.[test]' if using zsh\r\n```\r\n\r\n#### Tests\r\nMust install test dependencies first. See [requirements](#requirements) above.\r\n\r\n```commandline\r\nnose2  # runs all tests\r\nnose2 dot.path.to.file.class.or.test  # runs specific test\r\n```\r\n\r\n### Publishing to PyPI\r\n\r\nTo publish a new release on [pypi.org](https://pypi.org/p/dependency-metrics/):\r\n\r\n- Update `__version__` in [dependency_metrics/_\\_init__.py](dependency_metrics/__init__.py).\r\n- Create and push a git tag with the new version number.\r\n  ```sh\r\n  git tag vX.Y.Z\r\n  git push --tags\r\n  ```\r\n- Wait for the [pypi.yml workflow](https://github.com/dimagi/dependency-metrics/actions/workflows/pypi.yml)\r\n  to build and publish the new release.\r\n\r\nA dev release is published on [test.pypi.org](https://test.pypi.org/p/dependency-metrics/)\r\non each new push or merge to main. A dev release may also be published\r\non-demand for any branch with\r\n[workflow dispatch](https://github.com/dimagi/dependency-metrics/actions/workflows/pypi.yml).\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdimagi%2Fdependency-metrics","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdimagi%2Fdependency-metrics","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdimagi%2Fdependency-metrics/lists"}