Ruby Learning Resources [WikiLists]

[DanRathbun]

All seven of the lists below are set as wikis.

---

INDEX

• PRIMERS & GUIDES

• BOOKS

• TUTORIALS

• REFERENCE

• TEMPLATES

---

• NEWS

• IDEAS

---

[DanRathbun]

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
    • Assignment
    • Calling Methods
    • Control Expressions
    • Exceptions
    • Literals
    • Methods
    • Miscellaneous
    • Modules and Classes
    • Precedence
    • Refinements
• Ruby Standard Library Overview

---

Ruby Language Primers for v 2.2.4 - SketchUp 2017 & 2018

• Primer Index
  • Keywords
  • Global Variables
  • Regular Expressions
  • Security
  • Syntax
    • Assignment
    • Calling Methods
    • Control Expressions
    • Exceptions
    • Literals
    • Methods
    • Miscellaneous
    • Modules and Classes
    • Precedence
    • Refinements
• Ruby Standard Library Overview

---

Ruby Language Primers for v 2.5.1 - SketchUp 2019.0 & 2019.1

• Primer Index
  • Keywords
  • Global Variables
  • Regular Expressions
  • Security
  • Syntax
    • Assignment
    • Calling Methods
    • Control Expressions
    • Exceptions
    • Literals
    • Methods
    • Miscellaneous
    • Modules and Classes
    • Precedence
    • Refinements
• Ruby Standard Library Overview

---

Ruby Language Primers for v 2.5.5 - SketchUp 2019.2+

• Primer Index
  • Keywords
  • Global Variables
  • Regular Expressions
  • Security
  • Syntax
    • Assignment
    • Calling Methods
    • Control Expressions
    • Exceptions
    • Literals
    • Methods
    • Miscellaneous
    • Modules and Classes
    • Precedence
    • Refinements
• Ruby Standard Library Overview

---

Top | BOOKS | IDEAS | NEWS | REFERENCE | TEMPLATES | TUTORIALS

[DanRathbun]

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.)

---

Top | PRIMERS | IDEAS | NEWS | REFERENCE | TEMPLATES | TUTORIALS

[DanRathbun]

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 ~

SketchUp/sketchup-ruby-api-tutorials

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/

---

Top | PRIMERS | BOOKS | IDEAS | NEWS | REFERENCE | TEMPLATES

[DanRathbun]

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.

---

Top | PRIMERS | BOOKS | IDEAS | NEWS | TEMPLATES | TUTORIALS

[DanRathbun]

TEMPLATES

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

---

• [Template] for Basic SketchUp Extension

• [Template] Multi-File, Multi-Class with SharedConstants Mixin

• [Template] Ruby Plugin main file

---

Top | PRIMERS | BOOKS | IDEAS | NEWS | REFERENCE | TUTORIALS

[DanRathbun]

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 ~

• SketchUpdate - Official SketchUp Blog

• SketchUpdate Newsletters (index)

---

Top | PRIMERS | BOOKS | IDEAS | REFERENCE | TEMPLATES | TUTORIALS

[DanRathbun]

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.

    • Rubocop-SketchUp’s Relaxed Ruby Style config
    • Relaxed Rubocop Style config
    • Rubocop’s Default Stringent Style config

  • 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.)

  • WebDialogs - The Lost Manual, by Thomas Thomassen

  • MSDN: Defining document compatibility

  • MSDN: How to Enable Standards Support

  • MSDN: Specifying legacy document modes

---

Top | PRIMERS | BOOKS | NEWS | REFERENCE | TEMPLATES | TUTORIALS