e-marchand 4D Publish to GitHub
Publish a 4D project to GitHub with CI/CD workflows.
Scripts
Two scripts available, both support interactive and non-interactive modes.
1. publish.py - Publish to GitHub
Creates GitHub repository from 4D project.
Interactive mode:
python3 "<skill_path>/scripts/publish.py"
Non-interactive mode (with arguments):
python3 "<skill_path>/scripts/publish.py" --yes [options]
| Argument | Description |
|---|---|
--yes, -y |
Non-interactive mode |
--public |
Create public repository (default: private) |
--description "...", -d |
Repository description |
--topic {auto,4d-component,4d-project} |
GitHub topic for project type (default: auto) |
Examples:
# Interactive
python3 publish.py
# Private repo, no questions
python3 publish.py --yes
# Public repo with description
python3 publish.py --yes --public --description "My 4D component"
# Force the 4d-component topic instead of auto-detecting
python3 publish.py --yes --topic 4d-component
Repository topics
Every created repository gets the 4d topic plus one of:
4d-component— the project is reusable by other projects (it defines its own class namespace via a non-emptycomponent_classStore_nameinProject/Sources/settings.4DSettings).4d-project— otherwise, treated as a standalone project.
Detection is automatic (--topic auto, the default). In interactive mode you can
confirm or override the detected topic before the repository is created. Use
--topic 4d-component or --topic 4d-project to force a value non-interactively.
2. install_workflows.py - Add CI/CD Workflows
Installs build and release workflows.
Interactive mode:
python3 "<skill_path>/scripts/install_workflows.py"
Non-interactive mode (with arguments):
python3 "<skill_path>/scripts/install_workflows.py" --yes [options]
| Argument | Description |
|---|---|
--yes, -y |
Non-interactive mode |
--build |
Install build.yml |
--release-on-tag |
Install release workflow (triggered on tag push) |
--release-on-create |
Install release workflow (triggered on manual release) |
--no-push |
Don't commit and push changes |
Examples:
# Interactive
python3 install_workflows.py
# Build workflow only
python3 install_workflows.py --yes --build
# Build + auto-release on tag
python3 install_workflows.py --yes --build --release-on-tag
# Release on manual create only
python3 install_workflows.py --yes --release-on-create
Creating Releases
With release-on-tag workflow
git tag v1.0.0
git push origin v1.0.0
With release-on-create workflow
- Go to repository → Releases → Create new release
- Fill release details and publish
- Workflow builds and attaches
.zipto the release