https://github.com/decibel/trunklet

Templating for Postgres. Elephants don't use templates, they use trunklets!
https://github.com/decibel/trunklet

Last synced: 25 days ago
JSON representation

Templating for Postgres. Elephants don't use templates, they use trunklets!

• Host: GitHub
• URL: https://github.com/decibel/trunklet
• Owner: decibel
• Created: 2015-01-11T23:42:16.000Z (about 10 years ago)
• Default Branch: master
• Last Pushed: 2017-06-18T01:36:21.000Z (over 7 years ago)
• Last Synced: 2024-11-28T16:55:16.205Z (3 months ago)
• Language: PLpgSQL
• Size: 200 KB
• Stars: 4
• Watchers: 4
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: HISTORY.asc

Awesome Lists containing this project

• jimsghstars - decibel/trunklet - Templating for Postgres. Elephants don't use templates, they use trunklets! (PLpgSQL)

README

        
trunklet

========

A long description

To build it, just do this:

    make

    make installcheck

    make install

If you encounter an error such as:

    "Makefile", line 8: Need an operator

You need to use GNU make, which may well be installed on your system as

`gmake`:

    gmake

    gmake install

    gmake installcheck

If you encounter an error such as:

    make: pg_config: Command not found

Be sure that you have `pg_config` installed and in your path. If you used a

package management system such as RPM to install PostgreSQL, be sure that the

`-devel` package is also installed. If necessary tell the build process where

to find it:

    env PG_CONFIG=/path/to/pg_config make && make installcheck && make install

And finally, if all that fails (and if you're on PostgreSQL 8.1 or lower, it

likely will), copy the entire distribution directory to the `contrib/`

subdirectory of the PostgreSQL source tree and try it there without

`pg_config`:

    env NO_PGXS=1 make && make installcheck && make install

If you encounter an error such as:

    ERROR:  must be owner of database regression

You need to run the test suite using a super user, such as the default

"postgres" super user:

    make installcheck PGUSER=postgres

Once trunklet is installed, you can add it to a database. If you're running

PostgreSQL 9.1.0 or greater, it's a simple as connecting to a database as a

super user and running:

    CREATE EXTENSION trunklet;

If you've upgraded your cluster to PostgreSQL 9.1 and already had trunklet

installed, you can upgrade it to a properly packaged extension with:

    CREATE EXTENSION trunklet FROM unpackaged;

For versions of PostgreSQL less than 9.1.0, you'll need to run the

installation script:

    psql -d mydb -f /path/to/pgsql/share/contrib/trunklet.sql

If you want to install trunklet and all of its supporting objects into a specific

schema, use the `PGOPTIONS` environment variable to specify the schema, like

so:

    PGOPTIONS=--search_path=extensions psql -d mydb -f trunklet.sql

Dependencies

------------

The `trunklet` data type has no dependencies other than PostgreSQL.

Copyright and License

---------------------

Copyright (c) 2015 Jim C. Nasby.