The Ruby Programming Language [mirror]

c language object-oriented ruby ruby-language

Go to file

Alan Wu 1466682a23 YJIT: Improve checking message for rustc version (#6693 ) Preivously we didn't have a "checking ...." line for this check and when rustc was too old, we would dump the error message to the console like: checking for rustc... rustc error: there is no argument named `x` --> <anon>:1:33 \| 1 \| fn main() { let x = 1; format!("{x}"); } \| ^^^ error: aborting due to previous error `configure` checks usually don't do this and this might be confusing. With this commit it now says something like: checking whether rustc is new enough for YJIT... no		2022-11-08 15:29:30 -05:00
.github	Set default %printer for NODE nterms	2022-11-08 12:30:03 +09:00
basictest	…
benchmark	Improve HTML escape benchmarks	2022-11-04 23:54:25 -07:00
bin	…
bootstraptest	Let other test runners follow the change of GNU make 4.4 jobserver	2022-11-07 10:08:30 +09:00
ccan	Fix -Wundef warnings	2022-10-26 18:57:26 +09:00
coroutine	Fix and improve coroutines for Darwin (macOS) ppc/ppc64. (#5975 )	2022-10-19 23:49:45 +13:00
coverage	…
cygwin	…
defs	…
doc	[doc] Clarify how to build OpenSSL on macOS	2022-11-08 14:59:01 -05:00
enc	…
ext	Set default %printer for NODE nterms	2022-11-08 12:30:03 +09:00
gems	Update bundled gems list at 2022-10-30	2022-10-30 07:04:08 +00:00
include	Fix -Wundef warnings	2022-10-26 18:57:26 +09:00
internal	Use shared flags of the type	2022-11-02 11:03:21 -04:00
lib	[rubygems/rubygems] Add tests for universal Ruby with arch-specific prebuilt gems	2022-11-08 17:05:19 +00:00
libexec	…
man	…
misc	Ivar copy needs to happen _before_ setting the shape	2022-11-01 15:38:44 -07:00
missing	…
sample	Sync TRICK 2018 (02-mame)	2022-11-05 23:18:32 +09:00
spec	[rubygems/rubygems] Add tests for universal Ruby with arch-specific prebuilt gems	2022-11-08 17:05:19 +00:00
template	Fix infinite loop when out-of-place build	2022-11-02 11:33:08 +09:00
test	[ruby/irb] Add execute_lines to reduce command tests' boilerplate	2022-11-08 17:19:59 +00:00
tool	jobserver option may not be at the last	2022-11-07 10:08:09 +09:00
wasm	[wasm] Scan machine stack based on `ec->machine.stack_{start,end}`	2022-11-06 05:03:21 +09:00
win32	[win32] Only include base windows types	2022-10-26 10:42:03 +09:00
yjit	Implement optimize call (#6691 )	2022-11-08 15:28:28 -05:00
.appveyor.yml	Ignore manual files only commits [ci skip]	2022-10-20 21:58:06 +09:00
.cirrus.yml	YJIT: Test --yjit-verify-ctx on GitHub Actions as well (#6639 )	2022-10-26 18:20:33 -04:00
.dir-locals.el	…
.document	…
.editorconfig	…
.gdbinit	…
.git-blame-ignore-revs	…
.gitattributes	…
.gitignore	…
.indent.pro	…
.rdoc_options	…
.rspec_parallel	…
.travis.yml	…
BSDL	…
CONTRIBUTING.md	…
COPYING	…
COPYING.ja	…
GPL	…
KNOWNBUGS.rb	…
LEGAL	…
NEWS.md	Update default gems list at `4e728486b9` [ci skip]	2022-11-08 08:08:48 +00:00
README.EXT	…
README.EXT.ja	…
README.ja.md	…
README.md	…
aclocal.m4	…
addr2line.c	Fix and improve coroutines for Darwin (macOS) ppc/ppc64. (#5975 )	2022-10-19 23:49:45 +13:00
addr2line.h	…
array.c	Use `roomof` macro for rounding up divisions	2022-10-14 19:23:25 +09:00
array.rb	…
ast.c	Add `node_id_for_backtrace_location` function	2022-10-31 13:39:56 +09:00
ast.rb	Add `node_id_for_backtrace_location` function	2022-10-31 13:39:56 +09:00
autogen.sh	…
bignum.c	Use `roomof` macro for rounding up divisions	2022-10-14 19:23:25 +09:00
builtin.c	…
builtin.h	…
class.c	Implement object shapes for T_CLASS and T_MODULE (#6637 )	2022-10-31 14:05:37 -07:00
common.mk	`--disable-jit-support` should disable YJIT successfully	2022-11-06 17:07:44 +09:00
compar.c	…
compile.c	Fix false LocalJumpError when branch coverage is enabled	2022-11-08 14:37:08 +09:00
complex.c	Improve performance some `Integer` and `Float` methods [Feature #19085 ] (#6638 )	2022-10-27 09:13:16 -07:00
configure.ac	YJIT: Improve checking message for rustc version (#6693 )	2022-11-08 15:29:30 -05:00
constant.h	…
cont.c	Lower priority of `POSIX_MADV_DONTNEED`. (#6671 )	2022-11-04 20:13:48 +13:00
darray.h	…
debug.c	…
debug_counter.c	…
debug_counter.h	Revert "Revert "This commit implements the Object Shapes technique in CRuby.""	2022-10-11 08:40:56 -07:00
dir.c	[Bug #19042 ] Fix Dir.glob brace with '/'	2022-10-18 09:18:03 +09:00
dir.rb	…
dln.c	Fix and improve coroutines for Darwin (macOS) ppc/ppc64. (#5975 )	2022-10-19 23:49:45 +13:00
dln.h	…
dln_find.c	…
dmydln.c	…
dmyenc.c	…
dmyext.c	…
encindex.h	…
encoding.c	…
enum.c	[DOC] Fix typo in Enumerable#slice_before	2022-10-19 09:14:50 +09:00
enumerator.c	…
error.c	Fix and improve coroutines for Darwin (macOS) ppc/ppc64. (#5975 )	2022-10-19 23:49:45 +13:00
eval.c	MJIT: Stop using the VM barrier for jit_cont	2022-10-19 17:20:48 -07:00
eval_error.c	…
eval_intern.h	…
eval_jump.c	…
file.c	[DOC] More about line number (#6582 )	2022-10-19 10:34:51 -05:00
gc.c	[wasm] Scan machine stack based on `ec->machine.stack_{start,end}`	2022-11-06 05:03:21 +09:00
gc.h	Fix and improve coroutines for Darwin (macOS) ppc/ppc64. (#5975 )	2022-10-19 23:49:45 +13:00
gc.rb	…
gem_prelude.rb	…
golf_prelude.rb	…
goruby.c	…
hash.c	Adjust indents [ci skip]	2022-10-24 00:22:37 +09:00
hrtime.h	Fix per-instance Regexp timeout (#6621 )	2022-10-24 18:03:26 +09:00
id_table.c	…
id_table.h	…
inits.c	Revert "Revert "This commit implements the Object Shapes technique in CRuby.""	2022-10-11 08:40:56 -07:00
insns.def	…
internal.h	Define `UNDEF_P` and `NIL_OR_UNDEF_P` [EXPERIMENTAL]	2022-10-20 22:05:27 +09:00
io.c	[DOC] Enhanced RDOc for IO (#6642 )	2022-10-29 14:47:16 -05:00
io.rb	…
io_buffer.c	[DOC] Fix IO::Buffer#slice rdoc position	2022-11-03 14:40:17 -04:00
iseq.c	push dummy frame for loading process	2022-10-20 17:38:28 +09:00
iseq.h	Allow passing a Rust closure to rb_iseq_callback (#6575 )	2022-10-18 09:07:11 -07:00
kernel.rb	…
lex.c.blt	…
load.c	push dummy frame for loading process	2022-10-20 17:38:28 +09:00
loadpath.c	…
localeinit.c	…
main.c	…
marshal.c	Implement object shapes for T_CLASS and T_MODULE (#6637 )	2022-10-31 14:05:37 -07:00
marshal.rb	…
math.c	…
memory_view.c	…
method.h	…
mini_builtin.c	…
miniinit.c	…
mjit.c	Allow passing a Rust closure to rb_iseq_callback (#6575 )	2022-10-18 09:07:11 -07:00
mjit.h	Make mjit_cont sharable with YJIT (#6556 )	2022-10-17 09:27:59 -07:00
mjit.rb	…
mjit_c.rb	Remove iv_index_tbl_entry	2022-10-24 10:54:01 -07:00
mjit_compiler.c	…
mjit_compiler.h	Revert "Revert "This commit implements the Object Shapes technique in CRuby.""	2022-10-11 08:40:56 -07:00
mjit_compiler.rb	…
mjit_unit.h	…
nilclass.rb	…
node.c	…
node.h	Remove unused macro	2022-10-09 14:00:52 +09:00
numeric.c	Use `roomof` macro for rounding up divisions	2022-10-14 19:23:25 +09:00
numeric.rb	Improve performance some `Integer` and `Float` methods [Feature #19085 ] (#6638 )	2022-10-27 09:13:16 -07:00
object.c	Ivar copy needs to happen _before_ setting the shape	2022-11-01 15:38:44 -07:00
pack.c	…
pack.rb	[DOC] Link to packed data doc (#6567 )	2022-10-18 10:16:22 -05:00
parse.y	Set default %printer for NODE nterms	2022-11-08 12:30:03 +09:00
prelude.rb	…
probes.d	…
probes_helper.h	…
proc.c	Use RTEST to to check return value	2022-11-04 09:02:58 -04:00
process.c	…
ractor.c	[Bug #19081 ] Show the caller location in warning for Ractor	2022-10-26 19:43:14 +09:00
ractor.rb	[Bug #19081 ] Show the caller location in warning for Ractor	2022-10-26 19:43:14 +09:00
ractor_core.h	Revert "Revert "This commit implements the Object Shapes technique in CRuby.""	2022-10-11 08:40:56 -07:00
random.c	Respect `USE_COMMON_RANDOM` macro by a command line option [ci skip]	2022-10-17 18:36:09 +09:00
range.c	Range#size returns nil for (.."a") and (nil..)	2022-10-21 16:35:46 +09:00
rational.c	Improve performance some `Integer` and `Float` methods [Feature #19085 ] (#6638 )	2022-10-27 09:13:16 -07:00
re.c	Suppress false warning by a bug of gcc	2022-11-08 16:13:30 +09:00
regcomp.c	Use `roomof` macro for rounding up divisions	2022-10-14 19:23:25 +09:00
regenc.c	Prevent potential buffer overrun in onigmo	2022-10-25 17:02:43 +09:00
regenc.h	Use `roomof` macro for rounding up divisions	2022-10-14 19:23:25 +09:00
regerror.c	…
regexec.c	…
regint.h	Fix and improve coroutines for Darwin (macOS) ppc/ppc64. (#5975 )	2022-10-19 23:49:45 +13:00
regparse.c	Prevent potential buffer overrun in onigmo	2022-10-25 17:02:43 +09:00
regparse.h	…
regsyntax.c	…
ruby-runner.c	…
ruby.c	YJIT: Lazily enable YJIT after prelude (#6597 )	2022-10-24 12:20:44 -04:00
ruby_assert.h	…
ruby_atomic.h	…
rubystub.c	…
scheduler.c	Update `Fiber::Scheduler` documentation. (#6562 )	2022-10-15 21:43:45 +13:00
shape.c	Implement object shapes for T_CLASS and T_MODULE (#6637 )	2022-10-31 14:05:37 -07:00
shape.h	Implement object shapes for T_CLASS and T_MODULE (#6637 )	2022-10-31 14:05:37 -07:00
signal.c	…
siphash.c	Fix and improve coroutines for Darwin (macOS) ppc/ppc64. (#5975 )	2022-10-19 23:49:45 +13:00
siphash.h	…
sparc.c	…
sprintf.c	…
st.c	Fix and improve coroutines for Darwin (macOS) ppc/ppc64. (#5975 )	2022-10-19 23:49:45 +13:00
strftime.c	…
string.c	Make str_alloc_heap return a STR_NOEMBED string	2022-11-03 09:09:11 -04:00
string.rb	…
struct.c	…
symbol.c	Implement optimize send in yjit (#6488 )	2022-10-11 16:37:05 -04:00
symbol.h	…
thread.c	Avoid missed wakeup with fiber scheduler and Fiber.blocking. (#6588 )	2022-10-20 13:38:52 +13:00
thread_none.c	[wasm] Scan machine stack based on `ec->machine.stack_{start,end}`	2022-11-06 05:03:21 +09:00
thread_none.h	…
thread_pthread.c	Fix possible use of undefined macros on very old macOS [ci skip]	2022-10-17 18:36:08 +09:00
thread_pthread.h	…
thread_sync.c	mutex: Raise a ThreadError when detecting a fiber deadlock (#6680 )	2022-11-09 00:43:16 +13:00
thread_sync.rb	thread_sync.c: Clarify and document the behavior of timeout == 0	2022-10-17 16:56:00 +02:00
thread_win32.c	…
thread_win32.h	…
time.c	[Bug #19106 ] Normalize time at 24:00:00 with a timezone object	2022-11-07 15:56:12 +09:00
timev.h	…
timev.rb	…
trace_point.rb	…
transcode.c	…
transcode_data.h	…
transient_heap.c	…
transient_heap.h	…
util.c	…
variable.c	Adjust indents [ci skip]	2022-11-01 09:35:09 +09:00
variable.h	Revert "Revert "This commit implements the Object Shapes technique in CRuby.""	2022-10-11 08:40:56 -07:00
version.c	YJIT: Lazily enable YJIT after prelude (#6597 )	2022-10-24 12:20:44 -04:00
version.h	…
vm.c	Fix -Wundef warnings	2022-10-26 18:57:26 +09:00
vm_args.c	…
vm_backtrace.c	push dummy frame for loading process	2022-10-20 17:38:28 +09:00
vm_callinfo.h	Prevent wrong integer expansion	2022-10-13 08:14:04 -07:00
vm_core.h	push dummy frame for loading process	2022-10-20 17:38:28 +09:00
vm_debug.h	…
vm_dump.c	push dummy frame for loading process	2022-10-20 17:38:28 +09:00
vm_eval.c	Revert "Revert "This commit implements the Object Shapes technique in CRuby.""	2022-10-11 08:40:56 -07:00
vm_exec.c	Fix and improve coroutines for Darwin (macOS) ppc/ppc64. (#5975 )	2022-10-19 23:49:45 +13:00
vm_exec.h	…
vm_insnhelper.c	Implement object shapes for T_CLASS and T_MODULE (#6637 )	2022-10-31 14:05:37 -07:00
vm_insnhelper.h	Remove unused class serial	2022-10-21 14:56:48 -07:00
vm_method.c	…
vm_opts.h	…
vm_sync.c	…
vm_sync.h	…
vm_trace.c	…
vsnprintf.c	…
warning.rb	…
yjit.c	Implement optimize call (#6691 )	2022-11-08 15:28:28 -05:00
yjit.h	…
yjit.rb	YJIT: Make more stats accessible from Ruby code (#6685 )	2022-11-08 12:36:29 -05: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.

How to build

see Building Ruby

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