trinidad_sqlite_dbpool_extension 0.4.1

data/History.txt

@@ -0,0 +1,40 @@
+== 0.4.1 (2012-11-29)
+
+* updated driver jars for following :
+  - trinidad_mysql_dbpool_extension
+  - trinidad_postgresql_dbpool_extension
+  - trinidad_mssql_dbpool_extension
+* added trinidad_sqlite_dbpool_extension
+
+== 0.4.0 (2012-05-31)
+
+* revised trinidad_generic_dbpool_extension :
+  - driver configuration option aliased as driverName
+  - new driverPath option for specifying driver jar in configuration
+  - allow driverName to be auto resolved when driverPath specified
+* trinidad_postgresql_dbpool_extension with driver updated to 9.1-902
+* trinidad_mysql_dbpool_extension with mysql-connector-j 5.1.20
+* code cleanup, get rid of jeweler, update tomcat-dbcp.jar for trinidad_dbpool
+
+== 0.3.0 (2011-07-01)
+
+* Oracle connection pool extension
+* Mssql connection pool extension
+* Postgresql syntax error fix
+* Add support for multiple pools per db extension
+
+== 0.2.0 (2010-07-29)
+
+* Update trinidad_dbpool_extension common gem to support Tomcat 7 
+
+== 0.1.1 (2010-05-05)
+
+* Update trinidad_dbpool_extension common gem
+* Remove adding jndi context and resource to the global tomcat context
+
+== 0.1.0 (2010-04-04)
+
+* First release
+* General connection pool extension
+* Mysql connection pool extension
+* Postgresql connection pool extension

data/LICENSE

@@ -0,0 +1,25 @@
+Copyright (c) 2012 Team Trinidad and contributors http://github.com/trinidad
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+
+== JDBC Driver
+
+Included JDBC drivers are most likely distributed under different terms than 
+those above, please make sure you understand your driver's license terms.

data/README.rdoc

@@ -0,0 +1,94 @@
+= trinidad-dbpool
+
+Trinidad extensions to support database connection pooling on top of the 
+underlying Apache Tomcat container.
+
+Please note, that such pools are usually configured as "global" and thus 
+shareable by multiple applications deployed on to of Trinidad server.
+
+== Available Pools
+
+* MySQL (trinidad_mysql_dbpool_extension)
+* PostgreSQL (trinidad_postgresql_dbpool_extension)
+* MS-SQL (trinidad_mssql_dbpool_extension) using (unofficial) jTDS driver
+* Oracle (trinidad_oracle_dbpool_extension)
+* Generic (trinidad_generic_dbpool_extension) in case your DB ain't supported
+
+== Usage
+
+* Install the gem e.g. `jruby -S gem install trinidad_mysql_dbpool_extension`
+* Configure the pool with Trinidad's configuration file e.g. :
+
+    web_apps:
+      default:
+        extensions:
+          mysql_dbpool:                        # EXTENSION NAME AS KEY
+            jndi: 'jdbc/TestDB'                # JNDI name
+            username: 'root'                   # database username
+            password: 'root'                   # database password
+            url: 'localhost:3306/javatest'     # database URL (or full jdbc: URL)
+            maxActive: 100                     # max nodes actives
+            maxIdle: 30                        # max nodes idles
+            maxWait: 10000                     # max nodes waiting
+
+_jndi_, _username_, _password_ and _url_ are mandatory, 
+while other supported configuration options might be found here:
+
+http://tomcat.apache.org/tomcat-6.0-doc/jndi-datasource-examples-howto.html
+
+http://commons.apache.org/dbcp/configuration.html
+
+* Configure your rails application to use JNDI into the config/database.yml
+
+    production:
+      adapter: jdbc
+      jndi: java:/comp/env/jdbc/TestDB
+      driver: com.mysql.jdbc.Driver # JDBC driver is mandatory here
+
+== Generic Pool
+
+If there's no "official" pool for your database, or would like to use a 
+different version of a JDBC driver for a supported Trinidad pool, this allows
+you to completely customize a pool.
+
+NOTE: You will need a JDBC driver for your database, check the driver DB if 
+unsure about how to get one http://developers.sun.com/product/jdbc/drivers
+
+Sample configuration for a DB2 database :
+
+    ---
+      extensions:
+        generic_dbpool:                          # EXTENSION NAME AS KEY
+          jndi: 'jdbc/MyDB'                      # JNDI name
+          url: 'jdbc:db2://127.0.0.1:50000/MYDB' # specify full jdbc: URL
+          username: 'mydb'                       # database username
+          password: 'pass'                       # database password
+          driverPath: '/opt/IBM/DB2/db2jcc4.jar' # leave out if it's on class-path
+          driverName: com.ibm.db2.jcc.DB2Driver  # might resolve from driverPath
+
+Beyond standard configuration options there's 2 specific options here :
+
+* _driverPath_ should be a path to your JDBC driver archive, if you're using a
+  --libs jar folder with trinidad, might leave that out but make sure it's on 
+  the class-path for each and every deployed application that requires it.
+
+  Also in case driverPath: is ommited you'll need to specify a driverName: !
+
+* _driverName_ the class name implementing the JDBC driver interface, if you're
+  not sure check the .jar for a META-INF/services/java.sql.Driver file. If 
+  present that file contains the class-name and you might leave driverName: 
+  blank if you specified the jar path using driverPath: but you're going still
+  going to need the driver name in your database.yml
+
+== Note on Patches/Pull Requests
+ 
+* Fork the project.
+* Make your feature addition or bug fix.
+* Add tests for it. This is important so I don't break it in a
+  future version unintentionally.
+* Send me a pull request. Bonus points for topic branches.
+
+== Copyright
+
+Copyright (c) 2012 [Team Trinidad](https://github.com/trinidad). 
+See LICENSE (http://en.wikipedia.org/wiki/MIT_License) for details.

data/Rakefile

@@ -0,0 +1,76 @@
+require 'rubygems'
+require 'rake'
+
+def build(gem)
+  mkdir_p 'pkg'
+  sh "gem build #{gem}.gemspec"
+  mv Dir["#{gem}*.gem"].last, 'pkg'
+end
+
+def release(gem, version = nil)
+  unless `git branch` =~ /^\* master$/
+    raise "must be on master to release !"
+  end
+  
+  if version
+    unless gem_file = Dir.glob("pkg/#{gem}-#{version}.gem").first
+      raise "#{gem}-#{version}.gem not build !"
+    end
+  else
+    unless gem_file = Dir.glob("pkg/#{gem}*").sort.last
+      raise "#{gem}*.gem not build !"
+    end
+    unless match = gem_file.match(/.*?\-(\d\.\d\.\d)\.gem/)
+      raise "version number not matched from: #{gem_file}"
+    end
+    version = match[1]
+  end
+  
+  sh "git tag #{gem}-#{version}"
+  sh "git push origin master --tags"
+  sh "gem push #{gem_file}"
+end
+
+all_gems = %W{ 
+  dbpool
+  generic_dbpool_extension
+  mysql_dbpool_extension
+  postgresql_dbpool_extension
+  sqlite_dbpool_extension
+  mssql_dbpool_extension
+  oracle_dbpool_extension
+}
+all_gems.map! { |gem| "trinidad_#{gem}" }
+all_gems.each do |gem_name|
+  namespace gem_name do
+    desc "Build the #{gem_name} gem"
+    task :build do
+      build(gem_name)
+    end
+    desc "Release the #{gem_name} gem"
+    task :release => :build do
+      release(gem_name)
+    end
+  end
+end
+
+{
+  :build => 'Build all connection pool gems', 
+  :release => 'Release all connection pool gems'
+}.each do |t, d|
+  desc d
+  task t => all_gems.map { |name| "#{name}:#{t}" } # e.g. mysql_dbpool:build
+end
+
+desc "Clear out all built .gem files"
+task :clear do
+  FileUtils.rm Dir["*.gem"]
+  FileUtils.rm_r Dir["pkg/*"] if File.exist?("pkg")
+end
+
+require 'rspec/core/rake_task'
+RSpec::Core::RakeTask.new(:spec) do |spec|
+  spec.rspec_opts = ['--color', "--format documentation"]
+end
+
+task :default => :spec

data/lib/trinidad_sqlite_dbpool_extension.rb

@@ -0,0 +1,3 @@
+require 'trinidad_dbpool'
+load File.expand_path('../../trinidad-libs/sqlite-jdbc-3.7.2.jar', __FILE__)
+require 'trinidad_sqlite_dbpool_extension/sqlite_webapp_extension'

data/lib/trinidad_sqlite_dbpool_extension/sqlite_webapp_extension.rb

@@ -0,0 +1,13 @@
+module Trinidad
+  module Extensions
+    class SqliteDbpoolWebAppExtension < DbpoolWebAppExtension
+      def driver_name
+        'org.sqlite.JDBC'
+      end
+
+      def protocol
+        'jdbc:sqlite://'
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification 
+name: trinidad_sqlite_dbpool_extension
+version: !ruby/object:Gem::Version 
+  prerelease: 
+  version: 0.4.1
+platform: ruby
+authors: 
+  - Karol Bucek
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2012-11-29 00:00:00 Z
+dependencies: 
+  - !ruby/object:Gem::Dependency 
+    name: trinidad_dbpool
+    prerelease: false
+    requirement: &id001 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: 0.4.0
+    type: :runtime
+    version_requirements: *id001
+  - !ruby/object:Gem::Dependency 
+    name: rspec
+    prerelease: false
+    requirement: &id002 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: "2.10"
+    type: :development
+    version_requirements: *id002
+  - !ruby/object:Gem::Dependency 
+    name: mocha
+    prerelease: false
+    requirement: &id003 !ruby/object:Gem::Requirement 
+      none: false
+      requirements: 
+        - - ">="
+          - !ruby/object:Gem::Version 
+            version: "0.10"
+    type: :development
+    version_requirements: *id003
+description: Addon to support Sqlite database pools in Trinidad
+email: self@kares.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+  - LICENSE
+  - README.rdoc
+files: 
+  - lib/trinidad_sqlite_dbpool_extension.rb
+  - lib/trinidad_sqlite_dbpool_extension/sqlite_webapp_extension.rb
+  - trinidad-libs/sqlite-jdbc-3.7.2.jar
+  - History.txt
+  - LICENSE
+  - README.rdoc
+  - Rakefile
+homepage: http://github.com/trinidad/trinidad_dbpool_extension
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+  - lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.8.24
+signing_key: 
+specification_version: 3
+summary: Addon to support Sqlite database pools in Trinidad
+test_files: []
+