#acupoftea - mail.ontime-ae.com

System	:	Linux server1.ontime-gulf.com 4.18.0-553.5.1.el8_10.x86_64 #1 SMP Wed Jun 5 09:12:13 EDT 2024 x86_64
Software	:	Apache
Server	:	162.0.230.206
Domains	:	40 Domain
Permission	:	[ drwxr-xr-x ]
	:	/ lib / node_modules / pm2 /

216.73.216.168

Home

File CONTRIBUTING.md

# Contributing

## Cloning PM2 development

```bash
$ git clone https://github.com/Unitech/pm2.git
$ cd pm2
$ git checkout development
$ npm install
```

I recommend having a pm2 alias pointing to the development version to make it easier to use pm2 development:

```
$ cd pm2/
$ echo "alias pm2='`pwd`/bin/pm2'" >> ~/.bashrc
```

You are now able to use pm2 in dev mode:

```
$ pm2 update
$ pm2 ls
```

## Project structure

```
.
├── bin      // pm2, pmd, pm2-dev, pm2-docker are there
├── examples // examples files
├── lib      // source files
├── pres     // presentation files
├── test     // test files
└── types    // TypeScript definition files
```

## Modifying the Daemon

When you modify the Daemon (lib/Daemon.js, lib/God.js, lib/God/*, lib/Watcher.js), you must restart the pm2 Daemon by doing:

```
$ pm2 update
```

## Commit rules

### Commit message

A good commit message should describe what changed and why.

It should :
  * contain a short description of the change (preferably 50 characters or less)
  * be entirely in lowercase with the exception of proper nouns, acronyms, and the words that refer to code, like function/variable names
  * be prefixed with one of the following word
    * fix : bug fix
    * hotfix : urgent bug fix
    * feat : new or updated feature
    * docs : documentation updates
    * BREAKING : if commit is a breaking change
    * refactor : code refactoring (no functional change)
    * perf : performance improvement
    * style : UX and display updates
    * test : tests and CI updates
    * chore : updates on build, tools, configuration ...
    * Merge branch : when merging branch
    * Merge pull request : when merging PR

## Tests

There are two tests type. Programmatic and Behavioral.
The main test command is `npm test`

### Programmatic

Programmatic tests are runned by doing

```
$ bash test/pm2_programmatic_tests.sh
```

This test files are located in test/programmatic/*

### Behavioral

Behavioral tests are runned by doing:

```
$ bash test/e2e.sh
```

This test files are located in test/e2e/*

## File of interest

- `$HOME/.pm2` contain all PM2 related files
- `$HOME/.pm2/logs` contain all applications logs
- `$HOME/.pm2/pids` contain all applications pids
- `$HOME/.pm2/pm2.log` PM2 logs
- `$HOME/.pm2/pm2.pid` PM2 pid
- `$HOME/.pm2/rpc.sock` Socket file for remote commands
- `$HOME/.pm2/pub.sock` Socket file for publishable events

## Generate changelog

### requirements

```
npm install git-changelog -g
```

### usage

Edit .changelogrc
Change "version_name" to the next version to release (example 1.1.2).
Change "tag" to the latest existing tag (example 1.1.1).

Run the following command into pm2 directory
```
git-changelog
```

It will generate currentTagChangelog.md file.
Just copy/paste the result into changelog.md

Name	Type	Size	Permission	Last Modified	Actions
.	DIR	-	drwxr-xr-x	2026-01-20 04:24:47
..	DIR	-	drwxr-xr-x	2026-03-05 10:57:26
bin	DIR	-	drwxr-xr-x	2026-01-20 04:24:47
lib	DIR	-	drwxr-xr-x	2026-01-20 04:24:47
node_modules	DIR	-	drwxr-xr-x	2026-01-20 04:24:47
types	DIR	-	drwxr-xr-x	2026-01-20 04:24:47
.gitattributes	text/plain	62 B	-rw-r--r--	2026-01-20 04:24:46
.mocharc.js	text/plain	216 B	-rw-r--r--	2026-01-20 04:24:46
CHANGELOG.md	text/plain	101.42 KB	-rw-r--r--	2026-01-20 04:24:47
CONTRIBUTING.md	text/plain	2.78 KB	-rw-r--r--	2026-01-20 04:24:47
GNU-AGPL-3.0.txt	text/plain	33.71 KB	-rw-r--r--	2026-01-20 04:24:47
LICENSE	text/plain	17 B	-rw-r--r--	2026-01-20 04:24:46
README.md	text/html	6.31 KB	-rw-r--r--	2026-01-20 04:24:47
bun.lock	text/plain	18.62 KB	-rw-r--r--	2026-01-20 04:24:47
constants.js	text/plain	4.98 KB	-rw-r--r--	2026-01-20 04:24:47
e2e_time	text/plain	496 B	-rw-r--r--	2026-01-20 04:24:46
index.js	text/plain	303 B	-rw-r--r--	2026-01-20 04:24:47
package.json	text/plain	4.43 KB	-rw-r--r--	2026-01-20 04:24:47
paths.js	text/plain	3.38 KB	-rw-r--r--	2026-01-20 04:24:47
pm2	text/x-shellscript	220 B	-rwxr-xr-x	2026-01-20 04:24:46
preinstall.js	text/plain	689 B	-rw-r--r--	2026-01-20 04:24:47
run.sh	text/x-shellscript	136 B	-rw-r--r--	2026-01-20 04:24:47
unit_time	text/plain	2.42 KB	-rw-r--r--	2026-01-20 04:24:46

~ ACUPOFTEA - mail.ontime-ae.com