ULTRA [ www.resource.optimyar.com ]

Linux uranus.pws-dns.net 5.14.0-427.42.1.el9_4.x86_64 #1 SMP PREEMPT_DYNAMIC Fri Nov 1 14:58:02 EDT 2024 x86_64

LiteSpeed

31.214.174.197 | Your IP: 3.16.107.122

Cant read [ /etc/named.conf ]

[ drwxr-xr-x ]

/ home / freeclou / .nvm / versions / node / v12.22.1 / lib / node_modules / pm2 /

Home Upload Mass Deface Mass Delete Back Connect Notify

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	Owner/Group	Permission	Last Modified	Actions
.	dir	-	freeclou/freeclou	drwxr-xr-x	2025-01-27 08:08:25
..	dir	-	freeclou/freeclou	drwxr-xr-x	2025-01-27 08:08:18
bin	dir	-	freeclou/freeclou	drwxr-xr-x	2025-01-27 08:08:18
lib	dir	-	freeclou/freeclou	drwxr-xr-x	2025-01-27 08:08:18
node_modules	dir	-	freeclou/freeclou	drwxr-xr-x	2025-01-27 08:08:25
types	dir	-	freeclou/freeclou	drwxr-xr-x	2025-01-27 08:08:25
.gitattributes	text/plain	62 B	freeclou/freeclou	-rw-r--r--	1985-10-26 08:15:00
.mocharc.js	text/plain	216 B	freeclou/freeclou	-rw-r--r--	1985-10-26 08:15:00
.travis.yml	text/plain	356 B	freeclou/freeclou	-rw-r--r--	1985-10-26 08:15:00
CHANGELOG.md	text/plain	92.87 KB	freeclou/freeclou	-rw-r--r--	1985-10-26 08:15:00
CONTRIBUTING.md	text/plain	2.78 KB	freeclou/freeclou	-rw-r--r--	1985-10-26 08:15:00
GNU-AGPL-3.0.txt	text/plain	33.71 KB	freeclou/freeclou	-rw-r--r--	1985-10-26 08:15:00
LICENSE	text/plain	17 B	freeclou/freeclou	-rw-r--r--	1985-10-26 08:15:00
README.md	text/html	6.37 KB	freeclou/freeclou	-rw-r--r--	1985-10-26 08:15:00
constants.js	text/plain	4.88 KB	freeclou/freeclou	-rw-r--r--	1985-10-26 08:15:00
index.js	text/plain	298 B	freeclou/freeclou	-rw-r--r--	1985-10-26 08:15:00
package.json	application/json	4.96 KB	freeclou/freeclou	-rw-r--r--	2021-04-30 09:45:27
paths.js	text/plain	3.37 KB	freeclou/freeclou	-rw-r--r--	1985-10-26 08:15:00
pm2	text/x-shellscript	87 B	freeclou/freeclou	-rwxr-xr-x	1985-10-26 08:15:00