Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/kabirbaidhya/pglistend
pglistend - A lightweight PostgreSQL LISTEN Daemon using Node.js/Systemd
https://github.com/kabirbaidhya/pglistend
daemon database listen nodejs postgres
Last synced: about 2 months ago
JSON representation
pglistend - A lightweight PostgreSQL LISTEN Daemon using Node.js/Systemd
- Host: GitHub
- URL: https://github.com/kabirbaidhya/pglistend
- Owner: kabirbaidhya
- License: mit
- Created: 2016-06-28T09:38:14.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2017-03-29T18:32:15.000Z (over 7 years ago)
- Last Synced: 2024-10-12T02:14:38.612Z (2 months ago)
- Topics: daemon, database, listen, nodejs, postgres
- Language: JavaScript
- Homepage:
- Size: 316 KB
- Stars: 28
- Watchers: 5
- Forks: 4
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-nepal - pglistend - Postgres LISTEN Daemon using NodeJS (Uncategorized / Uncategorized)
README
# pglistend
[](https://www.npmjs.com/package/pglistend) [](https://www.npmjs.com/package/pglistend) [](https://codeclimate.com/github/kabirbaidhya/pglistend)
A lightweight Postgres LISTEN Daemon built on top of [node](https://nodejs.org/en/), [node-postgres](https://github.com/brianc/node-postgres) and [systemd](https://wiki.debian.org/systemd).
It's a very simple yet generic daemon application that could be used in any project that makes use of Postgres' `LISTEN`/`NOTIFY` feature.
It runs as a background process that does `LISTEN` on the configured channels on a database and allows to perform custom actions on receiving [`NOTIFY`](https://www.postgresql.org/docs/9.1/static/sql-notify.html) signals on those channels.
Check this [simple tutorial](https://github.com/kabirbaidhya/pglistend/wiki/Tutorial:-Basics) to get started with it.
## Installation
Firstly, install the npm package globally. This will make `pglisten` CLI tool available on your system.
```bash
$ npm install -g pglistend
```
Now setup the daemon using this command.
```bash
$ sudo pglisten setup-daemon
```
Or, alternatively you can `curl` the script and run it on the fly.
```bash
$ curl https://raw.githubusercontent.com/kabirbaidhya/pglistend/master/setup/setup.py | sudo python
```
When it's done, edit your [configuration](https://github.com/kabirbaidhya/pglistend/wiki/Configuration). And finally start the service using
```bash
$ sudo systemctl start pglistend
```
## Usage
### Managing the daemon
You can use `systemd` commands to manage `pglistend`.
```bash
# Start the service
$ systemctl start pglistend
# Stop the service
$ systemctl stop pglistend
# Check service status
$ systemctl status pglistend
# Enable the service (This will start the service on bootup)
$ systemctl enable pglistend
# Disable the service (Disable the service to not start on bootup)
$ systemctl disable pglistend
```
For more information about `systemd` check [this](https://wiki.debian.org/systemd#Managing_services_with_systemd)
### Logs
All logs are written to `syslog`.
So, you can make use of `journalctl` here
```bash
$ journalctl -u pglistend
$ journalctl -f -u pglistend
```
Or, you can simply `tail` the logs like this:
```bash
$ tail /var/log/syslog | grep pglistend
$ tail -f /var/log/syslog | grep pglistend
```
Check [this](https://www.digitalocean.com/community/tutorials/how-to-use-journalctl-to-view-and-manipulate-systemd-logs) to read more about journalctl.
## Tutorials
1. [Getting Started](https://github.com/kabirbaidhya/pglistend/wiki/Tutorial:-Basics)
2. [Performing custom actions](https://github.com/kabirbaidhya/pglistend/wiki/Tutorial:-Custom-actions)
## Testing
1. Clone repository: `git clone [email protected]:kabirbaidhya/pglistend.git`
2. Install dependencies: `npm install`
3. Install other required packages:
- `pycodestyle`: `pip install pycodestyle` or `pip install --upgrade pycodestyle` [[Reference](https://github.com/PyCQA/pycodestyle)]
- `pylint`: `sudo apt-get install pylint` [[Reference](https://www.pylint.org/#install)]
4. Copy configuration file `config.yml.sample` and rename to `.pglistend.yml` in root directory. Update database credentials, channels and location of scripts.
5. To prepare a script, copy `listener.js.sample` and save it as `listener.js`, or anything you wish, to any location(recommended to save outside project directory). Update the preferred channels and instructions in the script. Also, update the location of script in `.pglistend.yml`.
6. From terminal in root directory, run: `npm start`. You can see the logs in terminal as the channels hit the queries when the `notify` operation is called on.
## TODOs
* Delegate CPU-intensive tasks (mostly queries) to separate thread or message queue most likely. [Here's why](http://stackoverflow.com/questions/3491811/node-js-and-cpu-intensive-requests/3536183#answer-3491931)