{"id":27239677,"url":"https://github.com/mcarvin8/sf-package-list","last_synced_at":"2026-02-02T20:13:59.299Z","repository":{"id":282639994,"uuid":"949221851","full_name":"mcarvin8/sf-package-list","owner":"mcarvin8","description":"Convert a Salesforce manifest (package.xml) into a list","archived":false,"fork":false,"pushed_at":"2025-04-01T12:01:06.000Z","size":1022,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-04-01T12:44:50.883Z","etag":null,"topics":["converter","deployment","manifest","salesforce"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/mcarvin8.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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":"2025-03-16T00:13:01.000Z","updated_at":"2025-04-01T12:00:58.000Z","dependencies_parsed_at":"2025-04-01T12:40:50.963Z","dependency_job_id":null,"html_url":"https://github.com/mcarvin8/sf-package-list","commit_stats":null,"previous_names":["mcarvin8/sf-package-list"],"tags_count":5,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcarvin8%2Fsf-package-list","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcarvin8%2Fsf-package-list/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcarvin8%2Fsf-package-list/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mcarvin8%2Fsf-package-list/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mcarvin8","download_url":"https://codeload.github.com/mcarvin8/sf-package-list/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248280220,"owners_count":21077412,"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":["converter","deployment","manifest","salesforce"],"created_at":"2025-04-10T19:13:37.130Z","updated_at":"2026-02-02T20:13:59.288Z","avatar_url":"https://github.com/mcarvin8.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sf-package-list\n\n[![NPM](https://img.shields.io/npm/v/sf-package-list.svg?label=sf-package-list)](https://www.npmjs.com/package/sf-package-list)\n[![Downloads/week](https://img.shields.io/npm/dw/sf-package-list.svg)](https://npmjs.org/package/sf-package-list)\n[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/mcarvin8/sf-package-list/main/LICENSE.md)\n[![Maintainability](https://qlty.sh/badges/3f1779cc-038e-48f0-b693-52f72e106d67/maintainability.svg)](https://qlty.sh/gh/mcarvin8/projects/sf-package-list)\n[![Code Coverage](https://qlty.sh/badges/3f1779cc-038e-48f0-b693-52f72e106d67/test_coverage.svg)](https://qlty.sh/gh/mcarvin8/projects/sf-package-list)\n\nA Salesforce CLI plugin that helps you convert `package.xml` files to a simple, human-readable list format—and back again.\n\nThis makes working with metadata easier for admins and developers, especially in version control systems, automation pipelines, or anywhere you want to quickly review or edit what's being deployed.\n\n---\n\n## Install\n\n```bash\nsf plugins install sf-package-list\n```\n\n---\n\n## What It Does\n\nThis plugin lets you:\n\n- Convert a Salesforce `package.xml` to a cleaner, flat **package list**\n- Convert a **package list** back into a valid `package.xml`\n\nBoth directions are supported. The list format uses `TypeName: member1, member2` per line—easy to read, edit, and diff. No XML knowledge required. Works well with version control and CI/CD pipelines.\n\n---\n\n## Examples\n\n\u003cdetails\u003e\n\u003csummary\u003epackage.xml (click to expand)\u003c/summary\u003e\n\n```xml\n\u003c?xml version=\"1.0\" encoding=\"UTF-8\"?\u003e\n\u003cPackage xmlns=\"http://soap.sforce.com/2006/04/metadata\"\u003e\n    \u003ctypes\u003e\n        \u003cmembers\u003eAlways_Be_Closing\u003c/members\u003e\n        \u003cmembers\u003eAttention_Interest_Decision_Action\u003c/members\u003e\n        \u003cmembers\u003eLeads_Are_Gold\u003c/members\u003e\n        \u003cname\u003eCustomLabel\u003c/name\u003e\n    \u003c/types\u003e\n    \u003ctypes\u003e\n        \u003cmembers\u003eABC\u003c/members\u003e\n        \u003cmembers\u003eGlengarry\u003c/members\u003e\n        \u003cmembers\u003eMitch_And_Murray\u003c/members\u003e\n        \u003cname\u003eCustomObject\u003c/name\u003e\n    \u003c/types\u003e\n    \u003ctypes\u003e\n        \u003cmembers\u003eGlengarry.Weak_Leadz__c\u003c/members\u003e\n        \u003cmembers\u003eCoffee.is_Closer__c\u003c/members\u003e\n        \u003cname\u003eCustomField\u003c/name\u003e\n    \u003c/types\u003e\n    \u003ctypes\u003e\n        \u003cmembers\u003eunfiled$public/Second_Prize_Set_of_Steak_Knives\u003c/members\u003e\n        \u003cname\u003eEmailTemplate\u003c/name\u003e\n    \u003c/types\u003e\n    \u003ctypes\u003e\n        \u003cmembers\u003eGlengarry_Leads\u003c/members\u003e\n        \u003cmembers\u003eCadillac_Eldorado\u003c/members\u003e\n        \u003cname\u003eStandardValueSet\u003c/name\u003e\n    \u003c/types\u003e\n    \u003cversion\u003e59.0\u003c/version\u003e\n\u003c/Package\u003e\n```\n\n\u003c/details\u003e\n\n### Package List\n\n\u003e Separate multiple metadata members using a comma.\n\n```\nCustomLabel: Always_Be_Closing, Attention_Interest_Decision_Action, Leads_Are_Gold\nCustomObject: ABC, Glengarry, Mitch_And_Murray\nCustomField: Glengarry.Weak_Leadz__c, Coffee.is_Closer__c\nEmailTemplate: unfiled$public/Second_Prize_Set_of_Steak_Knives\nStandardValueSet: Glengarry_Leads, Cadillac_Eldorado\nVersion: 59.0\n```\n\n---\n\n## Commands\n\n| Command                                            | Description                |\n| -------------------------------------------------- | -------------------------- |\n| `sf sfpl list -x package.xml [-l output.txt] [-n]` | Convert package.xml → list |\n| `sf sfpl xml -l list.txt [-x package.xml] [-n]`    | Convert list → package.xml |\n\n**Flags:** `-x` / `--package-xml` — path to package.xml. `-l` / `--package-list` — path to list file. `-n` / `--no-api-version` — exclude API version from output.\n\n**Quick start:**\n\n```bash\nsf sfpl list -x package.xml -l package.txt\nsf sfpl xml -l package.txt -x package.xml\n```\n\n---\n\n## Troubleshooting\n\n- **Invalid package.xml** — When converting package.xml to list format, any errors from `@salesforce/source-deploy-retrieve` (e.g. unknown metadata types, parse errors) are included in the warning message. You'll get a warning and empty output; confirm the file is valid or check the warning for SDR details.\n- **Invalid list lines** — Each invalid line is skipped with a warning showing the line content. Output continues for valid lines.\n\nThe plugin does not fail on invalid or missing inputs; it produces empty output instead.\n\nNote: A missing metadata type definition can also occur if the type is newer than the @salesforce/source-deploy-retrieve version bundled with this plugin. Upgrading the plugin may resolve the issue for newly released metadata types.\n\n---\n\n## Use Case\n\nWorks well with `sfdx-git-delta` and CI/CD. Instead of copying `package.xml`, developers can paste metadata in list format—e.g., in merge request descriptions or CI variables. Also useful for destructive deployments: paste a list into a form field and convert to `destructiveChanges.xml`.\n\n---\n\n## Issues\n\nFound a bug or have an idea? [Open an issue](https://github.com/mcarvin8/sf-package-list/issues).\n\n---\n\n## License\n\n[MIT](https://raw.githubusercontent.com/mcarvin8/sf-package-list/main/LICENSE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcarvin8%2Fsf-package-list","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmcarvin8%2Fsf-package-list","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmcarvin8%2Fsf-package-list/lists"}