{"id":23185762,"url":"https://github.com/ruslan-korneev/pgconnect-zsh","last_synced_at":"2025-04-05T04:44:13.539Z","repository":{"id":268348621,"uuid":"904061414","full_name":"ruslan-korneev/pgconnect-zsh","owner":"ruslan-korneev","description":"This plugin enhances your Oh My Zsh setup by providing an easy way to manage and connect to PostgreSQL databases using pgcli and fzf for a seamless command-line experience.","archived":false,"fork":false,"pushed_at":"2024-12-17T08:43:01.000Z","size":3006,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-01T21:13:33.790Z","etag":null,"topics":["fzf","oh-my-zsh","oh-my-zsh-plugin","pgcli","postgresql","zsh"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ruslan-korneev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-16T07:19:37.000Z","updated_at":"2025-02-26T00:09:20.000Z","dependencies_parsed_at":"2024-12-16T08:26:43.041Z","dependency_job_id":"e1117695-ce65-47d4-ba53-00957be9010b","html_url":"https://github.com/ruslan-korneev/pgconnect-zsh","commit_stats":null,"previous_names":["ruslan-korneev/pgconnect-zsh"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslan-korneev%2Fpgconnect-zsh","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslan-korneev%2Fpgconnect-zsh/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslan-korneev%2Fpgconnect-zsh/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ruslan-korneev%2Fpgconnect-zsh/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ruslan-korneev","download_url":"https://codeload.github.com/ruslan-korneev/pgconnect-zsh/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247289398,"owners_count":20914464,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fzf","oh-my-zsh","oh-my-zsh-plugin","pgcli","postgresql","zsh"],"created_at":"2024-12-18T10:12:41.474Z","updated_at":"2025-04-05T04:44:13.511Z","avatar_url":"https://github.com/ruslan-korneev.png","language":"Shell","funding_links":[],"categories":["Plugins"],"sub_categories":["ZSH on Windows"],"readme":"# PostgreSQL Connection Plugin for Oh My Zsh\n\nThis plugin enhances your Oh My Zsh setup by providing an easy way to manage and connect to PostgreSQL databases using `pgcli` and `fzf` for a seamless command-line experience.\n\n## Requirements\n\nEnsure you have the following tools installed before using this plugin:\n\n-  [fzf](https://github.com/junegunn/fzf): A command-line fuzzy finder.\n-  [pgcli](https://github.com/dbcli/pgcli): A Postgres client with auto-completion and syntax highlighting.\n\n## Installation\n\nTo install the PostgreSQL Connection Plugin, follow these steps:\n\n1. Clone the repository into your custom Oh My Zsh plugins directory:\n\n   ```zsh\n   git clone git@github.com:ruslan-korneev/pgconnect-zsh.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/pgconnect\n   ```\n\n2. Add `pgconnect` to the list of plugins in your `.zshrc` file:\n\n   ```zsh\n   plugins=(... pgconnect)\n   ```\n\n3. Reload your Zsh configuration:\n\n   ```zsh\n   source ~/.zshrc\n   ```\n\n## Usage\n\nTo manage your PostgreSQL connections, configure your `~/.pg_service.conf` file. This file allows you to define multiple database connections. Here is an example configuration:\n\n```ini\n[db1]\nhost=0.0.0.0\nport=5862\nuser=username\ndbname=postgres\n\n[db2]\nhost=0.0.0.0\nport=5432\nuser=postgres\ndbname=mysuperdatabase\n```\n\nAfter setting up your `~/.pg_service.conf`, you will be able to see and select these databases from a list using the plugin.\n\n![Example Usage](media/example.gif)\n\n### Security Note\n\nTo keep your passwords secure, you can use the `.pgpass` file, which stores your credentials safely. If you prefer, you can also include the password directly in the `~/.pg_service.conf` file using the `password` attribute, though this is not recommended for security reasons.\n\nFor more detailed information on configuring these files, refer to the [PostgreSQL documentation on connection service files](https://www.postgresql.org/docs/current/libpq-pgservice.html) and [password file](https://www.postgresql.org/docs/current/libpq-pgpass.html).\n\n---\n\nFeel free to contribute to this project by submitting issues or pull requests. Enjoy seamless PostgreSQL connections with Oh My Zsh!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruslan-korneev%2Fpgconnect-zsh","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fruslan-korneev%2Fpgconnect-zsh","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fruslan-korneev%2Fpgconnect-zsh/lists"}