{"id":22812120,"url":"https://github.com/aagam17/automated-dependency-updater","last_synced_at":"2026-02-09T05:31:15.411Z","repository":{"id":267775078,"uuid":"902317503","full_name":"AAGAM17/automated-dependency-updater","owner":"AAGAM17","description":"A CLI tool that automatically checks for outdated dependencies in Node.js projects and creates pull requests with updated versions, including changelog summaries.","archived":false,"fork":false,"pushed_at":"2024-12-12T11:09:53.000Z","size":39,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-08T06:38:14.499Z","etag":null,"topics":["automated","automated-dependency-updater","automation","dependencies","dependency","dependency-updater","node","node-js","node-module","nodejs","npm","npm-module","npm-package","npmjs","pnpm","yarn","yarn-package","yarn-packages","yarn-upgrade","yarnpkg"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/automated-dependency-updater","language":"JavaScript","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/AAGAM17.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":"2024-12-12T10:32:53.000Z","updated_at":"2024-12-12T11:43:47.000Z","dependencies_parsed_at":"2024-12-12T11:32:17.371Z","dependency_job_id":"9e3fb199-e993-485b-ad32-cc3b9cde9dfd","html_url":"https://github.com/AAGAM17/automated-dependency-updater","commit_stats":null,"previous_names":["aagam17/automated-dependency-updater"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AAGAM17%2Fautomated-dependency-updater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AAGAM17%2Fautomated-dependency-updater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AAGAM17%2Fautomated-dependency-updater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AAGAM17%2Fautomated-dependency-updater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AAGAM17","download_url":"https://codeload.github.com/AAGAM17/automated-dependency-updater/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248789887,"owners_count":21161909,"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":["automated","automated-dependency-updater","automation","dependencies","dependency","dependency-updater","node","node-js","node-module","nodejs","npm","npm-module","npm-package","npmjs","pnpm","yarn","yarn-package","yarn-packages","yarn-upgrade","yarnpkg"],"created_at":"2024-12-12T12:09:59.446Z","updated_at":"2026-02-09T05:31:15.368Z","avatar_url":"https://github.com/AAGAM17.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Automated Dependency Updater CLI Tool\n\n![License](https://img.shields.io/badge/license-MIT-blue.svg)\n![npm](https://img.shields.io/npm/v/automated-dependency-updater)\n\nA CLI tool that automatically checks for outdated dependencies in Node.js projects and creates pull requests with updated versions, including changelog summaries.\n\n[visit npmjs](https://www.npmjs.com/package/automated-dependency-updater)\n## Table of Contents\n\n- [Features](#features)\n- [Why It’s Needed](#why-its-needed)\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Usage](#usage)\n  - [Run Updater Immediately](#run-updater-immediately)\n  - [Schedule Updater](#schedule-updater)\n  - [CLI Options](#cli-options)\n- [Supported Platforms](#supported-platforms)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Features\n\n- **Supports Multiple Package Managers:** Works seamlessly with npm, Yarn, and pnpm.\n- **Customizable Update Schedules:** Schedule automated updates using cron expressions.\n- **Integration with Major VCS Platforms:** Supports GitHub, GitLab, and Bitbucket.\n- **Automated Changelog Summaries:** Includes changelog summaries in pull/merge requests.\n- **Notifications:** Sends email notifications on update statuses and failures.\n- **Semantic Versioning Categorization:** Automatically handles minor and patch updates while alerting for major updates requiring manual review.\n\n## Why It’s Needed\n\nKeeping dependencies up-to-date is essential for:\n\n- **Security:** Reduces vulnerabilities by patching known issues.\n- **Performance:** Enhances application performance with optimized dependencies.\n- **Maintenance:** Saves time by automating the tedious process of dependency management.\n- **Compliance:** Ensures compatibility with the latest standards and practices.\n\nAutomating this process helps developers maintain their projects efficiently and minimizes the risk of outdated or vulnerable dependencies.\n\n## Installation\n\nYou can install the **Automated Dependency Updater** globally or use it via `npx`.\n\n### Using npm\n\n```bash\nnpm install -g automated-dependency-updater\n```\n\n### Using Yarn\n\n```bash\nyarn global add automated-dependency-updater\n```\n\n### Using pnpm\n\n```bash\npnpm add -g automated-dependency-updater\n```\n\n### Using npx\n\nYou can run the updater without installing it globally:\n\n```bash\nnpx automated-dependency-updater run\n```\n\n## Configuration\n\nBefore using the updater, you need to configure environment variables for authentication and repository details.\n\n### 1. **Copy `.env.example` to `.env`**\n\n```bash\ncp .env.example .env\n```\n\n### 2. **Populate the `.env` File**\n\nOpen the `.env` file and fill in the required details:\n\n```env\n# GitHub Configuration\nGITHUB_TOKEN=your_github_token\nGITHUB_OWNER=your_github_username\nGITHUB_REPO=your_repo_name\nGITHUB_BASE_BRANCH=main\n\n# GitLab Configuration\nGITLAB_TOKEN=your_gitlab_token\nGITLAB_PROJECT_ID=your_gitlab_project_id\nGITLAB_BASE_BRANCH=main\n\n# Bitbucket Configuration\nBITBUCKET_TOKEN=your_bitbucket_token\nBITBUCKET_WORKSPACE=your_bitbucket_workspace\nBITBUCKET_REPO_SLUG=your_repo_slug\nBITBUCKET_BASE_BRANCH=main\n\n# Email Configuration\nEMAIL_USER=your_email@example.com\nEMAIL_PASS=your_email_password\nNOTIFICATION_EMAIL=notify@example.com\n\n# Platform Configuration\nPLATFORM=github  # Options: github, gitlab, bitbucket\n```\n\n**🔑 Important:**\n\n- **Tokens and Permissions:**\n  - **GitHub Token:** Should have `repo` and `workflow` scopes.\n  - **GitLab Token:** Should have `api` scope.\n  - **Bitbucket Token:** Should have appropriate repository access scopes.\n- **Email Credentials:** Use application-specific passwords if using services like Gmail.\n- **Security:** Never commit your `.env` file to version control. Consider using secret management tools for enhanced security.\n\n## Usage\n\nThe CLI tool offers various commands and options to manage dependency updates effectively.\n\n### Run Updater Immediately\n\nExecute the updater to check for outdated dependencies and create pull/merge requests.\n\n```bash\ndep-updater run\n```\n\n*Or using npx:*\n\n```bash\nnpx automated-dependency-updater run\n```\n\n### Schedule Updater\n\nSchedule the updater to run automatically at specified intervals using cron expressions.\n\n```bash\ndep-updater schedule \"0 0 * * SUN\"\n```\n\n*This example schedules the updater to run every Sunday at midnight.*\n\n*Or using npx:*\n\n```bash\nnpx automated-dependency-updater schedule \"0 0 * * SUN\"\n```\n\n### CLI Options\n\nEnhance the functionality with additional options:\n\n- **Specify Platform:**\n\n  Define the platform (`github`, `gitlab`, `bitbucket`) for pull/merge request creation.\n\n  ```bash\n  dep-updater run --platform gitlab\n  ```\n\n- **Enable Verbose Logging:**\n\n  Enable detailed logs for better insight during the update process.\n\n  ```bash\n  dep-updater run --verbose\n  ```\n\n- **Combine Options:**\n\n  Use multiple options simultaneously for tailored operations.\n\n  ```bash\n  dep-updater run --platform bitbucket --verbose\n  ```\n\n### Default Command\n\nYou can also run the updater without specifying the `run` command explicitly:\n\n```bash\ndep-updater\n```\n\n*Or using npx:*\n\n```bash\nnpx automated-dependency-updater\n```\n\n## Supported Platforms\n\nThe updater supports integration with the following Version Control Systems (VCS) platforms:\n\n- **GitHub:** Create Pull Requests.\n- **GitLab:** Create Merge Requests.\n- **Bitbucket:** Create Pull Requests.\n\nEnsure you have the necessary tokens and permissions configured in your `.env` file for the respective platforms.\n\n## Contributing\n\nContributions are welcome! Follow these steps to contribute to the project:\n\n1. **Fork the Repository**\n\n2. **Clone Your Fork**\n\n   ```bash\n   git clone https://github.com/AAGAM17/automated-dependency-updater.git\n   cd automated-dependency-updater\n   ```\n\n3. **Install Dependencies**\n\n   ```bash\n   npm install\n   ```\n\n4. **Create a Feature Branch**\n\n   ```bash\n   git checkout -b feature/YourFeatureName\n   ```\n\n5. **Commit Your Changes**\n\n   ```bash\n   git commit -m \"Add Your Feature\"\n   ```\n\n6. **Push to Your Fork**\n\n   ```bash\n   git push origin feature/YourFeatureName\n   ```\n\n7. **Open a Pull Request**\n\n   Visit the original repository and create a pull request from your fork.\n\n### **Guidelines:**\n\n- **Code Quality:** Ensure your code follows the project's coding standards and passes all tests.\n- **Documentation:** Update the `README.md` and other relevant documentation as needed.\n- **Tests:** Add or update tests to cover your changes.\n\n## License\n\nThis project is licensed under the [MIT License](LICENSE).\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faagam17%2Fautomated-dependency-updater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faagam17%2Fautomated-dependency-updater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faagam17%2Fautomated-dependency-updater/lists"}