Metadata-Version: 2.3
Name: postgresql-binaries
Version: 18.4.0
Summary: PostgreSQL binaries for Linux, MacOS and Windows
Author: Oli Russell
Author-email: Oli Russell <mrxoliver@gmail.com>
License: Copyright (c) 2024, leontrolski
         
         Permission to use, copy, modify, and distribute this software and its documentation for any purpose, without fee, and without a written agreement is hereby granted, provided that the above copyright notice and this paragraph and the following two paragraphs appear in all copies.
         
         IN NO EVENT SHALL leontrolski BE LIABLE TO ANY PARTY FOR DIRECT, INDIRECT, SPECIAL, INCIDENTAL, OR CONSEQUENTIAL DAMAGES, INCLUDING LOST PROFITS, ARISING OUT OF THE USE OF THIS SOFTWARE AND ITS DOCUMENTATION, EVEN IF leontrolski HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
         
         leontrolski SPECIFICALLY DISCLAIMS ANY WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE SOFTWARE PROVIDED HEREUNDER IS ON AN “AS IS” BASIS, AND leontrolski HAS NO OBLIGATIONS TO PROVIDE MAINTENANCE, SUPPORT, UPDATES, ENHANCEMENTS, OR MODIFICATIONS.
Requires-Python: >=3.12
Project-URL: repository, https://github.com/leontrolski/postgresql-binaries
Description-Content-Type: text/markdown

# Postgresql Binaries

Uses releases from [theseus-rs/postgresql-binaries](https://github.com/theseus-rs/postgresql-binaries) and publishes them to pypy, so that you can do:

```shell
pip install postgresql-binaries==18.3.0
```

Then to use, eg:

```python
import postgresql_binaries
import subprocess

cmd = [
    str(postgresql_binaries.bin() / "initdb"),
    *("-D", directory),
    *("-U", "postgres"),
    *("--auth-host", "trust"),
]
subprocess.check_call(cmd)
```

Packages are around 10MB. On the first call to `bin()`, the archive baked into the wheel is unpacked in place.

<hr>

This library is intentionally really dumb, and intended to be built upon. There are [mixed opinions](https://discuss.python.org/t/use-of-pypi-as-a-generic-storage-platform-for-binaries/106044/58?page=3) on whether (ab)using PyPI to host binary files is a good idea. There are [similar](https://github.com/Ladybug-Memory/pgembed) packages around, but they don't handle versioning well and include too much other junk.
