{"id":18635770,"url":"https://github.com/xpack-dev-tools/xbb-helper-xpack","last_synced_at":"2025-04-11T08:30:48.056Z","repository":{"id":60925948,"uuid":"545463693","full_name":"xpack-dev-tools/xbb-helper-xpack","owner":"xpack-dev-tools","description":"A source xPack with scripts and other files to support XBB builds","archived":false,"fork":false,"pushed_at":"2024-04-13T18:35:42.000Z","size":2466,"stargazers_count":0,"open_issues_count":0,"forks_count":3,"subscribers_count":3,"default_branch":"xpack","last_synced_at":"2024-04-14T07:01:05.423Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"C","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/xpack-dev-tools.png","metadata":{"files":{"readme":"README-MAINTAINER.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":null,"patreon":null,"open_collective":null,"ko_fi":"ilegeul","tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2022-10-04T12:20:42.000Z","updated_at":"2024-04-15T11:44:31.143Z","dependencies_parsed_at":"2023-11-08T02:53:03.804Z","dependency_job_id":"665b83a1-b53e-45bc-8bc6-1258e760121b","html_url":"https://github.com/xpack-dev-tools/xbb-helper-xpack","commit_stats":{"total_commits":1265,"total_committers":1,"mean_commits":1265.0,"dds":0.0,"last_synced_commit":"fc4fb47c6bad858ba6d0759d61367613e0e751f4"},"previous_names":[],"tags_count":168,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xpack-dev-tools%2Fxbb-helper-xpack","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xpack-dev-tools%2Fxbb-helper-xpack/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xpack-dev-tools%2Fxbb-helper-xpack/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xpack-dev-tools%2Fxbb-helper-xpack/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xpack-dev-tools","download_url":"https://codeload.github.com/xpack-dev-tools/xbb-helper-xpack/tar.gz/refs/heads/xpack","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248361469,"owners_count":21090906,"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-11-07T05:26:32.806Z","updated_at":"2025-04-11T08:30:48.047Z","avatar_url":"https://github.com/xpack-dev-tools.png","language":"C","funding_links":["https://ko-fi.com/ilegeul"],"categories":[],"sub_categories":[],"readme":"[![license](https://img.shields.io/github/license/xpack-dev-tools/xbb-helper-xpack)](https://github.com/xpack-dev-tools/xbb-helper-xpack/blob/xpack/LICENSE)\n[![GitHub issues](https://img.shields.io/github/issues/xpack-dev-tools/xbb-helper-xpack.svg)](https://github.com/xpack-dev-tools/xbb-helper-xpack/issues/)\n[![GitHub pulls](https://img.shields.io/github/issues-pr/xpack-dev-tools/xbb-helper-xpack.svg)](https://github.com/xpack-dev-tools/xbb-helper-xpack/pulls)\n\n# Maintainer info\n\n## Prerequisites\n\nThe build scripts run on GNU/Linux and macOS. The Windows binaries are\ngenerated on x64 GNU/Linux, using [mingw-w64](https://mingw-w64.org).\n\nFor details on installing the prerequisites, please read the\n[Build Prerequisites](https://xpack-dev-tools.github.io/docs/developer/install/prerequisites/)\npage.\n\n## Get project sources\n\nThe project is hosted on GitHub:\n\n- \u003chttps://github.com/xpack-dev-tools/xbb-helper-xpack.git\u003e\n\nTo clone the stable branch (`xpack`), run the following commands in a\nterminal (on Windows use the _Git Bash_ console):\n\n```sh\nrm -rf ~/Work/xpack-dev-tools/xbb-helper-xpack.git \u0026\u0026 \\\nmkdir -p ~/Work/xpack-dev-tools \u0026\u0026 \\\ngit clone \\\n  https://github.com/xpack-dev-tools/xbb-helper-xpack.git \\\n  ~/Work/xpack-dev-tools/xbb-helper-xpack.git\n```\n\nFor development purposes, clone the `xpack-development` branch:\n\n```sh\nrm -rf ~/Work/xpack-dev-tools/xbb-helper-xpack.git \u0026\u0026 \\\nmkdir -p ~/Work/xpack-dev-tools \u0026\u0026 \\\ngit clone \\\n  --branch xpack-development \\\n  https://github.com/xpack-dev-tools/xbb-helper-xpack.git \\\n  ~/Work/xpack-dev-tools/xbb-helper-xpack.git\n```\n\nLink it to the user global xPacks store:\n\n```sh\nxpm link -C ~/Work/xpack-dev-tools/xbb-helper-xpack.git\n```\n\nFurther updates can be done with:\n\n```sh\ngit -C ~/Work/xpack-dev-tools/xbb-helper-xpack.git pull\n```\n\n## Release schedule\n\nThere are no scheduled releases, the project is updated when necessary.\n\n## How to make new releases\n\nBefore starting the build, perform some checks and tweaks.\n\n### Check Git\n\nIn the `xpack-dev-tools/xbb-helper-xpack` Git repo:\n\n- switch to the `xpack-development` branch\n- pull new changes\n- if needed, merge the `xpack` branch\n\nNo need to add a tag here, it'll be added when the release is created.\n\n### Increase the version\n\nDetermine the next version (like `3.1.11`) and update the\n`package.json` file; the format is `3.1.11-pre`.\n\n### Fix possible open issues\n\nCheck GitHub issues and pull requests:\n\n- \u003chttps://github.com/xpack-dev-tools/xbb-helper-xpack/issues/\u003e\n\nand fix them; assign them to a milestone (like `3.1.11`).\n\n### Check `README.md`\n\nNormally `README.md` should not need changes, but better check.\nInformation related to the new version should not be included here,\nbut in the version specific release page.\n\n### Update versions in `README` files\n\n- update version in `README-MAINTAINER.md`\n- update version in `README.md`\n\n### Update version in `package.json` to a pre-release\n\nUse the new version, suffixed by `pre`, like `3.1.11-pre`.\n\n### Update `CHANGELOG.md`\n\n- open the `CHANGELOG.md` file\n- check if all previous fixed issues are in\n- add a new entry like _* v3.1.11 released_\n- commit with a message like _prepare v3.1.11_\n\n### Push changes\n\n- commit and push\n\n### Manual tests\n\n- none\n\n### Publish on the npmjs.com server\n\n- select the `xpack-development` branch\n- commit all changes\n- `npm pack` and check the content of the archive;\n  possibly adjust `.npmignore`\n- `npm version patch`, `npm version minor`, `npm version major`\n- push the `xpack-development` branch to GitHub\n- the `postversion` npm script should also update tags via `git push origin --tags`\n\n### Publish\n\n- `npm publish --tag test` (use `npm publish --access public` when\n  publishing for the first time)\n\nThe version is visible at:\n\n- \u003chttps://www.npmjs.com/package/@xpack-dev-tools/xbb-helper?activeTab=versions\u003e\n\n### Update the repo\n\n- merge `xpack-development` into `xpack`\n- push to GitHub\n\n### Tag the npm package as `latest`\n\nWhen the release is considered stable, promote it as `latest`:\n\n- `npm dist-tag ls @xpack-dev-tools/xbb-helper`\n- `npm dist-tag add @xpack-dev-tools/xbb-helper@3.1.11 latest`\n- `npm dist-tag ls @xpack-dev-tools/xbb-helper`\n\nIf necessary, unpublish previous releases:\n\n- `npm unpublish @xpack-dev-tools/xbb-helper@3.1.11`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxpack-dev-tools%2Fxbb-helper-xpack","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxpack-dev-tools%2Fxbb-helper-xpack","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxpack-dev-tools%2Fxbb-helper-xpack/lists"}