automodel-sqlserver 0.1.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (49) hide show
  1. checksums.yaml +7 -0
  2. data/.gitignore +11 -0
  3. data/.rspec +3 -0
  4. data/.rubocop.yml +81 -0
  5. data/.ruby-version +1 -0
  6. data/.travis.yml +5 -0
  7. data/.yardopts +1 -0
  8. data/Gemfile +6 -0
  9. data/Gemfile.lock +82 -0
  10. data/LICENSE.txt +21 -0
  11. data/README.md +225 -0
  12. data/Rakefile +6 -0
  13. data/automodel-sqlserver.gemspec +39 -0
  14. data/bin/console +14 -0
  15. data/bin/setup +8 -0
  16. data/docs/Automodel.html +161 -0
  17. data/docs/Automodel/AdapterAlreadyRegistered.html +144 -0
  18. data/docs/Automodel/AdapterAlreadyRegisteredError.html +144 -0
  19. data/docs/Automodel/CannotFindOnCompoundPrimaryKey.html +144 -0
  20. data/docs/Automodel/Connectors.html +117 -0
  21. data/docs/Automodel/Error.html +140 -0
  22. data/docs/Automodel/FindOnCompoundPrimaryKeyError.html +144 -0
  23. data/docs/Automodel/Helpers.html +722 -0
  24. data/docs/Automodel/NameCollisionError.html +143 -0
  25. data/docs/Automodel/SchemaInspector.html +1046 -0
  26. data/docs/Automodel/UnregisteredAdapter.html +144 -0
  27. data/docs/_index.html +206 -0
  28. data/docs/class_list.html +51 -0
  29. data/docs/css/common.css +1 -0
  30. data/docs/css/full_list.css +58 -0
  31. data/docs/css/style.css +496 -0
  32. data/docs/file.README.html +333 -0
  33. data/docs/file_list.html +56 -0
  34. data/docs/frames.html +17 -0
  35. data/docs/index.html +333 -0
  36. data/docs/js/app.js +292 -0
  37. data/docs/js/full_list.js +216 -0
  38. data/docs/js/jquery.js +4 -0
  39. data/docs/method_list.html +155 -0
  40. data/docs/top-level-namespace.html +478 -0
  41. data/lib/automodel.rb +132 -0
  42. data/lib/automodel/automodel.rb +4 -0
  43. data/lib/automodel/connectors.rb +8 -0
  44. data/lib/automodel/errors.rb +24 -0
  45. data/lib/automodel/helpers.rb +141 -0
  46. data/lib/automodel/schema_inspector.rb +218 -0
  47. data/lib/automodel/version.rb +10 -0
  48. data/samples/database.yml +38 -0
  49. metadata +259 -0
data/docs/file.README.html ADDED
@@ -0,0 +1,333 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>
7
+ File: README
8
+
9
+ &mdash; Documentation by YARD 0.9.14
10
+
11
+ </title>
12
+
13
+ <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
14
+
15
+ <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
16
+
17
+ <script type="text/javascript" charset="utf-8">
18
+ pathId = "README";
19
+ relpath = '';
20
+ </script>
21
+
22
+
23
+ <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
24
+
25
+ <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
26
+
27
+
28
+ </head>
29
+ <body>
30
+ <div class="nav_wrap">
31
+ <iframe id="nav" src="file_list.html?1"></iframe>
32
+ <div id="resizer"></div>
33
+ </div>
34
+
35
+ <div id="main" tabindex="-1">
36
+ <div id="header">
37
+ <div id="menu">
38
+
39
+ <a href="_index.html">Index</a> &raquo;
40
+ <span class="title">File: README</span>
41
+
42
+ </div>
43
+
44
+ <div id="search">
45
+
46
+ <a class="full_list_link" id="class_list_link"
47
+ href="class_list.html">
48
+
49
+ <svg width="24" height="24">
50
+ <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
51
+ <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
52
+ <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
53
+ </svg>
54
+ </a>
55
+
56
+ </div>
57
+ <div class="clear"></div>
58
+ </div>
59
+
60
+ <div id="content"><div id='filecontents'>
61
+ <h1 id="label-automodel-sqlserver+rdoc-image-3Ahttps-3A-2F-2Fbadge.fury.io-2Frb-2Fautomodel-sqlserver.svg">automodel-sqlserver <a href="https://badge.fury.io/rb/automodel-sqlserver"><img src="https://badge.fury.io/rb/automodel-sqlserver.svg"></a></h1>
62
+
63
+ <p>Connecting your Rails application to a database created outside of the
64
+ Rails environment usually means either spending hours writing up class
65
+ files for every table, or giving up on using the ActiveRecord query DSL and
66
+ resigning yourself to building SQL strings and making
67
+ <code>execute</code>/<code>exec_query</code> calls.</p>
68
+
69
+ <p>Are those SQL strings you&#39;re building even injection-safe? Hmm… 😟</p>
70
+
71
+ <p><em>With a single command</em>, <strong>automodel-sqlserver</strong> lets
72
+ you connect to any database and access all of its tables via the
73
+ ActiveRecord DSL you&#39;ve grown to love!</p>
74
+
75
+ <p>It does this by analyzing the table structures and: - automatically
76
+ defining all of the corresponding model classes - declaring column aliases
77
+ so you can use Railsy names an idioms - constructing model relations based
78
+ on foreign key definitions</p>
79
+
80
+ <h2 id="label-Installation">Installation</h2>
81
+
82
+ <p>Add this line to your application&#39;s Gemfile:</p>
83
+
84
+ <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_gem'>gem</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>automodel-sqlserver</span><span class='tstring_end'>&#39;</span></span>
85
+ </code></pre>
86
+
87
+ <p>And then execute:</p>
88
+
89
+ <pre class="code ruby"><code class="ruby">$ bundle</code></pre>
90
+
91
+ <p>Or install it yourself as:</p>
92
+
93
+ <pre class="code ruby"><code class="ruby">$ gem install automodel-sqlserver</code></pre>
94
+
95
+ <h4 id="label-Additional+Dependencies">Additional Dependencies</h4>
96
+
97
+ <p>If you are running on Windows and <strong>not</strong> using RubyInstaller,
98
+ the above steps are all that is needed.</p>
99
+
100
+ <p>On all other platforms, this gem (and its dependencies) alone are not
101
+ sufficient to connect to a SQL Server instance: <strong>you will also need
102
+ to <a href="https://github.com/rails-sqlserver/tiny_tds#install">install
103
+ FreeTDS on your system</a> if you haven&#39;t already</strong>.</p>
104
+
105
+ <h2 id="label-Using+Automodel">Using Automodel</h2>
106
+
107
+ <p>The following examples all assume a Postgres database with the following
108
+ tables: “`sql – Create Table: Authors CREATE TABLE public.“Authors” (
109
+ “Author ID” serial NOT NULL , “Name” varchar NOT NULL DEFAULT &#39;&#39;,
110
+ “Birthday” date NULL , “Address” varchar NOT NULL DEFAULT &#39;&#39;,</p>
111
+
112
+ <p>CONSTRAINT authors__pk PRIMARY KEY (“Author ID”) ) WITH ( OIDS=FALSE );</p>
113
+
114
+ <p>– Create Table: Publishers CREATE TABLE public.“Publishers” ( “Publisher
115
+ ID” serial NOT NULL , “Name” varchar NOT NULL DEFAULT &#39;&#39;,
116
+ “Address” varchar NOT NULL DEFAULT &#39;&#39;, “Website” varchar NOT NULL
117
+ DEFAULT &#39;&#39;,</p>
118
+
119
+ <p>CONSTRAINT publishers__pk PRIMARY KEY (“Publisher ID”) ) WITH ( OIDS=FALSE
120
+ );</p>
121
+
122
+ <p>– Create Table: Books CREATE TABLE public.“Books” ( “Book ID” serial NOT
123
+ NULL , “Title” varchar NOT NULL DEFAULT &#39;&#39; , “Edition” int NOT
124
+ NULL DEFAULT 1 , “ISBN Number” varchar NOT NULL DEFAULT &#39;&#39; ,
125
+ “Published On” date NOT NULL , “Is Out Of Print” bool NOT NULL DEFAULT
126
+ FALSE, “Author ID” bigint NOT NULL , “Publisher ID” bigint NOT NULL ,</p>
127
+
128
+ <p>CONSTRAINT books__pk PRIMARY KEY (“Book ID”),</p>
129
+
130
+ <p>CONSTRAINT books_authors_fk FOREIGN KEY (“Author ID”) REFERENCES
131
+ public.“Authors”(“Author ID”),</p>
132
+
133
+ <p>CONSTRAINT books_publishers_fk FOREIGN KEY (“Publisher ID”) REFERENCES
134
+ public.“Publishers”(“Publisher ID”) ) WITH ( OIDS=FALSE ); “`</p>
135
+ <hr>
136
+
137
+ <h4 id="label-Connecting+To+The+External+Database">Connecting To The External Database</h4>
138
+
139
+ <p>You can provide the connection spec inline …</p>
140
+
141
+ <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_automodel'><span class='object_link'><a href="top-level-namespace.html#automodel-instance_method" title="#automodel (method)">automodel</a></span></span> <span class='label'>adapter:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>postgresql</span><span class='tstring_end'>&#39;</span></span> <span class='comma'>,</span>
142
+ <span class='label'>encoding:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>unicode</span><span class='tstring_end'>&#39;</span></span> <span class='comma'>,</span>
143
+ <span class='label'>host:</span> <span class='id identifier rubyid_hostname'>hostname</span> <span class='comma'>,</span>
144
+ <span class='label'>port:</span> <span class='id identifier rubyid_port_number'>port_number</span> <span class='comma'>,</span>
145
+ <span class='label'>username:</span> <span class='id identifier rubyid_username'>username</span> <span class='comma'>,</span>
146
+ <span class='label'>password:</span> <span class='id identifier rubyid_password'>password</span> <span class='comma'>,</span>
147
+ <span class='label'>database:</span> <span class='id identifier rubyid_database_name'>database_name</span>
148
+ </code></pre>
149
+
150
+ <p>… or you can use a connection spec defined in “config/database.yml” …</p>
151
+
152
+ <pre class="code ruby"><code class="ruby">## In &quot;database.yml&quot; ...
153
+
154
+ ## ... (your application&#39;s own db connection stuff) ...
155
+
156
+
157
+ external_db:
158
+ adapter: postgresql
159
+ pool: &lt;%= ENV.fetch(&#39;RAILS_MAX_THREADS&#39;) { 5 } %&gt;
160
+ timeouts: 5000
161
+ encoding: unicode
162
+ host: name_or_ip
163
+ port: port_number
164
+ username: username
165
+ password: password
166
+ database: sample_db</code></pre>
167
+
168
+ <pre class="code ruby"><code class="ruby"><span class='comment'>## In &quot;config/puma.rb&quot; or &quot;config/unicorn.rb&quot; ...
169
+ </span>
170
+ <span class='id identifier rubyid_automodel'><span class='object_link'><a href="top-level-namespace.html#automodel-instance_method" title="#automodel (method)">automodel</a></span></span> <span class='symbol'>:external_db</span>
171
+ </code></pre>
172
+ <hr>
173
+
174
+ <h4 id="label-Using+The+Automodel-27ed+Objects">Using The Automodel&#39;ed Objects</h4>
175
+
176
+ <p>Connecting via either method above will allow you to issue all of the
177
+ following expressions, just as if these were your own models:</p>
178
+
179
+ <pre class="code ruby"><code class="ruby"><span class='comment'>## ISBNs for all non-first-edition books.
180
+ </span><span class='id identifier rubyid_isbn_list'>isbn_list</span> <span class='op'>=</span> <span class='const'>Book</span><span class='period'>.</span><span class='id identifier rubyid_where'>where</span><span class='period'>.</span><span class='id identifier rubyid_not'>not</span><span class='lparen'>(</span><span class='label'>edition:</span> <span class='int'>1</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_pluck'>pluck</span><span class='lparen'>(</span><span class='symbol'>:isbn_number</span><span class='rparen'>)</span>
181
+
182
+ <span class='comment'>## Take any book and look up some values.
183
+ </span><span class='id identifier rubyid_book'>book</span> <span class='op'>=</span> <span class='const'>Book</span><span class='period'>.</span><span class='id identifier rubyid_take'>take</span>
184
+ <span class='id identifier rubyid_book'>book</span><span class='period'>.</span><span class='id identifier rubyid_title'>title</span>
185
+ <span class='id identifier rubyid_book'>book</span><span class='period'>.</span><span class='id identifier rubyid_out_of_print?'>out_of_print?</span>
186
+ <span class='id identifier rubyid_book'>book</span><span class='period'>.</span><span class='id identifier rubyid_publisher'>publisher</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span>
187
+
188
+
189
+ <span class='comment'>## Note that some ActiveRecord constructs surface real table names,
190
+ </span><span class='comment'>## which can look awkward in code when working with tables with non-Railsy names:
191
+ </span><span class='comment'>## (the uppercase &quot;P&quot; in &quot;Publishers&quot; below makes it look like a class reference)
192
+ </span><span class='const'>Book</span><span class='period'>.</span><span class='id identifier rubyid_joins'>joins</span><span class='lparen'>(</span><span class='symbol'>:Publishers</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_where'>where</span><span class='lparen'>(</span><span class='label'>Publishers:</span> <span class='lbrace'>{</span> <span class='label'>name:</span> <span class='id identifier rubyid_test_value'>test_value</span> <span class='rbrace'>}</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_all'>all</span>
193
+ </code></pre>
194
+ <hr>
195
+
196
+ <h4 id="label-Automodel+With+Namespacing">Automodel With Namespacing</h4>
197
+
198
+ <p>If you&#39;re worried about model name collisions (or just want to keep the
199
+ global namespace tidy), Automodel can define all of the new model classes
200
+ under a module.</p>
201
+
202
+ <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_automodel'><span class='object_link'><a href="top-level-namespace.html#automodel-instance_method" title="#automodel (method)">automodel</a></span></span> <span class='label'>adapter:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>postgresql</span><span class='tstring_end'>&#39;</span></span> <span class='comma'>,</span>
203
+ <span class='label'>encoding:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>unicode</span><span class='tstring_end'>&#39;</span></span> <span class='comma'>,</span>
204
+ <span class='label'>host:</span> <span class='id identifier rubyid_hostname'>hostname</span> <span class='comma'>,</span>
205
+ <span class='label'>port:</span> <span class='id identifier rubyid_port_number'>port_number</span> <span class='comma'>,</span>
206
+ <span class='label'>username:</span> <span class='id identifier rubyid_username'>username</span> <span class='comma'>,</span>
207
+ <span class='label'>password:</span> <span class='id identifier rubyid_password'>password</span> <span class='comma'>,</span>
208
+ <span class='label'>database:</span> <span class='id identifier rubyid_database_name'>database_name</span><span class='comma'>,</span>
209
+ <span class='label'>namespace:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>ExternalDB</span><span class='tstring_end'>&#39;</span></span>
210
+
211
+ <span class='comment'>## Now you can do everything you&#39;d expect, but the models are namespaced under ExternalDB.
212
+ </span><span class='const'>ExternalDB</span><span class='op'>::</span><span class='const'>Book</span><span class='period'>.</span><span class='id identifier rubyid_find'>find</span><span class='lparen'>(</span><span class='int'>5</span><span class='rparen'>)</span> <span class='comment'>## =&gt; Book #5
213
+ </span><span class='const'>ExternalDB</span><span class='op'>::</span><span class='const'>Book</span><span class='period'>.</span><span class='id identifier rubyid_take'>take</span><span class='period'>.</span><span class='id identifier rubyid_author'>author</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='comment'>## =&gt; ExternalDB::Author
214
+ </span></code></pre>
215
+ <hr>
216
+
217
+ <p><a
218
+ href="http://nestor-custodio.github.io/automodel-sqlserver/top-level-namespace.html#automodel-instance_method">Consult
219
+ the repo docs for the full automodel-sqlserver documentation.</a></p>
220
+
221
+ <h2 id="label-FAQs">FAQs</h2>
222
+ <ul><li>
223
+ <h5 id="label-Do+I+have+to+add+anything+to+my+Gemfile+besides+-27automodel-sqlserver-27-3F">Do I have to add anything to my Gemfile besides <code>&#39;automodel-sqlserver&#39;</code>?</h5>
224
+
225
+ <p>Due to the nature of this version of the gem, it is assumed you will want
226
+ to connect to a SQL Server database, so both <strong><a
227
+ href="https://github.com/rails-sqlserver/activerecord-sqlserver-adapter">activerecord-sqlserver-adapter</a></strong>
228
+ and the <strong><a
229
+ href="https://github.com/rails-sqlserver/tiny_tds">tiny_tds</a></strong>
230
+ gems are included as dependencies (meaning you don&#39;t have to worry
231
+ about them). Note that these gems alone are not sufficient to connect to a
232
+ SQL Server instance, however: <strong>you still need to <a
233
+ href="https://github.com/rails-sqlserver/tiny_tds#install">install FreeTDS
234
+ on your system</a> if you haven&#39;t already</strong>.</p>
235
+ </li></ul>
236
+
237
+ <p>SQL Server aside, you will need to add the corresponding gems if you want
238
+ to use connection adapters that are not yet part of your gemset. (e.g.
239
+ Don&#39;t expect to be able to connect to a MySQL database without having
240
+ added <code>&#39;mysql2&#39;</code> to your Gemfile.)</p>
241
+ <ul><li>
242
+ <h5 id="label-But+what+about+my+application-27s+own+models-3F">But what about my application&#39;s own models?</h5>
243
+
244
+ <p>You can call <code>automodel</code> <strong>and</strong> continue to use
245
+ your application&#39;s own models without changing a single line of code.</p>
246
+ </li><li>
247
+ <h5 id="label-Can+I+Automodel+more+than+one+database-3F">Can I Automodel more than one database?</h5>
248
+
249
+ <p>Yes! You can Automodel as many databases with as many different adapters
250
+ as you like. <strong>automodel-sqlserver</strong> takes care of connecting
251
+ to the various databases and managing their connection pools for you.</p>
252
+ </li><li>
253
+ <h5 id="label-What+about+model+name+collisions-3F">What about model name collisions?</h5>
254
+
255
+ <p>If an <code>automodel</code> call will result in a class name collision,
256
+ an Automodel::NameCollisionError is raised <em>before</em> any classes are
257
+ clobbered.</p>
258
+ </li><li>
259
+ <h5 id="label-What+if+I+want+custom+methods+for+certain+models-3F">What if I want custom methods for certain models?</h5>
260
+
261
+ <p>You can either monkey-patch your methods onto the applicable
262
+ Automodel-generated classes once they&#39;ve been defined, or you can
263
+ monkey-patch the method onto the connection handler class returned by the
264
+ <code>automodel</code> call itself, which will make it available for all
265
+ models generated <em>by that call</em>.</p>
266
+ </li><li>
267
+ <h5 id="label-What+if+I-27m+using+ActiveRecord+but+not+Rails-3F">What if I&#39;m using ActiveRecord but not Rails?</h5>
268
+
269
+ <p>That&#39;s no problem at all! The <strong>automodel-sqlserver</strong> gem
270
+ depends on ActiveRecord – not Rails. Adding
271
+ <code>&#39;automodel-sqlserver&#39;</code> to your Gemfile (along with any
272
+ relevant connection adapters, of course) is all you need to make use of the
273
+ tool in your vanilla-Ruby project. Just be mindful that – since
274
+ “config/database.yml” isn&#39;t available (as you&#39;re not using Rails) –
275
+ you&#39;ll always need to pass in a full connection spec to your
276
+ <code>automodel</code> calls (as in the very first example, under
277
+ <em>“Connecting To The External Database”</em> above).</p>
278
+ </li></ul>
279
+
280
+ <h2 id="label-Feature+Roadmap+-2F+Future+Development">Feature Roadmap / Future Development</h2>
281
+
282
+ <p>Additional features/options coming in the future:</p>
283
+ <ul><li>
284
+ <p><strong>Naming</strong>: Better generation of Railsy names for
285
+ <code>:date</code>/<code>:datetime</code> column types.</p>
286
+ </li><li>
287
+ <p><strong>Reads</strong>: Support for <code>#find</code> on tables with
288
+ composite primary keys.</p>
289
+ </li><li>
290
+ <p><strong>Writes</strong>: Better handling of missing
291
+ <code>created_at</code>/<code>updated_at</code> columns on record
292
+ creation/updates.</p>
293
+ </li><li>
294
+ <p><strong>Traversal</strong>: Support for <code>has_many</code> relations
295
+ (only <code>belongs_to</code> is currently supported).</p>
296
+ </li><li>
297
+ <p><strong>Traversal</strong>: Support for self-referential foreign keys.</p>
298
+ </li><li>
299
+ <p><strong>Traversal</strong>: Support for multiple relations to the same
300
+ target model.</p>
301
+ </li></ul>
302
+
303
+ <h2 id="label-Contribution+-2F+Development">Contribution / Development</h2>
304
+
305
+ <p>Bug reports and pull requests are welcome on GitHub at <a
306
+ href="https://github.com/nestor-custodio/automodel-sqlserver">github.com/nestor-custodio/automodel-sqlserver</a>.</p>
307
+
308
+ <p>After checking out the repo, run <code>bin/setup</code> to install
309
+ dependencies. Then, run <code>rake spec</code> to run the tests. You can
310
+ also run <code>bin/console</code> for an interactive prompt that will allow
311
+ you to experiment.</p>
312
+
313
+ <p>Linting is courtesy of <a
314
+ href="https://github.com/bbatsov/rubocop">Rubocop</a> and documentation is
315
+ built using <a href="https://yardoc.org/">Yard</a>. Neither is included in
316
+ the Gemspec; you&#39;ll need to install these locally (<code>gem install
317
+ rubocop yard</code>) to take advantage.</p>
318
+
319
+ <h2 id="label-License">License</h2>
320
+
321
+ <p>The gem is available as open source under the terms of the <a
322
+ href="https://opensource.org/licenses/MIT">MIT License</a>.</p>
323
+ </div></div>
324
+
325
+ <div id="footer">
326
+ Generated on Wed Jun 20 18:16:10 2018 by
327
+ <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
328
+ 0.9.14 (ruby-2.4.4).
329
+ </div>
330
+
331
+ </div>
332
+ </body>
333
+ </html>
data/docs/file_list.html ADDED
@@ -0,0 +1,56 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
5
+ <meta charset="utf-8" />
6
+
7
+ <link rel="stylesheet" href="css/full_list.css" type="text/css" media="screen" charset="utf-8" />
8
+
9
+ <link rel="stylesheet" href="css/common.css" type="text/css" media="screen" charset="utf-8" />
10
+
11
+
12
+
13
+ <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
14
+
15
+ <script type="text/javascript" charset="utf-8" src="js/full_list.js"></script>
16
+
17
+
18
+ <title>File List</title>
19
+ <base id="base_target" target="_parent" />
20
+ </head>
21
+ <body>
22
+ <div id="content">
23
+ <div class="fixed_header">
24
+ <h1 id="full_list_header">File List</h1>
25
+ <div id="full_list_nav">
26
+
27
+ <span><a target="_self" href="class_list.html">
28
+ Classes
29
+ </a></span>
30
+
31
+ <span><a target="_self" href="method_list.html">
32
+ Methods
33
+ </a></span>
34
+
35
+ <span><a target="_self" href="file_list.html">
36
+ Files
37
+ </a></span>
38
+
39
+ </div>
40
+
41
+ <div id="search">Search: <input type="text" /></div>
42
+ </div>
43
+
44
+ <ul id="full_list" class="file">
45
+
46
+
47
+ <li id="object_README" class="odd">
48
+ <div class="item"><span class="object_link"><a href="index.html" title="README">README</a></span></div>
49
+ </li>
50
+
51
+
52
+
53
+ </ul>
54
+ </div>
55
+ </body>
56
+ </html>
data/docs/frames.html ADDED
@@ -0,0 +1,17 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta charset="utf-8">
5
+ <title>Documentation by YARD 0.9.14</title>
6
+ </head>
7
+ <script type="text/javascript" charset="utf-8">
8
+ var match = unescape(window.location.hash).match(/^#!(.+)/);
9
+ var name = match ? match[1] : 'index.html';
10
+ name = name.replace(/^(\w+):\/\//, '').replace(/^\/\//, '');
11
+ window.top.location = name;
12
+ </script>
13
+ <noscript>
14
+ <h1>Oops!</h1>
15
+ <h2>YARD requires JavaScript!</h2>
16
+ </noscript>
17
+ </html>
data/docs/index.html ADDED
@@ -0,0 +1,333 @@
1
+ <!DOCTYPE html>
2
+ <html>
3
+ <head>
4
+ <meta charset="UTF-8">
5
+ <meta name="viewport" content="width=device-width, initial-scale=1.0">
6
+ <title>
7
+ File: README
8
+
9
+ &mdash; Documentation by YARD 0.9.14
10
+
11
+ </title>
12
+
13
+ <link rel="stylesheet" href="css/style.css" type="text/css" charset="utf-8" />
14
+
15
+ <link rel="stylesheet" href="css/common.css" type="text/css" charset="utf-8" />
16
+
17
+ <script type="text/javascript" charset="utf-8">
18
+ pathId = "README";
19
+ relpath = '';
20
+ </script>
21
+
22
+
23
+ <script type="text/javascript" charset="utf-8" src="js/jquery.js"></script>
24
+
25
+ <script type="text/javascript" charset="utf-8" src="js/app.js"></script>
26
+
27
+
28
+ </head>
29
+ <body>
30
+ <div class="nav_wrap">
31
+ <iframe id="nav" src="class_list.html?1"></iframe>
32
+ <div id="resizer"></div>
33
+ </div>
34
+
35
+ <div id="main" tabindex="-1">
36
+ <div id="header">
37
+ <div id="menu">
38
+
39
+ <a href="_index.html">Index</a> &raquo;
40
+ <span class="title">File: README</span>
41
+
42
+ </div>
43
+
44
+ <div id="search">
45
+
46
+ <a class="full_list_link" id="class_list_link"
47
+ href="class_list.html">
48
+
49
+ <svg width="24" height="24">
50
+ <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
51
+ <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
52
+ <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
53
+ </svg>
54
+ </a>
55
+
56
+ </div>
57
+ <div class="clear"></div>
58
+ </div>
59
+
60
+ <div id="content"><div id='filecontents'>
61
+ <h1 id="label-automodel-sqlserver+rdoc-image-3Ahttps-3A-2F-2Fbadge.fury.io-2Frb-2Fautomodel-sqlserver.svg">automodel-sqlserver <a href="https://badge.fury.io/rb/automodel-sqlserver"><img src="https://badge.fury.io/rb/automodel-sqlserver.svg"></a></h1>
62
+
63
+ <p>Connecting your Rails application to a database created outside of the
64
+ Rails environment usually means either spending hours writing up class
65
+ files for every table, or giving up on using the ActiveRecord query DSL and
66
+ resigning yourself to building SQL strings and making
67
+ <code>execute</code>/<code>exec_query</code> calls.</p>
68
+
69
+ <p>Are those SQL strings you&#39;re building even injection-safe? Hmm… 😟</p>
70
+
71
+ <p><em>With a single command</em>, <strong>automodel-sqlserver</strong> lets
72
+ you connect to any database and access all of its tables via the
73
+ ActiveRecord DSL you&#39;ve grown to love!</p>
74
+
75
+ <p>It does this by analyzing the table structures and: - automatically
76
+ defining all of the corresponding model classes - declaring column aliases
77
+ so you can use Railsy names an idioms - constructing model relations based
78
+ on foreign key definitions</p>
79
+
80
+ <h2 id="label-Installation">Installation</h2>
81
+
82
+ <p>Add this line to your application&#39;s Gemfile:</p>
83
+
84
+ <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_gem'>gem</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>automodel-sqlserver</span><span class='tstring_end'>&#39;</span></span>
85
+ </code></pre>
86
+
87
+ <p>And then execute:</p>
88
+
89
+ <pre class="code ruby"><code class="ruby">$ bundle</code></pre>
90
+
91
+ <p>Or install it yourself as:</p>
92
+
93
+ <pre class="code ruby"><code class="ruby">$ gem install automodel-sqlserver</code></pre>
94
+
95
+ <h4 id="label-Additional+Dependencies">Additional Dependencies</h4>
96
+
97
+ <p>If you are running on Windows and <strong>not</strong> using RubyInstaller,
98
+ the above steps are all that is needed.</p>
99
+
100
+ <p>On all other platforms, this gem (and its dependencies) alone are not
101
+ sufficient to connect to a SQL Server instance: <strong>you will also need
102
+ to <a href="https://github.com/rails-sqlserver/tiny_tds#install">install
103
+ FreeTDS on your system</a> if you haven&#39;t already</strong>.</p>
104
+
105
+ <h2 id="label-Using+Automodel">Using Automodel</h2>
106
+
107
+ <p>The following examples all assume a Postgres database with the following
108
+ tables: “`sql – Create Table: Authors CREATE TABLE public.“Authors” (
109
+ “Author ID” serial NOT NULL , “Name” varchar NOT NULL DEFAULT &#39;&#39;,
110
+ “Birthday” date NULL , “Address” varchar NOT NULL DEFAULT &#39;&#39;,</p>
111
+
112
+ <p>CONSTRAINT authors__pk PRIMARY KEY (“Author ID”) ) WITH ( OIDS=FALSE );</p>
113
+
114
+ <p>– Create Table: Publishers CREATE TABLE public.“Publishers” ( “Publisher
115
+ ID” serial NOT NULL , “Name” varchar NOT NULL DEFAULT &#39;&#39;,
116
+ “Address” varchar NOT NULL DEFAULT &#39;&#39;, “Website” varchar NOT NULL
117
+ DEFAULT &#39;&#39;,</p>
118
+
119
+ <p>CONSTRAINT publishers__pk PRIMARY KEY (“Publisher ID”) ) WITH ( OIDS=FALSE
120
+ );</p>
121
+
122
+ <p>– Create Table: Books CREATE TABLE public.“Books” ( “Book ID” serial NOT
123
+ NULL , “Title” varchar NOT NULL DEFAULT &#39;&#39; , “Edition” int NOT
124
+ NULL DEFAULT 1 , “ISBN Number” varchar NOT NULL DEFAULT &#39;&#39; ,
125
+ “Published On” date NOT NULL , “Is Out Of Print” bool NOT NULL DEFAULT
126
+ FALSE, “Author ID” bigint NOT NULL , “Publisher ID” bigint NOT NULL ,</p>
127
+
128
+ <p>CONSTRAINT books__pk PRIMARY KEY (“Book ID”),</p>
129
+
130
+ <p>CONSTRAINT books_authors_fk FOREIGN KEY (“Author ID”) REFERENCES
131
+ public.“Authors”(“Author ID”),</p>
132
+
133
+ <p>CONSTRAINT books_publishers_fk FOREIGN KEY (“Publisher ID”) REFERENCES
134
+ public.“Publishers”(“Publisher ID”) ) WITH ( OIDS=FALSE ); “`</p>
135
+ <hr>
136
+
137
+ <h4 id="label-Connecting+To+The+External+Database">Connecting To The External Database</h4>
138
+
139
+ <p>You can provide the connection spec inline …</p>
140
+
141
+ <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_automodel'><span class='object_link'><a href="top-level-namespace.html#automodel-instance_method" title="#automodel (method)">automodel</a></span></span> <span class='label'>adapter:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>postgresql</span><span class='tstring_end'>&#39;</span></span> <span class='comma'>,</span>
142
+ <span class='label'>encoding:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>unicode</span><span class='tstring_end'>&#39;</span></span> <span class='comma'>,</span>
143
+ <span class='label'>host:</span> <span class='id identifier rubyid_hostname'>hostname</span> <span class='comma'>,</span>
144
+ <span class='label'>port:</span> <span class='id identifier rubyid_port_number'>port_number</span> <span class='comma'>,</span>
145
+ <span class='label'>username:</span> <span class='id identifier rubyid_username'>username</span> <span class='comma'>,</span>
146
+ <span class='label'>password:</span> <span class='id identifier rubyid_password'>password</span> <span class='comma'>,</span>
147
+ <span class='label'>database:</span> <span class='id identifier rubyid_database_name'>database_name</span>
148
+ </code></pre>
149
+
150
+ <p>… or you can use a connection spec defined in “config/database.yml” …</p>
151
+
152
+ <pre class="code ruby"><code class="ruby">## In &quot;database.yml&quot; ...
153
+
154
+ ## ... (your application&#39;s own db connection stuff) ...
155
+
156
+
157
+ external_db:
158
+ adapter: postgresql
159
+ pool: &lt;%= ENV.fetch(&#39;RAILS_MAX_THREADS&#39;) { 5 } %&gt;
160
+ timeouts: 5000
161
+ encoding: unicode
162
+ host: name_or_ip
163
+ port: port_number
164
+ username: username
165
+ password: password
166
+ database: sample_db</code></pre>
167
+
168
+ <pre class="code ruby"><code class="ruby"><span class='comment'>## In &quot;config/puma.rb&quot; or &quot;config/unicorn.rb&quot; ...
169
+ </span>
170
+ <span class='id identifier rubyid_automodel'><span class='object_link'><a href="top-level-namespace.html#automodel-instance_method" title="#automodel (method)">automodel</a></span></span> <span class='symbol'>:external_db</span>
171
+ </code></pre>
172
+ <hr>
173
+
174
+ <h4 id="label-Using+The+Automodel-27ed+Objects">Using The Automodel&#39;ed Objects</h4>
175
+
176
+ <p>Connecting via either method above will allow you to issue all of the
177
+ following expressions, just as if these were your own models:</p>
178
+
179
+ <pre class="code ruby"><code class="ruby"><span class='comment'>## ISBNs for all non-first-edition books.
180
+ </span><span class='id identifier rubyid_isbn_list'>isbn_list</span> <span class='op'>=</span> <span class='const'>Book</span><span class='period'>.</span><span class='id identifier rubyid_where'>where</span><span class='period'>.</span><span class='id identifier rubyid_not'>not</span><span class='lparen'>(</span><span class='label'>edition:</span> <span class='int'>1</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_pluck'>pluck</span><span class='lparen'>(</span><span class='symbol'>:isbn_number</span><span class='rparen'>)</span>
181
+
182
+ <span class='comment'>## Take any book and look up some values.
183
+ </span><span class='id identifier rubyid_book'>book</span> <span class='op'>=</span> <span class='const'>Book</span><span class='period'>.</span><span class='id identifier rubyid_take'>take</span>
184
+ <span class='id identifier rubyid_book'>book</span><span class='period'>.</span><span class='id identifier rubyid_title'>title</span>
185
+ <span class='id identifier rubyid_book'>book</span><span class='period'>.</span><span class='id identifier rubyid_out_of_print?'>out_of_print?</span>
186
+ <span class='id identifier rubyid_book'>book</span><span class='period'>.</span><span class='id identifier rubyid_publisher'>publisher</span><span class='period'>.</span><span class='id identifier rubyid_name'>name</span>
187
+
188
+
189
+ <span class='comment'>## Note that some ActiveRecord constructs surface real table names,
190
+ </span><span class='comment'>## which can look awkward in code when working with tables with non-Railsy names:
191
+ </span><span class='comment'>## (the uppercase &quot;P&quot; in &quot;Publishers&quot; below makes it look like a class reference)
192
+ </span><span class='const'>Book</span><span class='period'>.</span><span class='id identifier rubyid_joins'>joins</span><span class='lparen'>(</span><span class='symbol'>:Publishers</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_where'>where</span><span class='lparen'>(</span><span class='label'>Publishers:</span> <span class='lbrace'>{</span> <span class='label'>name:</span> <span class='id identifier rubyid_test_value'>test_value</span> <span class='rbrace'>}</span><span class='rparen'>)</span><span class='period'>.</span><span class='id identifier rubyid_all'>all</span>
193
+ </code></pre>
194
+ <hr>
195
+
196
+ <h4 id="label-Automodel+With+Namespacing">Automodel With Namespacing</h4>
197
+
198
+ <p>If you&#39;re worried about model name collisions (or just want to keep the
199
+ global namespace tidy), Automodel can define all of the new model classes
200
+ under a module.</p>
201
+
202
+ <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_automodel'><span class='object_link'><a href="top-level-namespace.html#automodel-instance_method" title="#automodel (method)">automodel</a></span></span> <span class='label'>adapter:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>postgresql</span><span class='tstring_end'>&#39;</span></span> <span class='comma'>,</span>
203
+ <span class='label'>encoding:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>unicode</span><span class='tstring_end'>&#39;</span></span> <span class='comma'>,</span>
204
+ <span class='label'>host:</span> <span class='id identifier rubyid_hostname'>hostname</span> <span class='comma'>,</span>
205
+ <span class='label'>port:</span> <span class='id identifier rubyid_port_number'>port_number</span> <span class='comma'>,</span>
206
+ <span class='label'>username:</span> <span class='id identifier rubyid_username'>username</span> <span class='comma'>,</span>
207
+ <span class='label'>password:</span> <span class='id identifier rubyid_password'>password</span> <span class='comma'>,</span>
208
+ <span class='label'>database:</span> <span class='id identifier rubyid_database_name'>database_name</span><span class='comma'>,</span>
209
+ <span class='label'>namespace:</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>ExternalDB</span><span class='tstring_end'>&#39;</span></span>
210
+
211
+ <span class='comment'>## Now you can do everything you&#39;d expect, but the models are namespaced under ExternalDB.
212
+ </span><span class='const'>ExternalDB</span><span class='op'>::</span><span class='const'>Book</span><span class='period'>.</span><span class='id identifier rubyid_find'>find</span><span class='lparen'>(</span><span class='int'>5</span><span class='rparen'>)</span> <span class='comment'>## =&gt; Book #5
213
+ </span><span class='const'>ExternalDB</span><span class='op'>::</span><span class='const'>Book</span><span class='period'>.</span><span class='id identifier rubyid_take'>take</span><span class='period'>.</span><span class='id identifier rubyid_author'>author</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span> <span class='comment'>## =&gt; ExternalDB::Author
214
+ </span></code></pre>
215
+ <hr>
216
+
217
+ <p><a
218
+ href="http://nestor-custodio.github.io/automodel-sqlserver/top-level-namespace.html#automodel-instance_method">Consult
219
+ the repo docs for the full automodel-sqlserver documentation.</a></p>
220
+
221
+ <h2 id="label-FAQs">FAQs</h2>
222
+ <ul><li>
223
+ <h5 id="label-Do+I+have+to+add+anything+to+my+Gemfile+besides+-27automodel-sqlserver-27-3F">Do I have to add anything to my Gemfile besides <code>&#39;automodel-sqlserver&#39;</code>?</h5>
224
+
225
+ <p>Due to the nature of this version of the gem, it is assumed you will want
226
+ to connect to a SQL Server database, so both <strong><a
227
+ href="https://github.com/rails-sqlserver/activerecord-sqlserver-adapter">activerecord-sqlserver-adapter</a></strong>
228
+ and the <strong><a
229
+ href="https://github.com/rails-sqlserver/tiny_tds">tiny_tds</a></strong>
230
+ gems are included as dependencies (meaning you don&#39;t have to worry
231
+ about them). Note that these gems alone are not sufficient to connect to a
232
+ SQL Server instance, however: <strong>you still need to <a
233
+ href="https://github.com/rails-sqlserver/tiny_tds#install">install FreeTDS
234
+ on your system</a> if you haven&#39;t already</strong>.</p>
235
+ </li></ul>
236
+
237
+ <p>SQL Server aside, you will need to add the corresponding gems if you want
238
+ to use connection adapters that are not yet part of your gemset. (e.g.
239
+ Don&#39;t expect to be able to connect to a MySQL database without having
240
+ added <code>&#39;mysql2&#39;</code> to your Gemfile.)</p>
241
+ <ul><li>
242
+ <h5 id="label-But+what+about+my+application-27s+own+models-3F">But what about my application&#39;s own models?</h5>
243
+
244
+ <p>You can call <code>automodel</code> <strong>and</strong> continue to use
245
+ your application&#39;s own models without changing a single line of code.</p>
246
+ </li><li>
247
+ <h5 id="label-Can+I+Automodel+more+than+one+database-3F">Can I Automodel more than one database?</h5>
248
+
249
+ <p>Yes! You can Automodel as many databases with as many different adapters
250
+ as you like. <strong>automodel-sqlserver</strong> takes care of connecting
251
+ to the various databases and managing their connection pools for you.</p>
252
+ </li><li>
253
+ <h5 id="label-What+about+model+name+collisions-3F">What about model name collisions?</h5>
254
+
255
+ <p>If an <code>automodel</code> call will result in a class name collision,
256
+ an Automodel::NameCollisionError is raised <em>before</em> any classes are
257
+ clobbered.</p>
258
+ </li><li>
259
+ <h5 id="label-What+if+I+want+custom+methods+for+certain+models-3F">What if I want custom methods for certain models?</h5>
260
+
261
+ <p>You can either monkey-patch your methods onto the applicable
262
+ Automodel-generated classes once they&#39;ve been defined, or you can
263
+ monkey-patch the method onto the connection handler class returned by the
264
+ <code>automodel</code> call itself, which will make it available for all
265
+ models generated <em>by that call</em>.</p>
266
+ </li><li>
267
+ <h5 id="label-What+if+I-27m+using+ActiveRecord+but+not+Rails-3F">What if I&#39;m using ActiveRecord but not Rails?</h5>
268
+
269
+ <p>That&#39;s no problem at all! The <strong>automodel-sqlserver</strong> gem
270
+ depends on ActiveRecord – not Rails. Adding
271
+ <code>&#39;automodel-sqlserver&#39;</code> to your Gemfile (along with any
272
+ relevant connection adapters, of course) is all you need to make use of the
273
+ tool in your vanilla-Ruby project. Just be mindful that – since
274
+ “config/database.yml” isn&#39;t available (as you&#39;re not using Rails) –
275
+ you&#39;ll always need to pass in a full connection spec to your
276
+ <code>automodel</code> calls (as in the very first example, under
277
+ <em>“Connecting To The External Database”</em> above).</p>
278
+ </li></ul>
279
+
280
+ <h2 id="label-Feature+Roadmap+-2F+Future+Development">Feature Roadmap / Future Development</h2>
281
+
282
+ <p>Additional features/options coming in the future:</p>
283
+ <ul><li>
284
+ <p><strong>Naming</strong>: Better generation of Railsy names for
285
+ <code>:date</code>/<code>:datetime</code> column types.</p>
286
+ </li><li>
287
+ <p><strong>Reads</strong>: Support for <code>#find</code> on tables with
288
+ composite primary keys.</p>
289
+ </li><li>
290
+ <p><strong>Writes</strong>: Better handling of missing
291
+ <code>created_at</code>/<code>updated_at</code> columns on record
292
+ creation/updates.</p>
293
+ </li><li>
294
+ <p><strong>Traversal</strong>: Support for <code>has_many</code> relations
295
+ (only <code>belongs_to</code> is currently supported).</p>
296
+ </li><li>
297
+ <p><strong>Traversal</strong>: Support for self-referential foreign keys.</p>
298
+ </li><li>
299
+ <p><strong>Traversal</strong>: Support for multiple relations to the same
300
+ target model.</p>
301
+ </li></ul>
302
+
303
+ <h2 id="label-Contribution+-2F+Development">Contribution / Development</h2>
304
+
305
+ <p>Bug reports and pull requests are welcome on GitHub at <a
306
+ href="https://github.com/nestor-custodio/automodel-sqlserver">github.com/nestor-custodio/automodel-sqlserver</a>.</p>
307
+
308
+ <p>After checking out the repo, run <code>bin/setup</code> to install
309
+ dependencies. Then, run <code>rake spec</code> to run the tests. You can
310
+ also run <code>bin/console</code> for an interactive prompt that will allow
311
+ you to experiment.</p>
312
+
313
+ <p>Linting is courtesy of <a
314
+ href="https://github.com/bbatsov/rubocop">Rubocop</a> and documentation is
315
+ built using <a href="https://yardoc.org/">Yard</a>. Neither is included in
316
+ the Gemspec; you&#39;ll need to install these locally (<code>gem install
317
+ rubocop yard</code>) to take advantage.</p>
318
+
319
+ <h2 id="label-License">License</h2>
320
+
321
+ <p>The gem is available as open source under the terms of the <a
322
+ href="https://opensource.org/licenses/MIT">MIT License</a>.</p>
323
+ </div></div>
324
+
325
+ <div id="footer">
326
+ Generated on Wed Jun 20 18:16:08 2018 by
327
+ <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
328
+ 0.9.14 (ruby-2.4.4).
329
+ </div>
330
+
331
+ </div>
332
+ </body>
333
+ </html>