The Ruby Programming Language [mirror]
Go to file
Samuel Williams 946e3bbdc2 Simplify the autoload require logic. 2022-05-26 14:20:59 +12:00
.github remove `-DTHREAD_DEBUG` rule 2022-05-24 10:06:51 +09:00
basictest [wasm] bootstraptest, basictest: disable backquote literal tests 2022-01-19 11:19:06 +09:00
benchmark Finer-grained constant cache invalidation (take 2) 2022-04-01 14:48:22 -04:00
bin
bootstraptest Special-case jit_guard_known_class for strings. This can remove (#5920) 2022-05-20 19:39:37 -04:00
ccan Prefix ccan headers (#4568) 2022-03-30 20:36:31 +13:00
coroutine Add support for address sanitizer for amd64 and arm64. 2022-05-25 15:24:24 +12:00
coverage
cygwin
defs Rust YJIT 2022-04-27 11:00:22 -04:00
doc Simplify the autoload require logic. 2022-05-26 14:20:59 +12:00
enc Remove Unicode 13.0.0 related files 2022-03-16 08:30:04 +09:00
ext [ruby/date] Constify gperf-generated table 2022-05-24 17:23:42 +09:00
gems Update bundled gems list at 2022-05-21 2022-05-21 07:07:14 +00:00
include Remove unnecessary module flag, add module assertions to other module flags 2022-05-23 11:04:34 -07:00
internal Increase SIZE_POOL_COUNT to 5 2022-05-09 08:45:24 -04:00
lib [ruby/fileutils] [DOC] Enhanced RDoc for copy_entry (https://github.com/ruby/fileutils/pull/76) 2022-05-26 07:08:26 +09:00
libexec Merge rubygems master 1e4eda741d732ca1bd7031aef0a16c7348adf7a5 2022-04-28 19:08:49 +09:00
man
misc Update lldb helper for iseq disassembly to use correct var name 2022-05-04 12:48:49 -07:00
missing Fix dtoa buffer overrun 2022-04-12 21:30:49 +09:00
sample Fix typo in README (#5925) 2022-05-20 14:45:46 -07:00
spec [rubygems/rubygems] Fix crash when printing resolution conflicts on metadata requirements 2022-05-24 21:24:57 +09:00
template Run find in PATH [ci skip] 2022-05-25 18:26:24 +09:00
test Fix GC race condition in autoload. 2022-05-26 00:17:30 +12:00
tool Hack to avoid leak checker 2022-05-25 18:48:01 +09:00
wasm wasm/README.md: add manual config.guess download and autoconf steps 2022-03-15 10:25:12 +09:00
win32 [Win32] allow pipe in flock 2022-04-21 15:14:08 +09:00
yjit Remove unnecessary module flag, add module assertions to other module flags 2022-05-23 11:04:34 -07:00
.appveyor.yml Update zlib version to 1.2.12 2022-03-28 17:28:01 +09:00
.cirrus.yml [DOC] Fix ghcr link 2022-03-31 08:35:39 +09:00
.dir-locals.el
.document Improve documentation on contributing to Ruby 2022-05-11 10:59:24 -04:00
.editorconfig
.gdbinit
.gitattributes
.gitignore Ignore rubyspec_temp fot Git 2022-05-09 07:29:37 +09:00
.rdoc_options [DOC] Set the documentation title and main page 2022-02-21 13:08:06 +09:00
.rspec_parallel
.travis.yml Remove gdbm related code from Travis CI 2022-03-04 18:09:34 +09:00
BSDL
CONTRIBUTING.md Improve documentation on contributing to Ruby 2022-05-11 10:59:24 -04:00
COPYING
COPYING.ja
GPL
KNOWNBUGS.rb
LEGAL LEGAL: mention error_highlight 2021-12-13 14:21:29 +09:00
NEWS.md Update default gems list at fde4519af8 [ci skip] 2022-05-25 09:09:04 +00:00
README.EXT
README.EXT.ja
README.ja.md Update badges from README.md [ci skip] 2021-12-24 09:05:12 +09:00
README.md Removed subversion section because there is no active branch for svn. 2022-05-19 15:48:28 +09:00
aclocal.m4
addr2line.c Print function name in backtrace when available 2022-05-13 10:47:50 -04:00
addr2line.h
array.c Add missing write barriers to Array#replace 2022-04-28 11:31:22 -04:00
array.rb Use `Primitive.mandatory_only?` for `Array#sample` 2021-11-15 15:58:56 +09:00
ast.c Add ISEQ_BODY macro 2022-03-24 10:03:51 -04:00
ast.rb
autogen.sh autogen.sh: Copy auxiliary files instead of symlinks with `-i` 2021-12-06 17:53:37 +09:00
bignum.c Disable GMP by -DUSE_GMP=0 2022-05-20 19:05:35 +09:00
builtin.c
builtin.h `rb_vm_lvar_exposed()` is PUREFUNC 2021-11-15 13:11:30 +09:00
class.c Remove unnecessary module flag, add module assertions to other module flags 2022-05-23 11:04:34 -07:00
common.mk `annobin` works only when targeting Fedora 2022-05-16 19:27:37 +09:00
compar.c [DOC] Use simple references to operator methods 2022-03-30 10:54:52 +09:00
compile.c Add ISEQ_BODY macro 2022-03-24 10:03:51 -04:00
complex.c [DOC] Fix broken links to literals.rdoc 2022-02-08 01:27:52 +09:00
configure.ac Disable usage of TLS unless available 2022-05-22 16:49:48 +09:00
constant.h
cont.c Ensure we retain the main fiber stack bounds. 2022-05-25 21:50:53 +12:00
darray.h Remove _with_gc functions in darray 2022-05-03 09:07:39 -04:00
debug.c add `rb_th_serial()` 2022-05-24 10:06:51 +09:00
debug_counter.c
debug_counter.h optimize `Struct` getter/setter 2021-11-19 08:32:39 +09:00
dir.c dir.c: refresh pathtype when emulating `IFTODT` in `glob_helper` 2022-04-03 01:13:16 +09:00
dir.rb Repair format for What's Here in Dir (#5737) 2022-03-30 14:14:36 -05:00
dln.c Only define RUBY_DLN_CHECK_ABI when supported 2022-03-01 09:44:39 -05:00
dln.h
dln_find.c
dmydln.c
dmyenc.c
dmyext.c
encindex.h
encoding.c [DOC] Main doc for encodings moved from encoding.c to doc/encodings.rdoc (#5748) 2022-04-01 20:41:04 -05:00
enum.c Simplify example code for Enumerable#each_with_object 2022-04-25 12:32:29 -07:00
enumerator.c
error.c No fallback to default values 2022-05-21 22:58:45 +09:00
eval.c Remove unnecessary module flag, add module assertions to other module flags 2022-05-23 11:04:34 -07:00
eval_error.c Remove unneeded newline from detailed_message 2022-02-22 11:55:40 +09:00
eval_intern.h `rb_fiber_terminate` must not return [Bug #18497] 2022-01-19 19:57:16 +09:00
eval_jump.c
file.c Fix missing paren [ci skip] 2022-05-06 18:13:22 +09:00
gc.c Define unsupported GC compaction methods as rb_f_notimplement 2022-05-24 09:40:03 -07:00
gc.h Add the size pool slot size to the output of ObjectSpace.dump/dump_all 2022-02-03 15:07:35 -05:00
gc.rb Move compaction-related methods into gc.c 2022-05-24 09:40:03 -07:00
gem_prelude.rb
golf_prelude.rb
goruby.c
hash.c Document best-practices for writing hash methods (#5805) 2022-04-30 12:57:51 +02:00
hrtime.h thread.c: Move double2hrtime and hrtime2double to hrtime.h 2022-03-30 16:50:46 +09:00
id_table.c Support ID_TABLE_STOP for replace function 2022-01-25 16:51:16 -05:00
id_table.h Rename rb_id_table_foreach_with_replace 2022-01-25 16:51:16 -05:00
inits.c IO::Buffer for scheduler interface. 2021-11-10 19:21:05 +13:00
insns.def RubyVM.stat constant cache metrics (#5766) 2022-04-05 16:37:00 -04:00
internal.h
io.c Fix out of bounds read. 2022-05-25 21:50:53 +12:00
io.rb
io_buffer.c Add basic binary operators (and, or, xor, not) to `IO::Buffer`. (#5893) 2022-05-09 17:19:01 +12:00
iseq.c Rust YJIT 2022-04-27 11:00:22 -04:00
iseq.h Finer-grained constant cache invalidation (take 2) 2022-04-01 14:48:22 -04:00
kernel.rb Improve performance Kernel#Float with using Primitive.mandatory_only? method [Feature #18344] (#5133) 2021-11-17 20:26:40 -08:00
lex.c.blt
load.c Remove _with_gc functions in darray 2022-05-03 09:07:39 -04:00
loadpath.c
localeinit.c
main.c [WASM] System initialization has no stack rewinding code to Asyncify 2022-05-24 12:17:19 +09:00
marshal.c Fix typos [ci skip] 2021-12-25 10:33:49 +09:00
marshal.rb [DOC] Document Marshal#load parameter freeze: (#5332) 2021-12-24 09:55:09 +01:00
math.c [DOC] Enhanced RDoc for Math module (#5837) 2022-04-25 10:07:21 -05:00
memory_view.c memory_view.c: Add _memory_view_entry member in rb_memory_view_t (#5088) 2021-11-08 12:52:09 +09:00
method.h Fix memory leak at the same named alias [Bug #18516] 2022-01-27 15:46:08 +09:00
mini_builtin.c
miniinit.c
mjit.c Prefix ccan headers (#4568) 2022-03-30 20:36:31 +13:00
mjit.h Add ISEQ_BODY macro 2022-03-24 10:03:51 -04:00
mjit_compile.c Add ISEQ_BODY macro 2022-03-24 10:03:51 -04:00
mjit_worker.c Prefix ccan headers (#4568) 2022-03-30 20:36:31 +13:00
nilclass.rb
node.c Remove `NODE_DASGN_CURR` [Feature #18406] 2021-12-13 12:53:03 +09:00
node.h Remove `NODE_DASGN_CURR` [Feature #18406] 2021-12-13 12:53:03 +09:00
numeric.c Use correct capitalization of "NaN" in docs 2022-04-13 15:44:36 -04:00
numeric.rb Add examples for Integer.try_convert [ci skip] 2021-12-15 02:12:37 +09:00
object.c Link from printf methods to format spec doc (#5886) 2022-05-05 09:01:12 -05:00
pack.c pack.c: add an offset argument to unpack and unpack1 2021-10-26 22:27:30 +02:00
pack.rb [DOC] Repair format and links in What's Here sections (#5711) 2022-03-25 10:52:06 -05:00
parse.y Private local variables should shadow outer variables [Bug #18629] 2022-04-21 16:04:36 +09:00
prelude.rb Make Set a builtin feature [Feature #16989] 2022-02-18 11:56:24 +09:00
probes.d
probes_helper.h
proc.c Reuse `rb_proc_arity` 2022-04-24 14:06:45 -07:00
process.c [ci skip] Fix docs 2022-04-13 10:43:23 -04:00
ractor.c rename thread internal naming 2022-04-22 07:54:09 +09:00
ractor.rb
ractor_core.h cleanup by `RUBY_DEBUG_LOG2` and `VM_ASSERT` 2022-05-24 02:22:41 +09:00
random.c [DOC] Mark up the code for Kernel#rand as the same as Random#rand 2022-01-13 11:34:09 +09:00
range.c Document beginless, endless ranges in Range class documentation 2022-04-25 13:07:35 -07:00
rational.c Disable GMP by -DUSE_GMP=0 2022-05-20 19:05:35 +09:00
re.c [DOC] Enhanced RDoc for MatchData (#5822) 2022-04-18 18:19:10 -05:00
regcomp.c Just free compiled pattern if no space is used 2022-04-12 20:24:14 +09:00
regenc.c
regenc.h Move ruby.h in `#ifdef RUBY` block 2022-03-11 15:08:23 +09:00
regerror.c
regexec.c re.c: Add Regexp.timeout= and Regexp.timeout 2022-03-30 16:50:46 +09:00
regint.h re.c: Add Regexp.timeout= and Regexp.timeout 2022-03-30 16:50:46 +09:00
regparse.c
regparse.h
regsyntax.c
ruby-runner.c
ruby.c Rust YJIT 2022-04-27 11:00:22 -04:00
ruby_assert.h
ruby_atomic.h
rubystub.c
scheduler.c Add fiber scheduler hooks for `pread`/`pwrite`, and add support to `IO::Buffer`. 2021-12-23 12:20:09 +13:00
signal.c
siphash.c
siphash.h
sparc.c [DOC]Some link prefix replace 2022-04-09 17:43:46 +09:00
sprintf.c
st.c st.c: Fix a typo in a comment 2022-02-28 11:40:25 +09:00
strftime.c
string.c [Feature #18595] Alias String#-@ as String#dedup 2022-05-20 11:31:59 -07:00
string.rb All-in-one RDoc for class String (#5777) 2022-04-07 14:29:04 -05:00
struct.c [ci skip] Fix docs 2022-04-13 10:43:23 -04:00
symbol.c [DOC] Move the documentations of moved Symbol methods 2022-04-14 11:17:37 +09:00
symbol.h
thread.c use `RUBY_DEBUG_LOG` instead of `thread_debug` 2022-05-24 10:06:51 +09:00
thread_none.c remove `DEBUG_OUT()` macro 2022-05-24 16:28:07 +09:00
thread_none.h introduce struct `rb_native_thread` 2022-04-23 03:08:27 +09:00
thread_pthread.c altstack is native thread's attr 2022-05-24 17:50:49 +09:00
thread_pthread.h altstack is native thread's attr 2022-05-24 17:50:49 +09:00
thread_sync.c Prefix ccan headers (#4568) 2022-03-30 20:36:31 +13:00
thread_win32.c remove `DEBUG_OUT()` macro 2022-05-24 16:28:07 +09:00
thread_win32.h `native_tls_get()`' should not check results 2022-05-24 10:06:51 +09:00
time.c [DOC]Some link prefix replace 2022-04-09 17:43:46 +09:00
timev.h
timev.rb [DOC] prefer rdoc references over generated URLs 2022-02-19 15:14:01 +09:00
trace_point.rb Fix comment 2022-03-29 18:14:33 -07:00
transcode.c [DOC] Place a non-US-ASCII document in a document-specific script 2022-02-26 16:23:04 +09:00
transcode_data.h
transient_heap.c `USE_RUBY_DEBUG_LOG` doesn't check `RUBY_DEVEL` 2021-12-29 00:22:02 +09:00
transient_heap.h
util.c
variable.c Simplify the autoload require logic. 2022-05-26 14:20:59 +12:00
variable.h
version.c Rename --jit to --mjit (#5248) 2021-12-13 16:08:01 -08:00
version.h * 2022-05-26 [ci skip] 2022-05-26 07:08:41 +09:00
vm.c remove `NON_SCALAR_THREAD_ID` support 2022-05-24 10:06:51 +09:00
vm_args.c Unflag a splatted flagged hash if the method doesn't use ruby2_keywords 2022-04-05 11:42:02 +02:00
vm_backtrace.c Write Thread instead of Threade 2022-05-12 07:53:17 +09:00
vm_callinfo.h Remove a typo hash [ci skip] 2022-01-29 15:33:13 +09:00
vm_core.h altstack is native thread's attr 2022-05-24 17:50:49 +09:00
vm_debug.h `USE_RUBY_DEBUG_LOG` doesn't check `RUBY_DEVEL` 2021-12-29 00:22:02 +09:00
vm_dump.c remove `NON_SCALAR_THREAD_ID` support 2022-05-24 10:06:51 +09:00
vm_eval.c Add ISEQ_BODY macro 2022-03-24 10:03:51 -04:00
vm_exec.c Cleanup diff against upstream. Add comments 2021-10-20 18:19:42 -04:00
vm_exec.h Add ISEQ_BODY macro 2022-03-24 10:03:51 -04:00
vm_insnhelper.c Remove unnecessary module flag, add module assertions to other module flags 2022-05-23 11:04:34 -07:00
vm_insnhelper.h RubyVM.stat constant cache metrics (#5766) 2022-04-05 16:37:00 -04:00
vm_method.c Remove unnecessary module flag, add module assertions to other module flags 2022-05-23 11:04:34 -07:00
vm_opts.h
vm_sync.c Prefix ccan headers (#4568) 2022-03-30 20:36:31 +13:00
vm_sync.h `USE_RUBY_DEBUG_LOG` doesn't check `RUBY_DEVEL` 2021-12-29 00:22:02 +09:00
vm_trace.c Raise RuntimeError if Kernel#binding is called from a non-Ruby frame 2022-04-06 19:14:03 -07:00
vsnprintf.c [Feature #18491] Drop support for HP-UX 2022-01-18 09:52:15 -05:00
warning.rb
yjit.c Ruby shovel operator (<<) speedup. (#5896) 2022-05-11 11:20:21 -04:00
yjit.h Rust YJIT 2022-04-27 11:00:22 -04:00
yjit.rb Rust YJIT 2022-04-27 11:00:22 -04:00

README.md

Actions Status: MinGW Actions Status: MJIT Actions Status: Ubuntu Actions Status: Windows AppVeyor status Travis Status Cirrus Status

What is Ruby?

Ruby is an interpreted object-oriented programming language often used for web development. It also offers many scripting features to process plain text and serialized files, or manage system tasks. It is simple, straightforward, and extensible.

Features of Ruby

  • Simple Syntax
  • Normal Object-oriented Features (e.g. class, method calls)
  • Advanced Object-oriented Features (e.g. mix-in, singleton-method)
  • Operator Overloading
  • Exception Handling
  • Iterators and Closures
  • Garbage Collection
  • Dynamic Loading of Object Files (on some architectures)
  • Highly Portable (works on many Unix-like/POSIX compatible platforms as well as Windows, macOS, etc.) cf. https://github.com/ruby/ruby/blob/master/doc/maintainers.rdoc#label-Platform+Maintainers

How to get Ruby with Git

For a complete list of ways to install Ruby, including using third-party tools like rvm, see:

https://www.ruby-lang.org/en/downloads/

The mirror of the Ruby source tree can be checked out with the following command:

$ git clone https://github.com/ruby/ruby.git

There are some other branches under development. Try the following command to see the list of branches:

$ git ls-remote https://github.com/ruby/ruby.git

You may also want to use https://git.ruby-lang.org/ruby.git (actual master of Ruby source) if you are a committer.

Ruby home page

https://www.ruby-lang.org/

Documentation

Mailing list

There is a mailing list to discuss Ruby. To subscribe to this list, please send the following phrase:

subscribe

in the mail body (not subject) to the address ruby-talk-request@ruby-lang.org.

Copying

See the file COPYING.

Feedback

Questions about the Ruby language can be asked on the Ruby-Talk mailing list or on websites like https://stackoverflow.com.

Bugs should be reported at https://bugs.ruby-lang.org. Read "Reporting Issues" for more information.

Contributing

See "Contributing to Ruby", which includes setup and build instructions.

The Author

Ruby was originally designed and developed by Yukihiro Matsumoto (Matz) in 1995.

matz@ruby-lang.org