The Ruby Programming Language [mirror]

c language object-oriented ruby ruby-language

Go to file

Alan Wu e4fe347302 Prevent printing crash report in a loop In the event that we are crashing due to a corrupt Ruby stack, we might re-enter rb_vm_bugreport() due to failed assertions in rb_backtrace_print_as_bugreport() or SDR(). In these cases we were printing the bug report ad infinitum with unbounded recusion. I seem to run into this every once in a while and the amount of log it prints out is pretty distracting. On CI environments it makes the log output unnecessarily big. Let's fix this.		2022-06-03 13:50:32 -04:00
.github	YJIT: Relax minimum Rust version requirement to 1.58.1	2022-05-29 13:43:02 -04:00
basictest	…
benchmark	Add IO write throughput/locking overhead benchmark.	2022-05-28 15:44:18 +12:00
bin	…
bootstraptest	Revert incorrect string-guard optimisation. (#5969 )	2022-06-01 10:22:08 -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	Split YJIT rules for CODEOWNERS	2022-06-02 10:12:34 +09:00
doc	Add information from doc/hacking.md and doc/make_cheatsheet.md back i… (#5963 )	2022-05-30 23:50:39 -04:00
enc	…
ext	[Feature #18339 ] GVL Instrumentation API	2022-06-03 15:13:33 +02:00
gems	Update bundled gems list at 2022-05-21	2022-05-21 07:07:14 +00:00
include	[Feature #18339 ] GVL Instrumentation API	2022-06-03 15:13:33 +02:00
internal	RCLASS uses FLUSER bits 0 through 3	2022-05-27 13:45:47 -07:00
lib	[rubygems/rubygems] Remove redundant bitwise AND	2022-06-02 22:23:42 +09:00
libexec	Merge rubygems master 1e4eda741d732ca1bd7031aef0a16c7348adf7a5	2022-04-28 19:08:49 +09:00
man	…
misc	Add more information to lldb dump_page helper	2022-05-27 13:45:33 -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] Add test cases from SHA1 RFC and improve test failure message	2022-06-02 22:23:42 +09:00
template	Add yjit.o to DTRACE_DEPENDENT_OBJS	2022-05-30 18:30:57 -04:00
test	[Feature #18339 ] GVL Instrumentation API	2022-06-03 15:13:33 +02:00
tool	Hack to avoid leak checker	2022-05-25 18:48:01 +09:00
wasm	…
win32	[Win32] allow pipe in flock	2022-04-21 15:14:08 +09:00
yjit	Split YJIT rules for CODEOWNERS	2022-06-02 10:12:34 +09: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	…
.rspec_parallel	…
.travis.yml	…
BSDL	…
CONTRIBUTING.md	Improve documentation on contributing to Ruby	2022-05-11 10:59:24 -04:00
COPYING	…
COPYING.ja	…
GPL	…
KNOWNBUGS.rb	…
LEGAL	…
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	…
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	…
ast.c	…
ast.rb	…
autogen.sh	…
bignum.c	Fix the condition when a new buffer is needed without GMP	2022-06-02 10:29:53 +09:00
builtin.c	…
builtin.h	Typedef built-in function types	2022-06-02 16:05:35 +09:00
class.c	Remove unused RMODULE_INCLUDED_INTO_REFINEMENT flag	2022-05-26 12:09:04 -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	…
complex.c	…
configure.ac	Disable usage of TLS unless available	2022-05-22 16:49:48 +09:00
constant.h	…
cont.c	Remove unnecessary ignore warnings.	2022-05-26 16:51: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	…
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	…
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	Revert flawed doc for slice_after, slice_when, and chunk_while (#5952 )	2022-05-28 14:20:00 -05: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	…
eval_intern.h	…
eval_jump.c	…
file.c	Fix missing paren [ci skip]	2022-05-06 18:13:22 +09:00
gc.c	Typedef built-in function types	2022-06-02 16:05:35 +09:00
gc.h	…
gc.rb	Move `GC.verify_compaction_references` [Bug #18779 ]	2022-06-02 15:32:00 +09: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	…
id_table.h	…
inits.c	…
insns.def	RubyVM.stat constant cache metrics (#5766 )	2022-04-05 16:37:00 -04:00
internal.h	…
io.c	Make `Kernel#p` completely uninterruptible.	2022-05-28 15:44:18 +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	…
lex.c.blt	…
load.c	[DOC] Mention the case to autoload already defined constant	2022-06-03 14:10:30 +09: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	…
marshal.rb	…
math.c	[DOC] Enhanced RDoc for Math module (#5837 )	2022-04-25 10:07:21 -05:00
memory_view.c	Only check class ancestors for ivar in memory_view	2022-05-27 13:38:40 -07:00
method.h	…
mini_builtin.c	…
miniinit.c	…
mjit.c	Prefix ccan headers (#4568 )	2022-03-30 20:36:31 +13:00
mjit.h	…
mjit_compile.c	…
mjit_worker.c	Prefix ccan headers (#4568 )	2022-03-30 20:36:31 +13:00
nilclass.rb	…
node.c	…
node.h	…
numeric.c	[DOC] Fix documentation of Numeric#div: Complex does not have #div	2022-06-03 14:35:47 +09:00
numeric.rb	…
object.c	Link from printf methods to format spec doc (#5886 )	2022-05-05 09:01:12 -05:00
pack.c	…
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	…
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	…
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	…
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	…
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	…
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	Don't attempt to read ivars on T_ICLASS in struct (#5664 )	2022-05-26 11:54:15 -07: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	[Feature #18339 ] GVL Instrumentation API	2022-06-03 15:13:33 +02: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	[Feature #18339 ] GVL Instrumentation API	2022-06-03 15:13:33 +02:00
thread_win32.h	`native_tls_get()`' should not check results	2022-05-24 10:06:51 +09:00
time.c	Using TZMODE_SET_LOCALTIME macro	2022-05-26 19:55:05 +09:00
timev.h	…
timev.rb	…
trace_point.rb	Fix comment	2022-03-29 18:14:33 -07:00
transcode.c	…
transcode_data.h	…
transient_heap.c	…
transient_heap.h	…
util.c	…
variable.c	Simplify the autoload require logic.	2022-05-26 14:20:59 +12:00
variable.h	…
version.c	…
version.h	* 2022-06-03 [ci skip]	2022-06-03 14:13:31 +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	…
vm_core.h	altstack is native thread's attr	2022-05-24 17:50:49 +09:00
vm_debug.h	…
vm_dump.c	Prevent printing crash report in a loop	2022-06-03 13:50:32 -04:00
vm_eval.c	…
vm_exec.c	…
vm_exec.h	…
vm_insnhelper.c	Fix use-after-free with interacting TracePoints	2022-05-30 13:54:22 -04: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	…
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	…
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

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