Ruby Learning Resources [WikiLists]

DanRathbun · March 28, 2018, 8:37pm

All seven of the lists below are set as wikis.

INDEX

This thread is always a work in progress.

DanRathbun · October 6, 2019, 7:59pm

PRIMERS & GUIDES

(A list of primers and introductory guides for learning Ruby.)

About Ruby
by ruby-lang.org
37 Reasons to Love Ruby
by Hal Fulton, RubyHacker.com, author of “The Ruby Way”.
Ruby in Twenty Minutes, pgs 4
by ruby-lang.org
Ruby Users Guide
by Mark Slagell, Iowa State University of Science and Technology
Ruby From Other [Programming] Languages
by ruby-lang.org
Introduction to Ruby
by ruby-lang.org

Ruby Language Primers for v 2.0.0 - SketchUp 2014 ... 2016

Primer Index
- Keywords (*v1.9)
  - “using” keyword added in v2.0 (see Refinements.)
- Global Variables
- Regular Expressions
- Security
- Syntax
Ruby Standard Library Overview

Ruby Language Primers for v 2.2.4 - SketchUp 2017 & 2018

Ruby Language Primers for v 2.5.1 - SketchUp 2019.0 & 2019.1

Ruby Language Primers for v 2.5.5 - SketchUp 2019.2+

DanRathbun · August 8, 2019, 7:00am

BOOKS

(A list of full books for learning Ruby.)

~ Ruby Generic ~

( DOWNLOADABLE )

“I Love Ruby” (latest edition)
by A.K. Karthikeyan
Link is at the bottom of the examples README, for the current dropbox location:
https://github.com/mindaslab/ilrx/blob/master/README.md
“I Love Ruby” (2016-3-14 edition)
by A.K. Karthikeyan
** PDF
I_Love_Ruby_2016-3-14.pdf (2.1 MB)
(Posted here under the terms of the GNU Free Documentation License, Version 1.3, see pg 5.)
“I Love Ruby” (2015 Beta edition - with belly dancer cover)
by A.K. Karthikeyan
** PDF
I_Love_Ruby_2015.pdf (2.3 MB)
(Posted here under the terms of the GNU Free Documentation License, Version 1.3, see pg 5.)
“I Love Ruby Examples”
Git repository of all the Ruby script examples in the “I Love Ruby” book(s).
by A.K. Karthikeyan
https://github.com/mindaslab/ilrx
“Programming Ruby - The Pragmatic Programmer’s Guide (1st Edition)”
( Written for Ruby v 1.6 )
By Dave Thomas and Andy Hunt
Copyright © 2000, Addison Wesley Longman, Inc.
Released under the terms of the Open Publication License V1.0.
MS Windows CHM (Compiled Help Markup) file:
ProgrammingRuby_1stEd.zip (744.3 KB)
“The Book of Ruby”
by Huw Collingbourne
** PDF
http://www.sapphiresteel.com/IMG/zip/book-of-ruby.zip
“The Little Book of Ruby”
by Huw Collingbourne
** PDF
http://www.sapphiresteel.com/IMG/pdf/LittleBookOfRuby.pdf
“Mr. Neighborly’s Humble Little Ruby Book”
by Jeremy McAnally
** PDF
http://www.humblelittlerubybook.com/book/hlrb.pdf
“Ruby Best Practices”
by Gregory T. Brown
** PDF
http://www.mathieu.gagnon.name/random/rbp_1-0.pdf
“Extending Ruby 1.9: Writing Extensions in C”
by Dave Thomas
** PDF
https://media.pragprog.com/titles/ruby3/ext_ruby.pdf

( ONLINE )

“Programming Ruby - The Pragmatic Programmer’s Guide (1st Edition)”
( Written for Ruby v 1.6 )
By Dave Thomas and Andy Hunt
Copyright © 2000, Addison Wesley Longman, Inc.
phrogz.net (framed)
ruby-doc.com (framed)
“Ruby Essentials”
by Technotopia.com
Copyright © 2012 Neil Smyth / Payload Media.
http://www.techotopia.com/index.php/Ruby_Essentials
both free online and paid (8.99) PDF or eBook editions
“Ruby Programming” - Wikibook
http://en.wikibooks.org/wiki/Ruby_programming_language
"Ruby (programming language)" - History, Philosophy and Overview - Wikimanuals
https://en.m.wikipedia.org/wiki/Ruby_(programming_language)
“The Bastards Book of Ruby”
by Dan Nguyen, Stanford Univ. Computational Journalism Lab
http://ruby.bastardsbook.com/
“Ruby Hacking Guide”
The original work is Copyright © 2002 - 2004 Minero AOKI.
Translated by Vincent ISAMBART and Clifford Escobar CAOILE
under the Creative Commons Attribution-NonCommercial-ShareAlike2.5 License
https://ruby-hacking-guide.github.io/

( PRINTED )

“Learn to Program, (2nd Edition)”
by Chris Pine
(expanded from the original tutorial)
http://www.pragprog.com/titles/ltp2/learn-to-program-2nd-edition
“The Ruby Programming Language”
( Written for Ruby v 1.8, and updated for v 1.9 )
By David Flanagan and Yukihiro Matsumoto (the inventor of Ruby)
© “O’Reilly Media, Inc.”, Jan 25, 2008 - Computers - (English) 448 pages
https://books.google.com/books?id=jcUbTcr5XWwC&source=gbs_navlinks_s
“Programming Ruby - The Pragmatic Programmer’s Guide (2nd Edition)”
( Written for Ruby v 1.8 )
By Dave Thomas, with Chad Fowler and Andy Hunt
Copyright © 2004,2005,The Pragmatic Programmers, LLC.
https://pragprog.com/titles/ruby/programming-ruby
“Programming Ruby - The Pragmatic Programmer’s Guide (3rd Edition)”
( Written for Ruby v 1.9 )
By Dave Thomas, with Chad Fowler and Andy Hunt
Copyright © 2009, The Pragmatic Programmers, LLC.
https://pragprog.com/book/ruby3/programming-ruby (out-of -print)
“Programming Ruby - The Pragmatic Programmer’s Guide (4th Edition)”
( Written for Ruby v 1.9, and updated for v 2.0 )
By Dave Thomas, with Chad Fowler and Andy Hunt
© The Pragmatic Programmers, LLC., June 2013 - (English) 863 pages
https://pragprog.com/book/ruby4/programming-ruby-1-9-2-0

~ SketchUp Specific ~

( DOWNLOADABLE )

“Automatic SketchUp”
by Matthew Scarpino, Eclipse Engineering LLC
2010
- from Google Drive
- from Ruby Library Depot

( ONLINE )

( PRINTED )

“Construction Documents using SketchUp Pro & LayOut::
Replace traditional CAD with a new generation of 3D software (SketchUp2BIM) (Volume 1)”
by Mr. Paul James Lee
© 2013
http://www.amazon.com/Construction-Documents-using-SketchUp-LayOut/dp/1480099015
(NOTE: this is not about Ruby SketchUp programming. TODO: Move to a general book list.)

DanRathbun · July 9, 2020, 10:58am

TUTORIALS

(A list of tutorials for learning Ruby.)

~ Ruby Generic ~

“Learning Ruby”
by Daniel Carrera, San Diego State University
(online) http://www-rohan.sdsu.edu/doc/ruby/index.html
(download tarball) http://www-rohan.sdsu.edu/doc/ruby/learning-ruby.tar.gz
“Learn to Program, 1st Ed.”
by Chris Pine
© 2003-2016, Chris Pine
(online) http://pine.fm/LearnToProgram/
“Ruby Study Notes”
by Satish Talim
(online) http://rubylearning.com/satishtalim/tutorial.html
“Ruby Tutorial”
tutorialspoint.com
http://www.tutorialspoint.com/ruby/index.htm
“Introduction to Ruby” - 2 sections, 10 pg. (sec. III is not done.)
<< “Learning Ruby” by Daniel Carrera, replaces ruby-lang’s “Introduction to Ruby” >>
by ruby-lang.org
http://ruby-doc.org/docs/Tutorial/

VIDEO COURSES
- Ruby in 4 Hours (No Ads)
  https://www.youtube.com/watch?v=t_ispmWmdjY

~ SketchUp Specific ~

Ruby Tutorials at SketchUcation Forums
http://sketchucation.com/forums/viewtopic.php?f=18&t=8767#p52665

“Edges to Rubies” is Outdated and No Longer Recommended !

Too many errors and poor programming practices promoted.

Edges to Rubies - The Complete SketchUp Tutorial
by Martin Rinehart
http://www.martinrinehart.com/models/tutorial/

DanRathbun · October 6, 2019, 7:54pm

REFERENCE

(A list of technical references for Ruby.)

~ Ruby Generic ~

Ruby Keywords
Ruby QuickRef
by Ryan Davis
http://www.zenspider.com/Languages/Ruby/QuickRef.html
Ruby CookBook
by Ryan Davis
http://www.zenspider.com/Languages/Ruby/Cookbook/
Ruby-Doc Language Reference
- Core Documentation
  http://www.ruby-doc.org/core-2.5.5/index.html
- Standard Library
  www.ruby-doc.org/stdlib-2.5.5/index.html
- Ruby Issue Tracking
  https://bugs.ruby-lang.org/
- Ruby Versioning Policy
  https://bugs.ruby-lang.org/projects/ruby/wiki/ReleaseEngineering
Management of Side-By-Side System Ruby Installs
- uru (Unleash RUby)
  SIMPLE Multi-Platform Command line tool
  https://bitbucket.org/jonforums/uru
- RVM (Ruby enVironment Manager)
  COMPLEX OSX, *nix Command line tool
  https://github.com/rvm/rvm#rvm
RubyGems
- User Guide
  http://rubygems.org/read/chapter/1
- Manuals
  http://docs.rubygems.org/
Documentation Generators
- RDoc Documentation
  http://rdoc.rubyforge.org/
- YARD
  - Features
    http://yardoc.org/features.html
  - Documentation
    http://www.rubydoc.info/gems/yard/file/README.md
  - Code Repository
    https://github.com/lsegal/yard
  - Customizing YARD Templates
    http://gnuu.org/2009/11/18/customizing-yard-templates/

~ SketchUp Specific ~

SketchUp Ruby API Cheatsheet
by Alex Schreyer
http://www.alexschreyer.net/cad/sketchup-ruby-api-cheatsheet/
SketchUp Ruby API Reference
new: http://ruby.sketchup.com/
old: http://www.sketchup.com/intl/en/developer/index
SketchUp Ruby API - Class Index
new: http://ruby.sketchup.com/class_list.html
old: http://www.sketchup.com/intl/en/developer/docs/classes
SketchUp Ruby API - Method Index
new: http://ruby.sketchup.com/method_list.html
old: http://www.sketchup.com/intl/en/developer/docs/methods
SketchUp Ruby API - Class Diagram
http://www.sketchup.com/intl/en/developer/docs/diagram broken link!
See: (GIF image here)
SketchUp Sage Resources
http://sites.google.com/site/sketchupsage/resources
SketchUp Plugin Checklist
http://www.thomthom.net/thoughts/2013/02/sketchup-plugin-checklist/
Units - Dealing with Units in SketchUp
http://www.thomthom.net/thoughts/2012/08/dealing-with-units-in-sketchup/
PickHelper - Visual Guide
by Thomas Thomassen
http://www.thomthom.net/thoughts/2013/01/pickhelper-a-visual-guide/
WebDialogs - The Lost Manual
by Thomas Thomassen
https://github.com/thomthom/sketchup-webdialogs-the-lost-manual

* Also see IDEAS section for specific ideas and helpers by class and category.

DanRathbun · March 28, 2018, 8:08pm

TEMPLATES

(A list of templates for programming SketchUp extensions and plugins.)

DanRathbun · May 24, 2018, 9:06am

NEWS & BLOGS

(Newsy or interesting happenings with Ruby and SketchUp.)

~ Ruby Generic ~

Ruby Lang News
Practicing Ruby (Articles are listed in reverse order.)
by Gregory T. Brown, author of “Ruby Best Practices”,
and the upcoming “Programming Beyond Practices”.
https://www.practicingruby.com/
Ruby Inside
By Peter Cooper, author of “Beginning Ruby: From Novice to Professional”
http://www.rubyinside.com/

~ SketchUp Ruby Specific ~

SketchUp Developer Blog (Official)
Procrastinator’s Revolt: Ruby API blog
by Thomas Thomassen (@thomthom)
http://www.thomthom.net/thoughts/category/sketchup/ruby-api/
Herosu: SketchUp Ruby blog
by Rafael Rivera (@Renderiza / aka renderiza at SketchUcation)
https://www.herosu.com/blog/categories/sketchup

~ SketchUp General ~

DanRathbun · September 2, 2020, 12:39am

IDEAS

(Ideas for doing nifty things with Ruby and SketchUp.)

API Documentation
- C API for SketchUp .skp files
  - SketchUp Live C API Examples
- C API for LayOut .layout files
- Ruby API for SketchUp application
- Ruby API for LayOut .layout files (runs in the SketchUp application process)
Bug and Feature Request Tracker for the SketchUp C and Ruby APIs
C extensions for SketchUp Ruby
- Ruby C extension examples, by SketchUp Extensibility Team
- SketchUp Live C API Examples, by SketchUp Extensibility Team
Coding and Debugging SketchUp Extensions
- Rubocop for SketchUp, by SketchUp Extensibility Team
  Rubocop cops for SketchUp - test your extension code against our Extension Warehouse technical requirements and other pitfalls.
- sketchup-ruby-debugger, by SketchUp Extensibility Team
  Ruby API debugger for SketchUp 2014 and later.
  - RubyMine Debugger Setup
- sketchup-diagnostics, by SketchUp Extensibility Team
  Collects diagnostics data related to SketchUp.
- speedup, by SketchUp Extensibility Team
  Profiling tool for SketchUp Ruby extensions.
- Tutorials and examples for the SketchUp Ruby API, by the Developer Community
  SketchUp Ruby API Tutorials and Examples. (Work in Progress)
- testup-2, by SketchUp Extensibility Team
  TestUp 2 for SketchUp - A GUI wrapper for running Minitest in SketchUp.
- Using RubyMine for SketchUp extensions, by SketchUp Extensibility Team
  Example of how to set up your RubyMine IDE. Describes the process of giving your IDE insight to the SketchUp Ruby API by feeding it method stubs.
- Using Visual Studio Code for SketchUp extensions, by SketchUp Extensibility Team
  Visual Studio Code Project for SketchUp Extension Development.
LanguageHandler class
- Using format string parameter replacement with LanguageHandler

Sketchup::ImageRep class
- color-at-uv, by SketchUp Extensibility Team
  Examples of using SketchUp Ruby API’s Sketchup::ImageRep class.
Sketchup::Material class
- sketchup-colorize-algorithm, by SketchUp Extensibility Team
  Explanation of SketchUp’s colorization algorithm of how SketchUp colorize materials using HLS shifting or tinting.
Sketchup Observer classes
- Observer Updates and Overhaul (v2016 Release Notes)
  -> In depth explanations in downloadable PDF document
- Safer SketchUp Observer Events (for SketchUp 2015 or older)
  by SketchUp Extensibility Team
  Wrapper for executing model changes from observer events safely,
  in SketchUp versions prior to the 2016 overhaul.
Sketchup::PickHelper class
- PickHelper - Visual Guide, by Thomas Thomassen
UI::inputbox() module method
- Inputbox prompt strings are clipped short without apparent reason
  A discussion of inputbox layout bugs and quirks.
- Units - Dealing with Units in SketchUp, by Thomas Thomassen

UI::HtmlDialog class
- Examples, by SketchUp Extensibility Team
  Examples of using SketchUp Ruby API’s UI::HtmlDialog class.
- HtmlDialog Inputbox Example, by SketchUp Extensibility Team
  UI::HtmlDialog example recreating UI.inputbox functionality in the SketchUp Ruby API.
UI::WebDialog class (Note: This is a deprecated class.)

jody · April 26, 2016, 6:38pm

Ruby Learning Resources [WikiLists]

INDEX

PRIMERS & GUIDES

BOOKS

~ Ruby Generic ~

( DOWNLOADABLE )

( ONLINE )

( PRINTED )

~ SketchUp Specific ~

( DOWNLOADABLE )

( ONLINE )

( PRINTED )

TUTORIALS

~ Ruby Generic ~

VIDEO COURSES

~ SketchUp Specific ~

“Edges to Rubies” is Outdated and No Longer Recommended !

REFERENCE

~ Ruby Generic ~

~ SketchUp Specific ~

TEMPLATES

NEWS & BLOGS

~ Ruby Generic ~

~ SketchUp Ruby Specific ~

~ SketchUp General ~

IDEAS

API Documentation

Bug and Feature Request Tracker for the SketchUp C and Ruby APIs

C extensions for SketchUp Ruby

Coding and Debugging SketchUp Extensions

`LanguageHandler class`

`Sketchup::ImageRep class`

`Sketchup::Material class`

Sketchup Observer classes

`Sketchup::PickHelper class`

`UI::inputbox() module method`

`UI::HtmlDialog class`

`UI::WebDialog class` (Note: This is a deprecated class.)

INDEX

PRIMERS & GUIDES

BOOKS

~ Ruby Generic ~

( DOWNLOADABLE )

( ONLINE )

( PRINTED )

~ SketchUp Specific ~

( DOWNLOADABLE )

( ONLINE )

( PRINTED )

TUTORIALS

~ Ruby Generic ~

VIDEO COURSES

~ SketchUp Specific ~

“Edges to Rubies” is Outdated and No Longer Recommended !

REFERENCE

~ Ruby Generic ~

~ SketchUp Specific ~

TEMPLATES

NEWS & BLOGS

~ Ruby Generic ~

~ SketchUp Ruby Specific ~

~ SketchUp General ~

IDEAS

API Documentation

C extensions for SketchUp Ruby

Coding and Debugging SketchUp Extensions

Sketchup Observer classes

UI::WebDialog class (Note: This is a deprecated class.)

`UI::WebDialog class` (Note: This is a deprecated class.)