pg 0.12.2 → 0.13.0.pre298

Sign up to get free protection for your applications and to get access to all the features.
Files changed (49) hide show
  1. data.tar.gz.sig +0 -0
  2. data/.hoerc +2 -0
  3. data/.tm_properties +12 -0
  4. data/ChangeLog +86 -6
  5. data/Contributors.rdoc +7 -0
  6. data/History.rdoc +29 -0
  7. data/LICENSE +12 -14
  8. data/Manifest.txt +15 -14
  9. data/{BSD → POSTGRES} +0 -0
  10. data/{README.OS_X.rdoc → README-OS_X.rdoc} +0 -0
  11. data/{README.windows.rdoc → README-Windows.rdoc} +0 -0
  12. data/README.ja.rdoc +1 -1
  13. data/README.rdoc +39 -27
  14. data/Rakefile +1 -2
  15. data/ext/extconf.rb +9 -2
  16. data/ext/pg.c +232 -4297
  17. data/ext/pg.h +87 -23
  18. data/ext/pg_connection.c +3301 -0
  19. data/ext/pg_result.c +905 -0
  20. data/lib/pg.rb +26 -43
  21. data/lib/pg/connection.rb +58 -0
  22. data/lib/pg/constants.rb +11 -0
  23. data/lib/pg/exceptions.rb +11 -0
  24. data/lib/pg/result.rb +11 -0
  25. data/misc/openssl-pg-segfault.rb +1 -1
  26. data/sample/async_api.rb +16 -21
  27. data/sample/async_copyto.rb +1 -1
  28. data/sample/async_mixed.rb +56 -0
  29. data/sample/copyfrom.rb +1 -1
  30. data/sample/copyto.rb +1 -1
  31. data/sample/cursor.rb +1 -1
  32. data/sample/losample.rb +6 -6
  33. data/sample/notify_wait.rb +51 -22
  34. data/sample/test_binary_values.rb +4 -6
  35. data/spec/lib/helpers.rb +14 -10
  36. data/spec/{pgconn_spec.rb → pg/connection_spec.rb} +227 -60
  37. data/spec/{pgresult_spec.rb → pg/result_spec.rb} +31 -35
  38. data/spec/pg_spec.rb +22 -0
  39. metadata +44 -42
  40. metadata.gz.sig +0 -0
  41. data/GPL +0 -340
  42. data/ext/compat.c +0 -541
  43. data/ext/compat.h +0 -184
  44. data/sample/psql.rb +0 -1181
  45. data/sample/psqlHelp.rb +0 -158
  46. data/sample/test1.rb +0 -60
  47. data/sample/test2.rb +0 -44
  48. data/sample/test4.rb +0 -71
  49. data/spec/m17n_spec.rb +0 -170
@@ -3,26 +3,22 @@
3
3
 
4
4
  BEGIN {
5
5
  require 'pathname'
6
- require 'rbconfig'
7
6
 
8
- basedir = Pathname( __FILE__ ).dirname.parent
7
+ basedir = Pathname( __FILE__ ).dirname.parent.parent
9
8
  libdir = basedir + 'lib'
10
- archlib = libdir + Config::CONFIG['sitearch']
11
9
 
12
10
  $LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
13
11
  $LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
14
- $LOAD_PATH.unshift( archlib.to_s ) unless $LOAD_PATH.include?( archlib.to_s )
15
12
  }
16
13
 
17
14
  require 'rspec'
18
15
  require 'spec/lib/helpers'
19
16
  require 'pg'
20
17
 
21
- describe PGresult do
22
- include PgTestingHelpers
18
+ describe PG::Result do
23
19
 
24
20
  before( :all ) do
25
- @conn = setup_testing_db( "PGresult" )
21
+ @conn = setup_testing_db( "PG_Result" )
26
22
  end
27
23
 
28
24
  before( :each ) do
@@ -63,20 +59,20 @@ describe PGresult do
63
59
 
64
60
  result = exception.result
65
61
 
66
- result.should be_a( PGresult )
67
- result.error_field( PGresult::PG_DIAG_SEVERITY ).should == 'ERROR'
68
- result.error_field( PGresult::PG_DIAG_SQLSTATE ).should == '42P01'
69
- result.error_field( PGresult::PG_DIAG_MESSAGE_PRIMARY ).
62
+ result.should be_a( described_class() )
63
+ result.error_field( PG::PG_DIAG_SEVERITY ).should == 'ERROR'
64
+ result.error_field( PG::PG_DIAG_SQLSTATE ).should == '42P01'
65
+ result.error_field( PG::PG_DIAG_MESSAGE_PRIMARY ).
70
66
  should == 'relation "nonexistant_table" does not exist'
71
- result.error_field( PGresult::PG_DIAG_MESSAGE_DETAIL ).should be_nil()
72
- result.error_field( PGresult::PG_DIAG_MESSAGE_HINT ).should be_nil()
73
- result.error_field( PGresult::PG_DIAG_STATEMENT_POSITION ).should == '15'
74
- result.error_field( PGresult::PG_DIAG_INTERNAL_POSITION ).should be_nil()
75
- result.error_field( PGresult::PG_DIAG_INTERNAL_QUERY ).should be_nil()
76
- result.error_field( PGresult::PG_DIAG_CONTEXT ).should be_nil()
77
- result.error_field( PGresult::PG_DIAG_SOURCE_FILE ).should =~ /parse_relation\.c$/
78
- result.error_field( PGresult::PG_DIAG_SOURCE_LINE ).should == '857'
79
- result.error_field( PGresult::PG_DIAG_SOURCE_FUNCTION ).should == 'parserOpenTable'
67
+ result.error_field( PG::PG_DIAG_MESSAGE_DETAIL ).should be_nil()
68
+ result.error_field( PG::PG_DIAG_MESSAGE_HINT ).should be_nil()
69
+ result.error_field( PG::PG_DIAG_STATEMENT_POSITION ).should == '15'
70
+ result.error_field( PG::PG_DIAG_INTERNAL_POSITION ).should be_nil()
71
+ result.error_field( PG::PG_DIAG_INTERNAL_QUERY ).should be_nil()
72
+ result.error_field( PG::PG_DIAG_CONTEXT ).should be_nil()
73
+ result.error_field( PG::PG_DIAG_SOURCE_FILE ).should =~ /parse_relation\.c$/
74
+ result.error_field( PG::PG_DIAG_SOURCE_LINE ).should == '857'
75
+ result.error_field( PG::PG_DIAG_SOURCE_FUNCTION ).should == 'parserOpenTable'
80
76
 
81
77
  end
82
78
 
@@ -85,7 +81,7 @@ describe PGresult do
85
81
  begin
86
82
  res = @conn.exec("SELECT 1/0")
87
83
  rescue PGError => e
88
- sqlstate = e.result.result_error_field( PGresult::PG_DIAG_SQLSTATE ).to_i
84
+ sqlstate = e.result.result_error_field( PG::PG_DIAG_SQLSTATE ).to_i
89
85
  end
90
86
  sqlstate.should == 22012
91
87
  end
@@ -103,7 +99,7 @@ describe PGresult do
103
99
  in_bytes = File.open(binary_file, 'rb').read
104
100
  out_bytes = nil
105
101
  @conn.exec("SET standard_conforming_strings=on")
106
- res = @conn.exec("VALUES ('#{PGconn.escape_bytea(in_bytes)}'::bytea)", [], 1)
102
+ res = @conn.exec("VALUES ('#{PG::Connection.escape_bytea(in_bytes)}'::bytea)", [], 1)
107
103
  out_bytes = res[0]['column1']
108
104
  out_bytes.should == in_bytes
109
105
  end
@@ -113,7 +109,7 @@ describe PGresult do
113
109
  bytes = File.open(binary_file, 'rb').read
114
110
  res = @conn.exec('VALUES ($1::bytea)',
115
111
  [ { :value => bytes, :format => 1 } ])
116
- PGconn.unescape_bytea(res[0]['column1']).should== bytes
112
+ PG::Connection.unescape_bytea(res[0]['column1']).should== bytes
117
113
  end
118
114
 
119
115
  it "should return the same bytes in text format that are sent as inline text" do
@@ -122,8 +118,8 @@ describe PGresult do
122
118
 
123
119
  out_bytes = nil
124
120
  @conn.exec("SET standard_conforming_strings=on")
125
- res = @conn.exec("VALUES ('#{PGconn.escape_bytea(in_bytes)}'::bytea)", [], 0)
126
- out_bytes = PGconn.unescape_bytea(res[0]['column1'])
121
+ res = @conn.exec("VALUES ('#{PG::Connection.escape_bytea(in_bytes)}'::bytea)", [], 0)
122
+ out_bytes = PG::Connection.unescape_bytea(res[0]['column1'])
127
123
  out_bytes.should == in_bytes
128
124
  end
129
125
 
@@ -175,19 +171,19 @@ describe PGresult do
175
171
  res.fmod( 0 ).should == 33 + 4 # Column length + varlena size (4)
176
172
  end
177
173
 
178
- it "should raise an exception when an invalid index is passed to PGresult#fmod" do
174
+ it "should raise an exception when an invalid index is passed to PG::Result#fmod" do
179
175
  @conn.exec( 'CREATE TABLE fmodtest ( foo varchar(33) )' )
180
176
  res = @conn.exec( 'SELECT * FROM fmodtest' )
181
177
  expect { res.fmod(1) }.to raise_error( ArgumentError )
182
178
  end
183
179
 
184
- it "should raise an exception when an invalid (negative) index is passed to PGresult#fmod" do
180
+ it "should raise an exception when an invalid (negative) index is passed to PG::Result#fmod" do
185
181
  @conn.exec( 'CREATE TABLE fmodtest ( foo varchar(33) )' )
186
182
  res = @conn.exec( 'SELECT * FROM fmodtest' )
187
183
  expect { res.fmod(-11) }.to raise_error( ArgumentError )
188
184
  end
189
185
 
190
- it "shouldn't raise an exception when a valid index is passed to PGresult#fmod for a column with no typemod" do
186
+ it "shouldn't raise an exception when a valid index is passed to PG::Result#fmod for a column with no typemod" do
191
187
  @conn.exec( 'CREATE TABLE fmodtest ( foo text )' )
192
188
  res = @conn.exec( 'SELECT * FROM fmodtest' )
193
189
  res.fmod( 0 ).should == -1 # and it shouldn't raise an exception, either
@@ -201,25 +197,25 @@ describe PGresult do
201
197
  res.ftable( 0 ).should == be_nonzero()
202
198
  end
203
199
 
204
- it "should raise an exception when an invalid index is passed to PGresult#ftable" do
200
+ it "should raise an exception when an invalid index is passed to PG::Result#ftable" do
205
201
  @conn.exec( 'CREATE TABLE ftabletest ( foo text )' )
206
202
  res = @conn.exec( 'SELECT * FROM ftabletest' )
207
203
 
208
204
  expect { res.ftable(18) }.to raise_error( ArgumentError )
209
205
  end
210
206
 
211
- it "should raise an exception when an invalid (negative) index is passed to PGresult#ftable" do
207
+ it "should raise an exception when an invalid (negative) index is passed to PG::Result#ftable" do
212
208
  @conn.exec( 'CREATE TABLE ftabletest ( foo text )' )
213
209
  res = @conn.exec( 'SELECT * FROM ftabletest' )
214
210
 
215
211
  expect { res.ftable(-2) }.to raise_error( ArgumentError )
216
212
  end
217
213
 
218
- it "shouldn't raise an exception when a valid index is passed to PGresult#ftable for a " +
214
+ it "shouldn't raise an exception when a valid index is passed to PG::Result#ftable for a " +
219
215
  "column with no corresponding table" do
220
216
  @conn.exec( 'CREATE TABLE ftabletest ( foo text )' )
221
217
  res = @conn.exec( 'SELECT foo, LENGTH(foo) as length FROM ftabletest' )
222
- res.ftable( 1 ).should == PGresult::InvalidOid # and it shouldn't raise an exception, either
218
+ res.ftable( 1 ).should == PG::INVALID_OID # and it shouldn't raise an exception, either
223
219
  end
224
220
 
225
221
  # PQftablecol
@@ -231,21 +227,21 @@ describe PGresult do
231
227
  res.ftablecol( 1 ).should == 2
232
228
  end
233
229
 
234
- it "should raise an exception when an invalid index is passed to PGresult#ftablecol" do
230
+ it "should raise an exception when an invalid index is passed to PG::Result#ftablecol" do
235
231
  @conn.exec( 'CREATE TABLE ftablecoltest ( foo text, bar numeric )' )
236
232
  res = @conn.exec( 'SELECT * FROM ftablecoltest' )
237
233
 
238
234
  expect { res.ftablecol(32) }.to raise_error( ArgumentError )
239
235
  end
240
236
 
241
- it "should raise an exception when an invalid (negative) index is passed to PGresult#ftablecol" do
237
+ it "should raise an exception when an invalid (negative) index is passed to PG::Result#ftablecol" do
242
238
  @conn.exec( 'CREATE TABLE ftablecoltest ( foo text, bar numeric )' )
243
239
  res = @conn.exec( 'SELECT * FROM ftablecoltest' )
244
240
 
245
241
  expect { res.ftablecol(-1) }.to raise_error( ArgumentError )
246
242
  end
247
243
 
248
- it "shouldn't raise an exception when a valid index is passed to PGresult#ftablecol for a " +
244
+ it "shouldn't raise an exception when a valid index is passed to PG::Result#ftablecol for a " +
249
245
  "column with no corresponding table" do
250
246
  @conn.exec( 'CREATE TABLE ftablecoltest ( foo text )' )
251
247
  res = @conn.exec( 'SELECT foo, LENGTH(foo) as length FROM ftablecoltest' )
@@ -0,0 +1,22 @@
1
+ #!/usr/bin/env rspec
2
+ # encoding: utf-8
3
+
4
+ BEGIN {
5
+ require 'pathname'
6
+
7
+ basedir = Pathname( __FILE__ ).dirname.parent
8
+ libdir = basedir + 'lib'
9
+
10
+ $LOAD_PATH.unshift( basedir.to_s ) unless $LOAD_PATH.include?( basedir.to_s )
11
+ $LOAD_PATH.unshift( libdir.to_s ) unless $LOAD_PATH.include?( libdir.to_s )
12
+ }
13
+
14
+ require 'rspec'
15
+ require 'spec/lib/helpers'
16
+ require 'pg'
17
+
18
+ describe PG do
19
+
20
+
21
+ end
22
+
metadata CHANGED
@@ -1,11 +1,10 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: pg
3
3
  version: !ruby/object:Gem::Version
4
- version: 0.12.2
4
+ version: 0.13.0.pre298
5
5
  prerelease:
6
6
  platform: ruby
7
7
  authors:
8
- - Jeff Davis
9
8
  - Michael Granger
10
9
  autorequire:
11
10
  bindir: bin
@@ -49,11 +48,11 @@ cert_chain:
49
48
  -----END CERTIFICATE-----
50
49
 
51
50
  '
52
- date: 2012-01-03 00:00:00.000000000 Z
51
+ date: 2012-01-25 00:00:00.000000000 Z
53
52
  dependencies:
54
53
  - !ruby/object:Gem::Dependency
55
54
  name: hoe-mercurial
56
- requirement: &70233760093620 !ruby/object:Gem::Requirement
55
+ requirement: &70349919015120 !ruby/object:Gem::Requirement
57
56
  none: false
58
57
  requirements:
59
58
  - - ~>
@@ -61,10 +60,10 @@ dependencies:
61
60
  version: 1.3.1
62
61
  type: :development
63
62
  prerelease: false
64
- version_requirements: *70233760093620
63
+ version_requirements: *70349919015120
65
64
  - !ruby/object:Gem::Dependency
66
65
  name: hoe-highline
67
- requirement: &70233760093100 !ruby/object:Gem::Requirement
66
+ requirement: &70349919014520 !ruby/object:Gem::Requirement
68
67
  none: false
69
68
  requirements:
70
69
  - - ~>
@@ -72,10 +71,10 @@ dependencies:
72
71
  version: 0.0.1
73
72
  type: :development
74
73
  prerelease: false
75
- version_requirements: *70233760093100
74
+ version_requirements: *70349919014520
76
75
  - !ruby/object:Gem::Dependency
77
76
  name: rake-compiler
78
- requirement: &70233760092580 !ruby/object:Gem::Requirement
77
+ requirement: &70349919014000 !ruby/object:Gem::Requirement
79
78
  none: false
80
79
  requirements:
81
80
  - - ~>
@@ -83,10 +82,10 @@ dependencies:
83
82
  version: '0.7'
84
83
  type: :development
85
84
  prerelease: false
86
- version_requirements: *70233760092580
85
+ version_requirements: *70349919014000
87
86
  - !ruby/object:Gem::Dependency
88
87
  name: rspec
89
- requirement: &70233760092140 !ruby/object:Gem::Requirement
88
+ requirement: &70349919013480 !ruby/object:Gem::Requirement
90
89
  none: false
91
90
  requirements:
92
91
  - - ~>
@@ -94,35 +93,37 @@ dependencies:
94
93
  version: '2.6'
95
94
  type: :development
96
95
  prerelease: false
97
- version_requirements: *70233760092140
96
+ version_requirements: *70349919013480
98
97
  - !ruby/object:Gem::Dependency
99
- name: hoe
100
- requirement: &70233760091700 !ruby/object:Gem::Requirement
98
+ name: rdoc
99
+ requirement: &70349919012900 !ruby/object:Gem::Requirement
101
100
  none: false
102
101
  requirements:
103
102
  - - ~>
104
103
  - !ruby/object:Gem::Version
105
- version: '2.12'
104
+ version: '3.10'
106
105
  type: :development
107
106
  prerelease: false
108
- version_requirements: *70233760091700
107
+ version_requirements: *70349919012900
109
108
  - !ruby/object:Gem::Dependency
110
- name: rdoc
111
- requirement: &70233760164380 !ruby/object:Gem::Requirement
109
+ name: hoe
110
+ requirement: &70349919012420 !ruby/object:Gem::Requirement
112
111
  none: false
113
112
  requirements:
114
113
  - - ~>
115
114
  - !ruby/object:Gem::Version
116
- version: '3.10'
115
+ version: '2.13'
117
116
  type: :development
118
117
  prerelease: false
119
- version_requirements: *70233760164380
118
+ version_requirements: *70349919012420
120
119
  description: ! "Pg is the Ruby interface to the {PostgreSQL RDBMS}[http://www.postgresql.org/].\n\nIt
121
- works with PostgreSQL 8.2 and later.\n\nThis will be the last minor version to support
122
- 8.2 -- 0.13 will support 8.3 \nand later, following the \n{PostgreSQL Release Support
123
- Policy}[http://bit.ly/6AfPhm]."
120
+ works with {PostgreSQL 8.3 and later}[http://bit.ly/6AfPhm].\n\nA small example
121
+ usage:\n\n #!/usr/bin/env ruby\n \n require 'pg'\n \n # Output a table of current
122
+ connections to the DB\n conn = PG.connect( dbname: 'sales' )\n conn.exec( \"SELECT
123
+ * FROM pg_stat_activity\" ) do |result|\n puts \" PID | User |
124
+ Query\"\n\tresult.each do |row|\n puts \" %7d | %-16s | %s \" %\n row.values_at('procpid',
125
+ 'usename', 'current_query')\n end\n end"
124
126
  email:
125
- - ruby-pg@j-davis.com
126
127
  - ged@FaerieMUD.org
127
128
  executables: []
128
129
  extensions:
@@ -131,59 +132,60 @@ extra_rdoc_files:
131
132
  - Manifest.txt
132
133
  - Contributors.rdoc
133
134
  - History.rdoc
135
+ - README-OS_X.rdoc
136
+ - README-Windows.rdoc
134
137
  - README.ja.rdoc
135
- - README.OS_X.rdoc
136
138
  - README.rdoc
137
- - README.windows.rdoc
138
- - BSD
139
- - GPL
139
+ - POSTGRES
140
140
  - LICENSE
141
- - ext/compat.c
142
141
  - ext/pg.c
142
+ - ext/pg_connection.c
143
+ - ext/pg_result.c
143
144
  files:
144
145
  - .gemtest
145
- - BSD
146
+ - .hoerc
147
+ - .tm_properties
146
148
  - ChangeLog
147
149
  - Contributors.rdoc
148
- - GPL
149
150
  - History.rdoc
150
151
  - LICENSE
151
152
  - Manifest.txt
152
- - README.OS_X.rdoc
153
+ - POSTGRES
154
+ - README-OS_X.rdoc
155
+ - README-Windows.rdoc
153
156
  - README.ja.rdoc
154
157
  - README.rdoc
155
- - README.windows.rdoc
156
158
  - Rakefile
157
159
  - Rakefile.cross
158
- - ext/compat.c
159
- - ext/compat.h
160
160
  - ext/extconf.rb
161
161
  - ext/pg.c
162
162
  - ext/pg.h
163
+ - ext/pg_connection.c
164
+ - ext/pg_result.c
163
165
  - ext/vc/pg.sln
164
166
  - ext/vc/pg_18/pg.vcproj
165
167
  - ext/vc/pg_19/pg_19.vcproj
166
168
  - lib/pg.rb
169
+ - lib/pg/connection.rb
170
+ - lib/pg/constants.rb
171
+ - lib/pg/exceptions.rb
172
+ - lib/pg/result.rb
167
173
  - misc/openssl-pg-segfault.rb
168
174
  - sample/async_api.rb
169
175
  - sample/async_copyto.rb
176
+ - sample/async_mixed.rb
170
177
  - sample/copyfrom.rb
171
178
  - sample/copyto.rb
172
179
  - sample/cursor.rb
173
180
  - sample/losample.rb
174
181
  - sample/notify_wait.rb
175
- - sample/psql.rb
176
- - sample/psqlHelp.rb
177
- - sample/test1.rb
178
- - sample/test2.rb
179
- - sample/test4.rb
180
182
  - sample/test_binary_values.rb
181
183
  - spec/data/expected_trace.out
182
184
  - spec/data/random_binary_data
183
185
  - spec/lib/helpers.rb
184
- - spec/m17n_spec.rb
185
- - spec/pgconn_spec.rb
186
- - spec/pgresult_spec.rb
186
+ - spec/pg/connection_spec.rb
187
+ - spec/pg/result_spec.rb
188
+ - spec/pg_spec.rb
187
189
  homepage: https://bitbucket.org/ged/ruby-pg
188
190
  licenses:
189
191
  - BSD
metadata.gz.sig CHANGED
Binary file
data/GPL DELETED
@@ -1,340 +0,0 @@
1
- GNU GENERAL PUBLIC LICENSE
2
- Version 2, June 1991
3
-
4
- Copyright (C) 1989, 1991 Free Software Foundation, Inc.
5
- 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
6
- Everyone is permitted to copy and distribute verbatim copies
7
- of this license document, but changing it is not allowed.
8
-
9
- Preamble
10
-
11
- The licenses for most software are designed to take away your
12
- freedom to share and change it. By contrast, the GNU General Public
13
- License is intended to guarantee your freedom to share and change free
14
- software--to make sure the software is free for all its users. This
15
- General Public License applies to most of the Free Software
16
- Foundation's software and to any other program whose authors commit to
17
- using it. (Some other Free Software Foundation software is covered by
18
- the GNU Library General Public License instead.) You can apply it to
19
- your programs, too.
20
-
21
- When we speak of free software, we are referring to freedom, not
22
- price. Our General Public Licenses are designed to make sure that you
23
- have the freedom to distribute copies of free software (and charge for
24
- this service if you wish), that you receive source code or can get it
25
- if you want it, that you can change the software or use pieces of it
26
- in new free programs; and that you know you can do these things.
27
-
28
- To protect your rights, we need to make restrictions that forbid
29
- anyone to deny you these rights or to ask you to surrender the rights.
30
- These restrictions translate to certain responsibilities for you if you
31
- distribute copies of the software, or if you modify it.
32
-
33
- For example, if you distribute copies of such a program, whether
34
- gratis or for a fee, you must give the recipients all the rights that
35
- you have. You must make sure that they, too, receive or can get the
36
- source code. And you must show them these terms so they know their
37
- rights.
38
-
39
- We protect your rights with two steps: (1) copyright the software, and
40
- (2) offer you this license which gives you legal permission to copy,
41
- distribute and/or modify the software.
42
-
43
- Also, for each author's protection and ours, we want to make certain
44
- that everyone understands that there is no warranty for this free
45
- software. If the software is modified by someone else and passed on, we
46
- want its recipients to know that what they have is not the original, so
47
- that any problems introduced by others will not reflect on the original
48
- authors' reputations.
49
-
50
- Finally, any free program is threatened constantly by software
51
- patents. We wish to avoid the danger that redistributors of a free
52
- program will individually obtain patent licenses, in effect making the
53
- program proprietary. To prevent this, we have made it clear that any
54
- patent must be licensed for everyone's free use or not licensed at all.
55
-
56
- The precise terms and conditions for copying, distribution and
57
- modification follow.
58
-
59
- GNU GENERAL PUBLIC LICENSE
60
- TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
61
-
62
- 0. This License applies to any program or other work which contains
63
- a notice placed by the copyright holder saying it may be distributed
64
- under the terms of this General Public License. The "Program", below,
65
- refers to any such program or work, and a "work based on the Program"
66
- means either the Program or any derivative work under copyright law:
67
- that is to say, a work containing the Program or a portion of it,
68
- either verbatim or with modifications and/or translated into another
69
- language. (Hereinafter, translation is included without limitation in
70
- the term "modification".) Each licensee is addressed as "you".
71
-
72
- Activities other than copying, distribution and modification are not
73
- covered by this License; they are outside its scope. The act of
74
- running the Program is not restricted, and the output from the Program
75
- is covered only if its contents constitute a work based on the
76
- Program (independent of having been made by running the Program).
77
- Whether that is true depends on what the Program does.
78
-
79
- 1. You may copy and distribute verbatim copies of the Program's
80
- source code as you receive it, in any medium, provided that you
81
- conspicuously and appropriately publish on each copy an appropriate
82
- copyright notice and disclaimer of warranty; keep intact all the
83
- notices that refer to this License and to the absence of any warranty;
84
- and give any other recipients of the Program a copy of this License
85
- along with the Program.
86
-
87
- You may charge a fee for the physical act of transferring a copy, and
88
- you may at your option offer warranty protection in exchange for a fee.
89
-
90
- 2. You may modify your copy or copies of the Program or any portion
91
- of it, thus forming a work based on the Program, and copy and
92
- distribute such modifications or work under the terms of Section 1
93
- above, provided that you also meet all of these conditions:
94
-
95
- a) You must cause the modified files to carry prominent notices
96
- stating that you changed the files and the date of any change.
97
-
98
- b) You must cause any work that you distribute or publish, that in
99
- whole or in part contains or is derived from the Program or any
100
- part thereof, to be licensed as a whole at no charge to all third
101
- parties under the terms of this License.
102
-
103
- c) If the modified program normally reads commands interactively
104
- when run, you must cause it, when started running for such
105
- interactive use in the most ordinary way, to print or display an
106
- announcement including an appropriate copyright notice and a
107
- notice that there is no warranty (or else, saying that you provide
108
- a warranty) and that users may redistribute the program under
109
- these conditions, and telling the user how to view a copy of this
110
- License. (Exception: if the Program itself is interactive but
111
- does not normally print such an announcement, your work based on
112
- the Program is not required to print an announcement.)
113
-
114
- These requirements apply to the modified work as a whole. If
115
- identifiable sections of that work are not derived from the Program,
116
- and can be reasonably considered independent and separate works in
117
- themselves, then this License, and its terms, do not apply to those
118
- sections when you distribute them as separate works. But when you
119
- distribute the same sections as part of a whole which is a work based
120
- on the Program, the distribution of the whole must be on the terms of
121
- this License, whose permissions for other licensees extend to the
122
- entire whole, and thus to each and every part regardless of who wrote it.
123
-
124
- Thus, it is not the intent of this section to claim rights or contest
125
- your rights to work written entirely by you; rather, the intent is to
126
- exercise the right to control the distribution of derivative or
127
- collective works based on the Program.
128
-
129
- In addition, mere aggregation of another work not based on the Program
130
- with the Program (or with a work based on the Program) on a volume of
131
- a storage or distribution medium does not bring the other work under
132
- the scope of this License.
133
-
134
- 3. You may copy and distribute the Program (or a work based on it,
135
- under Section 2) in object code or executable form under the terms of
136
- Sections 1 and 2 above provided that you also do one of the following:
137
-
138
- a) Accompany it with the complete corresponding machine-readable
139
- source code, which must be distributed under the terms of Sections
140
- 1 and 2 above on a medium customarily used for software interchange; or,
141
-
142
- b) Accompany it with a written offer, valid for at least three
143
- years, to give any third party, for a charge no more than your
144
- cost of physically performing source distribution, a complete
145
- machine-readable copy of the corresponding source code, to be
146
- distributed under the terms of Sections 1 and 2 above on a medium
147
- customarily used for software interchange; or,
148
-
149
- c) Accompany it with the information you received as to the offer
150
- to distribute corresponding source code. (This alternative is
151
- allowed only for noncommercial distribution and only if you
152
- received the program in object code or executable form with such
153
- an offer, in accord with Subsection b above.)
154
-
155
- The source code for a work means the preferred form of the work for
156
- making modifications to it. For an executable work, complete source
157
- code means all the source code for all modules it contains, plus any
158
- associated interface definition files, plus the scripts used to
159
- control compilation and installation of the executable. However, as a
160
- special exception, the source code distributed need not include
161
- anything that is normally distributed (in either source or binary
162
- form) with the major components (compiler, kernel, and so on) of the
163
- operating system on which the executable runs, unless that component
164
- itself accompanies the executable.
165
-
166
- If distribution of executable or object code is made by offering
167
- access to copy from a designated place, then offering equivalent
168
- access to copy the source code from the same place counts as
169
- distribution of the source code, even though third parties are not
170
- compelled to copy the source along with the object code.
171
-
172
- 4. You may not copy, modify, sublicense, or distribute the Program
173
- except as expressly provided under this License. Any attempt
174
- otherwise to copy, modify, sublicense or distribute the Program is
175
- void, and will automatically terminate your rights under this License.
176
- However, parties who have received copies, or rights, from you under
177
- this License will not have their licenses terminated so long as such
178
- parties remain in full compliance.
179
-
180
- 5. You are not required to accept this License, since you have not
181
- signed it. However, nothing else grants you permission to modify or
182
- distribute the Program or its derivative works. These actions are
183
- prohibited by law if you do not accept this License. Therefore, by
184
- modifying or distributing the Program (or any work based on the
185
- Program), you indicate your acceptance of this License to do so, and
186
- all its terms and conditions for copying, distributing or modifying
187
- the Program or works based on it.
188
-
189
- 6. Each time you redistribute the Program (or any work based on the
190
- Program), the recipient automatically receives a license from the
191
- original licensor to copy, distribute or modify the Program subject to
192
- these terms and conditions. You may not impose any further
193
- restrictions on the recipients' exercise of the rights granted herein.
194
- You are not responsible for enforcing compliance by third parties to
195
- this License.
196
-
197
- 7. If, as a consequence of a court judgment or allegation of patent
198
- infringement or for any other reason (not limited to patent issues),
199
- conditions are imposed on you (whether by court order, agreement or
200
- otherwise) that contradict the conditions of this License, they do not
201
- excuse you from the conditions of this License. If you cannot
202
- distribute so as to satisfy simultaneously your obligations under this
203
- License and any other pertinent obligations, then as a consequence you
204
- may not distribute the Program at all. For example, if a patent
205
- license would not permit royalty-free redistribution of the Program by
206
- all those who receive copies directly or indirectly through you, then
207
- the only way you could satisfy both it and this License would be to
208
- refrain entirely from distribution of the Program.
209
-
210
- If any portion of this section is held invalid or unenforceable under
211
- any particular circumstance, the balance of the section is intended to
212
- apply and the section as a whole is intended to apply in other
213
- circumstances.
214
-
215
- It is not the purpose of this section to induce you to infringe any
216
- patents or other property right claims or to contest validity of any
217
- such claims; this section has the sole purpose of protecting the
218
- integrity of the free software distribution system, which is
219
- implemented by public license practices. Many people have made
220
- generous contributions to the wide range of software distributed
221
- through that system in reliance on consistent application of that
222
- system; it is up to the author/donor to decide if he or she is willing
223
- to distribute software through any other system and a licensee cannot
224
- impose that choice.
225
-
226
- This section is intended to make thoroughly clear what is believed to
227
- be a consequence of the rest of this License.
228
-
229
- 8. If the distribution and/or use of the Program is restricted in
230
- certain countries either by patents or by copyrighted interfaces, the
231
- original copyright holder who places the Program under this License
232
- may add an explicit geographical distribution limitation excluding
233
- those countries, so that distribution is permitted only in or among
234
- countries not thus excluded. In such case, this License incorporates
235
- the limitation as if written in the body of this License.
236
-
237
- 9. The Free Software Foundation may publish revised and/or new versions
238
- of the General Public License from time to time. Such new versions will
239
- be similar in spirit to the present version, but may differ in detail to
240
- address new problems or concerns.
241
-
242
- Each version is given a distinguishing version number. If the Program
243
- specifies a version number of this License which applies to it and "any
244
- later version", you have the option of following the terms and conditions
245
- either of that version or of any later version published by the Free
246
- Software Foundation. If the Program does not specify a version number of
247
- this License, you may choose any version ever published by the Free Software
248
- Foundation.
249
-
250
- 10. If you wish to incorporate parts of the Program into other free
251
- programs whose distribution conditions are different, write to the author
252
- to ask for permission. For software which is copyrighted by the Free
253
- Software Foundation, write to the Free Software Foundation; we sometimes
254
- make exceptions for this. Our decision will be guided by the two goals
255
- of preserving the free status of all derivatives of our free software and
256
- of promoting the sharing and reuse of software generally.
257
-
258
- NO WARRANTY
259
-
260
- 11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
261
- FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW. EXCEPT WHEN
262
- OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
263
- PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
264
- OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
265
- MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
266
- TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE
267
- PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
268
- REPAIR OR CORRECTION.
269
-
270
- 12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
271
- WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
272
- REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
273
- INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
274
- OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
275
- TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
276
- YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
277
- PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
278
- POSSIBILITY OF SUCH DAMAGES.
279
-
280
- END OF TERMS AND CONDITIONS
281
-
282
- How to Apply These Terms to Your New Programs
283
-
284
- If you develop a new program, and you want it to be of the greatest
285
- possible use to the public, the best way to achieve this is to make it
286
- free software which everyone can redistribute and change under these terms.
287
-
288
- To do so, attach the following notices to the program. It is safest
289
- to attach them to the start of each source file to most effectively
290
- convey the exclusion of warranty; and each file should have at least
291
- the "copyright" line and a pointer to where the full notice is found.
292
-
293
- <one line to give the program's name and a brief idea of what it does.>
294
- Copyright (C) <year> <name of author>
295
-
296
- This program is free software; you can redistribute it and/or modify
297
- it under the terms of the GNU General Public License as published by
298
- the Free Software Foundation; either version 2 of the License, or
299
- (at your option) any later version.
300
-
301
- This program is distributed in the hope that it will be useful,
302
- but WITHOUT ANY WARRANTY; without even the implied warranty of
303
- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
304
- GNU General Public License for more details.
305
-
306
- You should have received a copy of the GNU General Public License
307
- along with this program; if not, write to the Free Software
308
- Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
309
-
310
-
311
- Also add information on how to contact you by electronic and paper mail.
312
-
313
- If the program is interactive, make it output a short notice like this
314
- when it starts in an interactive mode:
315
-
316
- Gnomovision version 69, Copyright (C) year name of author
317
- Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
318
- This is free software, and you are welcome to redistribute it
319
- under certain conditions; type `show c' for details.
320
-
321
- The hypothetical commands `show w' and `show c' should show the appropriate
322
- parts of the General Public License. Of course, the commands you use may
323
- be called something other than `show w' and `show c'; they could even be
324
- mouse-clicks or menu items--whatever suits your program.
325
-
326
- You should also get your employer (if you work as a programmer) or your
327
- school, if any, to sign a "copyright disclaimer" for the program, if
328
- necessary. Here is a sample; alter the names:
329
-
330
- Yoyodyne, Inc., hereby disclaims all copyright interest in the program
331
- `Gnomovision' (which makes passes at compilers) written by James Hacker.
332
-
333
- <signature of Ty Coon>, 1 April 1989
334
- Ty Coon, President of Vice
335
-
336
- This General Public License does not permit incorporating your program into
337
- proprietary programs. If your program is a subroutine library, you may
338
- consider it more useful to permit linking proprietary applications with the
339
- library. If this is what you want to do, use the GNU Lesser General
340
- Public License instead of this License.