File: README

package info (click to toggle)
libodbc-ruby 0.994-1
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 312 kB
  • ctags: 413
  • sloc: ansic: 4,869; ruby: 200; makefile: 68
file content (100 lines) | stat: -rw-r--r-- 2,245 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
# $Id: README,v 1.23 2004/07/14 06:59:18 chw Exp chw $

ruby-odbc-0.994

This is an ODBC binding for Ruby. So far it has been tested with

    - Ruby 1.[6-8], MySQL 3.22/MyODBC (local), unixODBC 2.1.0
      on Linux 2.2-x86

    - Ruby 1.6.4, MySQL 3.22/MyODBC (local), libiodbc 2.50
      on Linux 2.2-x86

    - Ruby 1.[6-8], MySQL 3.22/MyODBC (remote), MS Jet Engine, MSVC++ 6.0
      on Windows NT4SP6

    - Ruby 1.6.[3-5], MySQL 3.22/MyODBC (remote), MS Jet Engine, cygwin,
      on Windows NT4SP6 and 2000

    Michael Neumann <neumann@s-direktnet.de> and
    Will Merrell <wmerrell@catalystcorp.com> reported successful compilation
    with Cygwin on Win32.

Requirements:

    - Ruby 1.6.[3-8] or Ruby >= 1.7
    - unixODBC 2.x or libiodbc 2.50 on UN*X 

Installation:

    $ ruby extconf.rb
    $ make
    # make install

Installation of utf8 version:

    $ ruby -Cutf8 extconf.rb
    $ make -C utf8
    # make -C utf8 install

Installation MSVC:

    C:..>ruby extconf.rb
    C:..>nmake
    C:..>nmake install
    C:..>cd utf8
    C:..>ruby extconf.rb
    C:..>nmake
    C:..>nmake install

Testing:

    $ ruby test.rb DSN [uid] [pwd]
 or
    $ ruby -KU -Cutf8 test.rb DSN [uid] [pwd]

Usage:

    Refer to doc/odbc.html

    The difference between utf8 and non-utf8 versions are:

      - non-utf8 version uses normal SQL.* ANSI functions
      - utf8 version uses SQL.*W UNICODE functions and
        requires/returns all strings in UTF8 format

    Thus, depending on the -K option of ruby one could use
    that code snippet:

      ...
      if $KCODE == "UTF8" then
        require 'odbc_utf8'
      else
        require 'odbc'
      fi

    It is also possible to load both non-utf8 and utf8 version
    into ruby:

      ...
      # non-utf8 version
      require 'odbc'
      # utf8 version
      require 'odbc_utf8'

    Whichever is loaded first, gets the module name 'ODBC'.
    The second loaded module will be named 'ODBC_UTF8' (for
    'odbc_utf8') or 'ODBC_NONE' (for 'odbc'). That should
    allow to use both versions simultaneously in special
    situations.

TODO:

    - heavier testing
    - improve documentation

Author:

    Christian Werner
    mailto:chw@ch-werner.de
    http://www.ch-werner.de/rubyodbc