Skip to content

Commit 83d71e8

Browse files
authored
Merge pull request #352 from intersystems/document-pull-event-handlers
Issue #350 documented pull event class
2 parents 59a04d9 + c2c691e commit 83d71e8

File tree

1 file changed

+8
-0
lines changed

1 file changed

+8
-0
lines changed

README.md

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,12 @@ This might look like:
5858
5959
![Example of mapping configuration](docs/images/settings.PNG "Example of mapping configuration")
6060
61+
### Pull Event Handlers
62+
63+
The ##class(SourceControl.Git.PullEventHandler) is a base class that can be extended in order to develop functionality that should be run when the repository pulls from remote. The code placed inside the subclass' OnPull() method will be executed any time a pull occurs.
64+
65+
A recommended way to implement CI/CD would be to use one of the pre-defined subclasses of PullEventHandler that are placed inside the PullEventHandler package. Additionally, custom load logic can be placed in that package following the model of the existing subclasses.
66+
6167
### Security
6268
6369
#### Unsecured (http) connections
@@ -99,6 +105,8 @@ Assuming you have the local and remote repositories created,
99105
`git config core.sshCommand 'ssh -i ~/.ssh/<private key name>'`
100106
8. Test the refresh button for the remote branches on the WebUI, fetch from the source control menu in Studio or VS Code, and `git fetch` in Git Bash. All 3 should work without any issues.
101107
108+
109+
102110
## During Development
103111
104112
:warning: Whenever any code in this project is updated outside the server (e.g. after every `git pull`), you _have_ to run `zpm "load <absolute path to git-source-control>"`. Otherwise, the changes won't be reflected on the server. However, if you load git-source-control via the InterSystems package manager and run `git pull` via the extension itself with the default pull event handler configured, it'll just work.

0 commit comments

Comments
 (0)