1===================================================================== 2 PGXN Client 3===================================================================== 4A command line tool to interact with the PostgreSQL Extension Network 5===================================================================== 6 7The `PGXN Client <https://pgxn.github.io/pgxnclient/>`__ is a command 8line tool designed to interact with the `PostgreSQL Extension Network 9<https://pgxn.org/>`__ allowing searching, compiling, installing, and removing 10extensions in PostgreSQL databases. 11 12For example, to install the semver_ extension, the client can be invoked as:: 13 14 $ pgxn install semver 15 16which would download and compile the extension for one of the PostgreSQL 17servers hosted on the machine and:: 18 19 $ pgxn load -d somedb semver 20 21which would load the extension in one of the databases of the server. 22 23The client interacts with the PGXN web service and a ``Makefile`` provided by 24the extension. The best results are achieved with makefiles using the 25PostgreSQL `Extension Building Infrastructure`__; however the client tries to 26degrade gracefully in presence of any package hosted on PGXN. 27 28.. _semver: https://pgxn.org/dist/semver 29.. __: https://www.postgresql.org/docs/current/extend-pgxs.html 30 31- Documentation: https://pgxn.github.io/pgxnclient/ 32- Source repository: https://github.com/pgxn/pgxnclient 33- Downloads: https://pypi.python.org/pypi/pgxnclient/ 34- Discussion group: https://groups.google.com/group/pgxn-users/ 35 36Please refer to the files in the ``docs`` directory or online__ for 37instructions about the program installation and usage. 38 39 40Development 41----------- 42 43You can create a local development environment with:: 44 45 virtualenv .venv 46 source .venv/bin/activate 47 pip install -e .[dev] 48 49and run `pytest` to run the test suite. 50 51.. __: https://pgxn.github.io/pgxnclient/ 52