The document discusses the process of releasing extensions on the PostgreSQL Extension Network (PGXN), particularly focusing on an example extension called 'pair', which is a key/value pair data type. It details the steps for packaging and distributing the extension, including metadata requirements and documentation. Additionally, it emphasizes the need for a structured file layout and versioning in accordance with best practices for open-source projects.

1. Releasing Extensions
on PGXN
David E. Wheeler
PostgreSQL Experts, Inc.
PDXPUG
April 21, 2019
Text: Attribution-Noncommercial-Share Alike 3.0 United States:
http://creativecommons.org/licenses/by-nc-sa/3.0/us/
Images licensed independently and © Their respective owners.

2. Problem Solved

3. Problem Solved
Solved a database problem

4. Problem Solved
Solved a database problem
Want to share

5. Problem Solved
Solved a database problem
Want to share
Open source it

6. Problem Solved
Solved a database problem
Want to share
Open source it
Where to distribute

7. PGXN

8. PGXN
“The PostgreSQL Extension
network, is a central
distribution system for
open-source PostgreSQL
extension libraries.”

10. wheeler

11. wheeler

20. Your Solution

21. Your Solution
You’ve solved a problem

22. Your Solution
You’ve solved a problem
Using database objects

23. Your Solution
You’ve solved a problem
Using database objects
Packaged like contrib

24. Your Solution
You’ve solved a problem
Using database objects
Packaged like contrib
Want to open-source it

25. Your Solution
You’ve solved a problem
Using database objects
Packaged like contrib
Want to open-source it
How to distribute on PGXN?

26. Your Solution
You’ve solved a problem
Using database objects
Packaged like contrib
Want to open-source it
How to distribute on PGXN?
Just one thing:

27. Your Solution
You’ve solved a problem
Using database objects
Packaged like contrib
Want to open-source it
How to distribute on PGXN?
Just one thing:
META.json

28. META.json
META.json

29. META.json
{
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1.0",
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

30. META.json
{
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1.0",
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

31. META.json
{
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1.0",
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

32. META.json
{
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1.0",
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

33. META.json
{ semver.org
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1.0",
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

34. META.json
{
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1.0",
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

35. META.json
{
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1.0",
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

36. META.json
{
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1.0",
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
At least this…
META.json

37. Package it Up!
%

38. Package it Up!
%
git archive ‐‐format zip ‐‐prefix=pair‐0.1.0/
‐‐output ~/Desktop/pair‐0.1.0.zip master
%

39. Package it Up!
%
git archive ‐‐format zip ‐‐prefix=pair‐0.1.0/
‐‐output ~/Desktop/pair‐0.1.0.zip master
%
Easy, eh?

43. Tom Lane
tgl@postgresql.org
http://postgresql.org/~tgl/
tomlane
@tomlane
I’ve got some killer extensions in development that I think
will be useful to everyone, including:
* pair: an ordered pair data type
* PL/Brainfuck: just what it sounds like

44. Tom Lane
tgl@postgresql.org
http://postgresql.org/~tgl/
tomlane
@tomlane
I’ve got some killer extensions in development that I think
will be useful to everyone, including:
* pair: an ordered pair data type
* PL/Brainfuck: just what it sounds like

45. tomlane

49. omg WTF ROTFL lolz
omg WTF ROTFL lolz

50. omg WTF ROTFL lolz
omg WTF ROTFL lolz

53. tomlane
●●●●●●●●●●●●●●●●●●

61. tomlane

64. No resources,
tags, or long
description

65. No documentation link

66. Plain text
README

67. Add README Extension
%

68. Add README Extension
%
git mv README.pair README.md
%

69. Add README Extension
%
git mv README.pair README.md
%
Easy, eh?

70. PGXN Markup

71. PGXN Markup
HTML Textile
Markdown Trac
MultiMarkdown MediaWiki
Pod

72. PGXN Markup
HTML Textile
Markdown Trac
MultiMarkdown MediaWiki
Pod
Text::Markup (fork me!)

73. PGXN Markup
HTML Textile
Markdown Trac
MultiMarkdown MediaWiki
Pod
Text::Markup (fork me!)
Write some Docs!

74. Add Documentation

75. Add Documentation
Use any supported markup

76. Add Documentation
Use any supported markup
Put wherever you like

77. Add Documentation
Use any supported markup
Put wherever you like
Recommend the doc/

78. doc/pair.md

79. pair 0.1.1
==========
Synopsis
‐‐‐‐‐‐‐‐
% CREATE EXTENSION pair;
CREATE EXTENSION
% SELECT 'foo' ~> 'bar';
pair
‐‐‐‐‐‐‐‐‐‐‐‐
(foo,bar)
Description
‐‐‐‐‐‐‐‐‐‐‐
This library contains a single PostgreSQL extension, a
key/value pair data type called “pair”, along with a
convenience function for constructing key/value pairs.
It's just a simple thing, really: a two‐value composite
type that can store any type of value in its slots,
which are named `k` and `v`.
doc/pair.md

80. pair 0.1.1
==========
Synopsis
‐‐‐‐‐‐‐‐
Must be UTF-8
or use a
% CREATE EXTENSION pair;
CREATE EXTENSION
BOM
% SELECT 'foo' ~> 'bar';
pair
‐‐‐‐‐‐‐‐‐‐‐‐
(foo,bar)
Description
‐‐‐‐‐‐‐‐‐‐‐
This library contains a single PostgreSQL extension, a
key/value pair data type called “pair”, along with a
convenience function for constructing key/value pairs.
It's just a simple thing, really: a two‐value composite
type that can store any type of value in its slots,
which are named `k` and `v`.
doc/pair.md

81. Add Description
{
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1.0",
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

82. Add Description
{
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1.0",
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"description": "This library contains a key/value
pair data type called “pair”, along with an operator for
constructing key/value pairs.",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

83. Add Tags
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

84. Add Tags
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
,
}
"tags": [
"ordered pair",
"pair",
"key value"
]
}
META.json

85. Add Resources
"tags": [
"ordered pair",
"pair",
"key value"
]
}
META.json

86. Add Resources
"tags": [
"ordered pair",
"pair",
"key value"
,
]
"resources": {
"bugtracker": {
"web": "https://github.com/tgl/kv‐pair/issues/"
},
"repository": {
"type": "git",
"url": "git://github.com/tgl/kv‐pair.git",
"web": "https://github.com/tgl/kv‐pair/"
}
}
}
META.json

87. What Extensions

88. What Extensions
Might have multiple extensions

89. What Extensions
Might have multiple extensions
Extension might have own version

90. What Extensions
Might have multiple extensions
Extension might have own version
Might have documentation file

91. What Extensions
Might have multiple extensions
Extension might have own version
Might have documentation file
Help PGXN out!

92. What Extensions
Might have multiple extensions
Extension might have own version
Might have documentation file
Help PGXN out!
Add “provides” to META.json

93. Add Provides
"repository": {
"type": "git",
"url": "git://github.com/tgl/kv‐pair.git",
"web": "https://github.com/tgl/kv‐pair/"
}
}
}
META.json

94. Add Provides
"repository": {
"type": "git",
"url": "git://github.com/tgl/kv‐pair.git",
"web": "https://github.com/tgl/kv‐pair/"
}
,
}
"provides": {
"pair": {
"file": "sql/pair.sql",
"version": "0.1.0",
"abstract": "A key/value pair data type",
"docfile": "doc/pair.md"
}
}
}
META.json

95. Add Provides
"repository": {
"type": "git",
"url": "git://github.com/tgl/kv‐pair.git",
"web": "https://github.com/tgl/kv‐pair/"
}
,
}
"provides": {
"pair": {
"file": "sql/pair.sql", It’s unchanged!
"version": "0.1.0",
"abstract": "A key/value pair data type",
"docfile": "doc/pair.md"
}
}
}
META.json

96. Update Version
{
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1. ",
0
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"description": "This library contains a key/value
pair data type called “pair”, along with an operator for
constructing key/value pairs.",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

97. Update Version
{
"name": "pair",
"abstract": "A key/value pair data type",
"version": "0.1. ",
1
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"description": "This library contains a key/value
pair data type called “pair”, along with an operator for
constructing key/value pairs.",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

98. Update Version
{
"name": "pair",
Must be
"abstract": "A key/value pair data type",
"version": "0.1. ",
1
unique.
"maintainer": "Tom Lane <tgl@postgresql.org>",
"license": "postgresql",
"description": "This library contains a key/value
pair data type called “pair”, along with an operator for
constructing key/value pairs.",
"meta‐spec": {
"version": "1.0.0",
"url": "http://pgxn.org/meta/spec.txt"
}
}
META.json

99. Package it up
%

100. Package it up
%
git archive ‐‐format zip ‐‐prefix=pair‐0.1.1/
‐‐output ~/Desktop/pair‐0.1.1.zip master
%

101. Release it

104. Lots of great
metadata!

105. Link to
documentation!

106. README in
HTML!

107. README in
HTML!

109. Niiiice.

110. What Else?

111. What Else?
Recommended file layout

112. What Else?
Recommended file layout
Standard Makefile format

113. What Else?
Recommended file layout
Standard Makefile format
9.1 CREATE EXTENSION support

114. What Else?
Recommended file layout
Standard Makefile format
9.1 CREATE EXTENSION support
With compatibility!

115. File Recommendations

116. File Recommendations
SQL source in sql/

117. File Recommendations
SQL source in sql/
C source in src/

118. File Recommendations
SQL source in sql/
C source in src/
Tests in test/

119. File Recommendations
SQL source in sql/
C source in src/
Tests in test/
Documentation in docs/

120. Rearrange
%

121. Rearrange
%
% mkdir test

122. Rearrange
%
% mkdir test
% git mv sql test/

123. Rearrange
%
% mkdir test
% git mv sql test/
% git mv expected test/

124. Rearrange
%
% mkdir test
% git mv sql test/
% git mv expected test/
% mkdir sql

125. Rearrange
%
% mkdir test
% git mv sql test/
% git mv expected test/
% mkdir sql
% git mv *.sql sql/

126. Makefile
Makefile

127. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
Makefile

128. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
Makefile

129. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
Makefile

130. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
Makefile

131. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
Makefile

132. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
Makefile

133. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
Makefile

134. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
Makefile

135. Makefile
inputdir
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
Makefile

136. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
PG_CONFIG = pg_config
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

137. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
PG_CONFIG = pg_config
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

138. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
PG_CONFIG = pg_config
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

139. Makefile
DATA = $(wildcard sql/*.sql)
DOCS = $(wildcard doc/*.txt)
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
PG_CONFIG = pg_config
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

140. CREATE EXTENSION

141. CREATE EXTENSION
New in 9.1

142. CREATE EXTENSION
New in 9.1
Add extension to a DB with

143. CREATE EXTENSION
New in 9.1
Add extension to a DB with
CREATE EXTENSION pair;

144. CREATE EXTENSION
New in 9.1
Add extension to a DB with
CREATE EXTENSION pair;
No need to run SQL script in psql

145. Packaging Extensions
Needs

146. Packaging Extensions
Needs
Control file

147. Packaging Extensions
Needs
Control file
Migration from unpackaged

148. Packaging Extensions
Needs
Control file
Migration from unpackaged
pair--unpackaged--0.1.0.sql

149. Packaging Extensions
Needs
Control file
Migration from unpackaged
pair--unpackaged--0.1.0.sql
Properly-named SQL script

150. Packaging Extensions
Needs
Control file
Migration from unpackaged
pair--unpackaged--0.1.0.sql
Properly-named SQL script
pair--0.1.0.sql

151. Create the control file
pair.control

152. Create the control file
# pair extension
comment = 'A key/value pair data type'
default_version = '0.1.0'
module_pathname = '$libdir/pair'
relocatable = true
superuser = false
pair.control

153. Create the control file
# pair extension
comment = 'A key/value pair data type'
default_version = '0.1.0'
module_pathname = '$libdir/pair'
relocatable = true
superuser = false
pair.control

154. Create the control file
Optional
# pair extension
comment = 'A key/value pair data type'
default_version = '0.1.0'
module_pathname = '$libdir/pair'
relocatable = true
superuser = false
pair.control

155. Create the control file
# pair extension
comment = 'A key/value pair data type'
default_version = '0.1.0'
module_pathname = '$libdir/pair'
relocatable = true
superuser = false
pair.control

156. Create the control file
# pair extension
comment = 'A key/value pair data type'
default_version = '0.1.0'
module_pathname = '$libdir/pair'
relocatable = true
superuser = false
pair.control

157. Create the control file
# pair extension
For C
comment = 'A key/value pair data type'
default_version = '0.1.0' code
module_pathname = '$libdir/pair'
relocatable = true
superuser = false
pair.control

158. Create the control file
# pair extension
comment = 'A key/value pair data type'
default_version = '0.1.0'
module_pathname = '$libdir/pair'
relocatable = true
superuser = false
pair.control

159. Create the control file
# pair extension Can move
comment = 'A key/value pair data type'
schemas
default_version = '0.1.0'
module_pathname = '$libdir/pair'
relocatable = true
superuser = false
pair.control

160. Create the control file
# pair extension
comment = 'A key/value pair data type'
default_version = '0.1.0'
module_pathname = '$libdir/pair'
relocatable = true
superuser = false
pair.control

161. Create the control file
# pair extension
comment = 'A key/value pair data type'
default_version = '0.1.0'
module_pathname = '$libdir/pair'
relocatable = true Not required
superuser = false
to install
pair.control

162. Create the control file
# pair extension
comment = 'A key/value pair data type'
default_version = '0.1.0'
module_pathname = '$libdir/pair'
relocatable = true
superuser = false
pair.control
pair.control

163. Migration from
Unpackaged
sql/pair‐‐unpac…

164. Migration from
Unpackaged
ALTER EXTENSION pair ADD TYPE pair;
ALTER EXTENSION pair ADD FUNCTION pair(anyelement, text);
ALTER EXTENSION pair ADD FUNCTION pair(text, anyelement);
ALTER EXTENSION pair ADD FUNCTION pair(anyelement, anyelement);
ALTER EXTENSION pair ADD FUNCTION pair(text, text);
ALTER EXTENSION pair ADD OPERATOR ~>(text, anyelement);
ALTER EXTENSION pair ADD OPERATOR ~>(anyelement, text);
ALTER EXTENSION pair ADD OPERATOR ~>(anyelement, anyelement);
ALTER EXTENSION pair ADD OPERATOR ~>(text, text);
sql/pair--unpackaged--0.1.0.sql
sql/pair‐‐unpac…

165. Update the Makefile
Makefile

166. Update the Makefile
EXTENSION = semver
EXTVERSION = $(shell grep default_version
$(EXTENSION).control | sed ‐e
"s/default_version[ ]*=[ ]*'([^']*)'/1/")
DATA = $(filter‐out $(wildcard sql/*‐‐*.sql),$
(wildcard sql/*.sql))
DOCS = $(wildcard doc/*.txt)
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
PG_CONFIG = pg_config
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
Makefile

167. Update the Makefile
EXTENSION = semver
EXTVERSION = $(shell grep default_version
$(EXTENSION).control | sed ‐e
"s/default_version[ ]*=[ ]*'([^']*)'/1/")
DATA = $(filter‐out $(wildcard sql/*‐‐*.sql),$
(wildcard sql/*.sql))
DOCS = $(wildcard doc/*.txt)
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
PG_CONFIG = pg_config
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
Makefile

168. Update the Makefile
EXTENSION = semver
EXTVERSION = $(shell grep default_version
$(EXTENSION).control | sed ‐e
"s/default_version[ ]*=[ ]*'([^']*)'/1/")
DATA = $(filter‐out $(wildcard sql/*‐‐*.sql),$
(wildcard sql/*.sql))
DOCS = $(wildcard doc/*.txt)
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
PG_CONFIG = pg_config
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
Makefile

169. Update the Makefile
Extract from
EXTENSION = semver
EXTVERSION = $(shell grep default_version control file
$(EXTENSION).control | sed ‐e
"s/default_version[ ]*=[ ]*'([^']*)'/1/")
DATA = $(filter‐out $(wildcard sql/*‐‐*.sql),$
(wildcard sql/*.sql))
DOCS = $(wildcard doc/*.txt)
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
PG_CONFIG = pg_config
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
Makefile

170. Update the Makefile
EXTENSION = semver
EXTVERSION = $(shell grep default_version
$(EXTENSION).control | sed ‐e
"s/default_version[ ]*=[ ]*'([^']*)'/1/")
DATA = $(filter‐out $(wildcard sql/*‐‐*.sql),$
(wildcard sql/*.sql))
DOCS = $(wildcard doc/*.txt)
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
PG_CONFIG = pg_config
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
Makefile

171. Update the Makefile
EXTENSION = semver
EXTVERSION = $(shell grep default_version
$(EXTENSION).control | sed ‐e
"s/default_version[ ]*=[ ]*'([^']*)'/1/")
DATA = $(filter‐out $(wildcard sql/*‐‐*.sql),$
(wildcard sql/*.sql))
DOCS = $(wildcard doc/*.txt)
TESTS = $(wildcard test/sql/*.sql)
REGRESS = $(patsubst test/sql/%.sql,%,$(TESTS))
REGRESS_OPTS = ‐‐inputdir=test
MODULES = $(patsubst %.c,%,$(wildcard src/*.c))
PG_CONFIG = pg_config
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
Makefile

172. Update the Makefile
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
Makefile

173. Update the Makefile
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
ifeq ($(PG91),yes)
all: sql/$(EXTENSION)‐‐$(EXTVERSION).sql
sql/$(EXTENSION)‐‐$(EXTVERSION).sql: sql/$(EXTENSION).sql
cp $< $@
DATA = $(wildcard sql/*‐‐*.sql) sql/$(EXTENSION)‐‐$
(EXTVERSION).sql
EXTRA_CLEAN = sql/$(EXTENSION)‐‐$(EXTVERSION).sql
endif
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

174. Update the Makefile
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
ifeq ($(PG91),yes)
all: sql/$(EXTENSION)‐‐$(EXTVERSION).sql
sql/$(EXTENSION)‐‐$(EXTVERSION).sql: sql/$(EXTENSION).sql
cp $< $@
DATA = $(wildcard sql/*‐‐*.sql) sql/$(EXTENSION)‐‐$
(EXTVERSION).sql
EXTRA_CLEAN = sql/$(EXTENSION)‐‐$(EXTVERSION).sql
endif
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

175. Update the Makefile
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
ifeq ($(PG91),yes)
all: sql/$(EXTENSION)‐‐$(EXTVERSION).sql
sql/$(EXTENSION)‐‐$(EXTVERSION).sql: sql/$(EXTENSION).sql
cp $< $@
DATA = $(wildcard sql/*‐‐*.sql) sql/$(EXTENSION)‐‐$
(EXTVERSION).sql
EXTRA_CLEAN = sql/$(EXTENSION)‐‐$(EXTVERSION).sql
endif
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

176. Update the Makefile
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
ifeq ($(PG91),yes)
all: sql/$(EXTENSION)‐‐$(EXTVERSION).sql
sql/$(EXTENSION)‐‐$(EXTVERSION).sql: sql/$(EXTENSION).sql
cp $< $@
DATA = $(wildcard sql/*‐‐*.sql) sql/$(EXTENSION)‐‐$
(EXTVERSION).sql
EXTRA_CLEAN = sql/$(EXTENSION)‐‐$(EXTVERSION).sql
endif
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

177. Update the Makefile
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
ifeq ($(PG91),yes)
all: sql/$(EXTENSION)‐‐$(EXTVERSION).sql
sql/$(EXTENSION)‐‐$(EXTVERSION).sql: sql/$(EXTENSION).sql
cp $< $@
DATA = $(wildcard sql/*‐‐*.sql) sql/$(EXTENSION)‐‐$
(EXTVERSION).sql
EXTRA_CLEAN = sql/$(EXTENSION)‐‐$(EXTVERSION).sql
endif
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

178. Update the Makefile
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
ifeq ($(PG91),yes)
all: sql/$(EXTENSION)‐‐$(EXTVERSION).sql
sql/$(EXTENSION)‐‐$(EXTVERSION).sql: sql/$(EXTENSION).sql
cp $< $@
DATA = $(wildcard sql/*‐‐*.sql) sql/$(EXTENSION)‐‐$
(EXTVERSION).sql
EXTRA_CLEAN = sql/$(EXTENSION)‐‐$(EXTVERSION).sql
endif
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

179. Update the Makefile
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
ifeq ($(PG91),yes)
all: sql/$(EXTENSION)‐‐$(EXTVERSION).sql
sql/$(EXTENSION)‐‐$(EXTVERSION).sql: sql/$(EXTENSION).sql
cp $< $@
DATA = $(wildcard sql/*‐‐*.sql) sql/$(EXTENSION)‐‐$
(EXTVERSION).sql
EXTRA_CLEAN = sql/$(EXTENSION)‐‐$(EXTVERSION).sql
endif
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

180. Update the Makefile
PG91 = $(shell $(PG_CONFIG) ‐‐version
| grep ‐qE " 8.| 9.0" && echo no || echo yes)
ifeq ($(PG91),yes)
all: sql/$(EXTENSION)‐‐$(EXTVERSION).sql
sql/$(EXTENSION)‐‐$(EXTVERSION).sql: sql/$(EXTENSION).sql
cp $< $@
DATA = $(wildcard sql/*‐‐*.sql) sql/$(EXTENSION)‐‐$
(EXTVERSION).sql
EXTRA_CLEAN = sql/$(EXTENSION)‐‐$(EXTVERSION).sql
endif
PGXS := $(shell $(PG_CONFIG) ‐‐pgxs)
include $(PGXS)
Makefile

181. Or Forget It

182. Or Forget It
Copy Makefile

183. Or Forget It
Copy Makefile
Edit first line

184. Or Forget It
Copy Makefile
Edit first line
EXTENSION=pair

185. Or Forget It
Copy Makefile
Edit first line
EXTENSION=pair
Ignore the rest

187. % curl ‐O http://api.pgxn.org/dist/pair/0.1.2/pair‐0.1.2.pgz
% unzip pair‐0.1.2.pgz
Archive: pair‐0.1.2.pgz
% cd pair‐0.1.2
%

188. % curl ‐O http://api.pgxn.org/dist/pair/0.1.2/pair‐0.1.2.pgz
% unzip pair‐0.1.2.pgz
Archive: pair‐0.1.2.pgz
% cd pair‐0.1.2
% make
cp sql/pair.sql sql/pair‐‐0.1.2.sql
cp sql/pair‐‐unpackaged.sql sql/pair‐‐unpackaged‐‐0.1.2.sql
% sudo make install
# …elided
%

189. % curl ‐O http://api.pgxn.org/dist/pair/0.1.2/pair‐0.1.2.pgz
% unzip pair‐0.1.2.pgz
Archive: pair‐0.1.2.pgz
% cd pair‐0.1.2
% make
cp sql/pair.sql sql/pair‐‐0.1.2.sql
cp sql/pair‐‐unpackaged.sql sql/pair‐‐unpackaged‐‐0.1.2.sql
% sudo make install
# …elided
% psql try
psql (9.1devel)
Type "help" for help.
try=# create extension pair;
CREATE EXTENSION
try=#

190. % curl ‐O http://api.pgxn.org/dist/pair/0.1.2/pair‐0.1.2.pgz
% unzip pair‐0.1.2.pgz
Archive: pair‐0.1.2.pgz
% cd pair‐0.1.2
% make
cp sql/pair.sql sql/pair‐‐0.1.2.sql
cp sql/pair‐‐unpackaged.sql sql/pair‐‐unpackaged‐‐0.1.2.sql
% sudo make install
# …elided
% psql try
psql (9.1devel)
Type "help" for help.
try=# create extension pair;
CREATE EXTENSION
dT
try=#
List of data types
Schema | Name | Description
‐‐‐‐‐‐‐‐+‐‐‐‐‐‐+‐‐‐‐‐‐‐‐‐‐‐‐‐
public | pair |
(1 row)
try=#

191. % curl ‐O http://api.pgxn.org/dist/pair/0.1.2/pair‐0.1.2.pgz
% unzip pair‐0.1.2.pgz
Archive: pair‐0.1.2.pgz
% cd pair‐0.1.2
% make
cp sql/pair.sql sql/pair‐‐0.1.2.sql
cp sql/pair‐‐unpackaged.sql sql/pair‐‐unpackaged‐‐0.1.2.sql
% sudo make install
# …elided
% psql try
psql (9.1devel)
Type "help" for help.
try=# create extension pair;
CREATE EXTENSION
dT
try=#
List of data types
Schema | Name | Description
‐‐‐‐‐‐‐‐+‐‐‐‐‐‐+‐‐‐‐‐‐‐‐‐‐‐‐‐
public | pair |
(1 row)
try=#
Wow!

192. Thank you.
Releasing Extensions
on PGXN
David E. Wheeler
PostgreSQL Experts, Inc.
Text: Attribution-Noncommercial-Share Alike 3.0 United States:
http://creativecommons.org/licenses/by-nc-sa/3.0/us/
Images licensed independently and © Their respective owners.