The Ruby Programming Language [mirror]
Go to file
Nobuyoshi Nakada 5ccb625fbb
Use `roomof` macro for rounding up divisions
2022-10-14 19:23:25 +09:00
.github Notify CI failures of Miscellaneous checks 2022-10-06 11:58:50 -07:00
basictest [wasm] bootstraptest, basictest: disable backquote literal tests 2022-01-19 11:19:06 +09:00
benchmark Add several new methods for getting and setting buffer contents. (#6434) 2022-09-26 18:06:12 +13:00
bin [rubygems/rubygems] rubygems.rb is required by gem_runner.rb 2022-07-22 16:24:29 +09:00
bootstraptest Revert "Revert "This commit implements the Object Shapes technique in CRuby."" 2022-10-11 08:40:56 -07: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 Fix parallel build on MINGW 2022-09-10 09:32:27 +09:00
defs reserved_word: just use gperf 3.1 declaration 2022-09-21 11:44:09 +09:00
doc Fix a typo Denail-of-Service => Denial-of-Service [ci skip] 2022-10-08 12:36:05 +09:00
enc reserved_word: just use gperf 3.1 declaration 2022-09-21 11:44:09 +09:00
ext [ruby/psych] Fix missing `abort` call 2022-10-12 20:24:38 +09:00
gems Update bundled gems list at 2022-10-08 2022-10-08 07:05:42 +00:00
include Improvements to IO::Buffer implementation and documentation. (#6525) 2022-10-12 12:59:05 +13:00
internal Use `roomof` macro for rounding up divisions 2022-10-14 19:23:25 +09:00
lib Only expose Ruby Shape API if VM_CHECK_MODE is enabled 2022-10-13 13:11:01 -07:00
libexec Added syntax_suggest cli and resolve failing exapmle with it 2022-08-26 12:15:47 +09:00
man [ruby/irb] Add description of IRB_LANG, IRBRC, and XDG_CONFIG_HOME to man 2022-10-05 19:20:22 +09:00
misc Revert "Revert "This commit implements the Object Shapes technique in CRuby."" 2022-10-11 08:40:56 -07:00
missing Adjust styles [ci skip] 2022-07-27 18:42:27 +09:00
sample Fix typo in README (#5925) 2022-05-20 14:45:46 -07:00
spec Skip utime example with Intel C Compiler suite 2022-10-13 13:42:22 +09:00
template Extract `RUBY_RELEASE_DATE` from also revision.h 2022-09-25 22:40:05 +09:00
test Only expose Ruby Shape API if VM_CHECK_MODE is enabled 2022-10-13 13:11:01 -07:00
tool Only expose Ruby Shape API if VM_CHECK_MODE is enabled 2022-10-13 13:11:01 -07:00
wasm [wasm] get rid of workaround use of older binaryen and update to latest 2022-07-06 11:59:38 +09:00
win32 Demote mjit_instruction.rb from builtin to stdlib 2022-09-18 14:04:20 +09:00
yjit fixes more clippy warnings (#6543) 2022-10-13 18:20:04 -04:00
.appveyor.yml Upgrade zlib_version on AppVeyor 2022-10-13 16:29:06 -07:00
.cirrus.yml YJIT: Set RUST_BACKTRACE=1 in every Cirrus script (#6526) 2022-10-12 15:50:50 -04:00
.dir-locals.el
.document Implement Queue#pop(timeout: sec) 2022-08-02 11:04:28 +02:00
.editorconfig
.gdbinit Fix gdb incompatibilies in rp_class, rb_ps_vm 2022-08-20 12:24:37 +09:00
.git-blame-ignore-revs Ignore fc4acf8cae on git blame 2022-08-19 14:45:51 -07:00
.gitattributes
.gitignore mjit_c.rb doesn't need to be an erb 2022-09-23 06:44:28 +09:00
.indent.pro Update .indent.pro [ci skip] 2022-07-22 21:59:58 +09:00
.rdoc_options [DOC] Set the documentation title and main page 2022-02-21 13:08:06 +09:00
.rspec_parallel
.travis.yml [TravisCI] The source of YAML is no longer bundled 2022-09-15 01:38:43 +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
NEWS.md Add MatchData#deconstruct/deconstruct_keys 2022-10-10 12:41:13 +09:00
README.EXT
README.EXT.ja
README.ja.md
README.md Add link to how to build Ruby 2022-09-14 17:30:10 +09:00
aclocal.m4
addr2line.c Fix warnings by old gcc 2022-06-23 22:52:45 +09:00
addr2line.h
array.c Use `roomof` macro for rounding up divisions 2022-10-14 19:23:25 +09:00
array.rb
ast.c Move `error` from top_stmts and top_stmt to stmt 2022-10-08 17:59:11 +09:00
ast.rb Add error_tolerant option to RubyVM::AST 2022-10-08 17:59:11 +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 Built-in function table sentinels do not need names 2022-09-09 14:20:47 +09:00
class.c Reuse ins_methods_type_i function 2022-10-14 18:31:15 +09:00
common.mk Improvements to IO::Buffer implementation and documentation. (#6525) 2022-10-12 12:59:05 +13:00
compar.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
compile.c Revert "Revert "This commit implements the Object Shapes technique in CRuby."" 2022-10-11 08:40:56 -07:00
complex.c Consider Complex from Complex cases 2022-09-02 14:33:23 +09:00
configure.ac [Bug #16909] Honor the tool prefix against pkg-config 2022-10-02 16:08:38 +09:00
constant.h
cont.c Improvements to IO::Buffer implementation and documentation. (#6525) 2022-10-12 12:59:05 +13:00
darray.h Remove _with_gc functions in darray 2022-05-03 09:07:39 -04:00
debug.c Undefine `ruby_debug_log` macro before the function definition 2022-08-30 11:23:16 +09:00
debug_counter.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
debug_counter.h Revert "Revert "This commit implements the Object Shapes technique in CRuby."" 2022-10-11 08:40:56 -07:00
dir.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
dir.rb fix typo in dir documentation (#6002) 2022-06-10 22:22:16 -07:00
dln.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
dln.h
dln_find.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
dmydln.c
dmyenc.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
dmyext.c
encindex.h Rename ENCINDEX_ASCII to ENCINDEX_ASCII_8BIT 2022-07-19 08:48:56 +02:00
encoding.c Remove get_actual_encoding() and the dynamic endian detection for dummy UTF-16/UTF-32 2022-09-12 14:02:34 +02:00
enum.c [DOC] Fix formatting issue in Enumerable 2022-08-08 09:26:07 -04:00
enumerator.c Fix Array#[] with ArithmeticSequence with negative steps (#5739) 2022-08-11 19:16:49 +09:00
error.c Reuse `with_warning_string_from` macro 2022-10-10 13:52:25 +09:00
eval.c Support using at toplevel in wrapped script 2022-09-24 09:41:15 +09:00
eval_error.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
eval_intern.h Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
eval_jump.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
file.c [DOC] Remove unknown markup or macro [ci skip] 2022-10-05 19:43:54 +09:00
gc.c Use `roomof` macro for rounding up divisions 2022-10-14 19:23:25 +09:00
gc.h Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
gc.rb Add expand_heap option to GC.verify_compaction_references 2022-07-11 09:00:03 -04:00
gem_prelude.rb Setup SyntaxSuggest as default gem 2022-08-19 10:02:24 +09:00
golf_prelude.rb
goruby.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
hash.c [Bug #17767] Now `ENV.clone` raises `TypeError` as well as `ENV.dup` 2022-08-02 16:40:12 +09:00
hrtime.h Implement Queue#pop(timeout: sec) 2022-08-02 11:04:28 +02:00
id_table.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
id_table.h Rename rb_id_table_foreach_with_replace 2022-01-25 16:51:16 -05:00
inits.c Revert "Revert "This commit implements the Object Shapes technique in CRuby."" 2022-10-11 08:40:56 -07:00
insns.def New constant caching insn: opt_getconstant_path 2022-09-01 15:20:49 -07:00
internal.h Revert "Revert "This commit implements the Object Shapes technique in CRuby."" 2022-10-11 08:40:56 -07:00
io.c Ignore failure to set nonblock mode. (#6524) 2022-10-11 10:18:20 +13:00
io.rb
io_buffer.c Improvements to IO::Buffer implementation and documentation. (#6525) 2022-10-12 12:59:05 +13:00
iseq.c Revert "Revert "This commit implements the Object Shapes technique in CRuby."" 2022-10-11 08:40:56 -07:00
iseq.h Remove rb_iseq_each 2022-09-01 15:20:49 -07:00
kernel.rb
lex.c.blt reserved_word: just use gperf 3.1 declaration 2022-09-21 11:44:09 +09:00
load.c Rename rb_ary_tmp_new to rb_ary_hidden_new 2022-07-26 09:12:09 -04:00
loadpath.c
localeinit.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
main.c Check only whether `RUBY_DEVEL` is defined 2022-07-12 17:13:57 +09:00
marshal.c Revert "Revert "This commit implements the Object Shapes technique in CRuby."" 2022-10-11 08:40:56 -07:00
marshal.rb [DOC] Document Marshal#load parameter freeze: (#5332) 2021-12-24 09:55:09 +01:00
math.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
memory_view.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
method.h YJIT: Implement specialized respond_to? (#6363) 2022-09-14 16:15:55 -04:00
mini_builtin.c Rework `first_lineno` to be `int`. 2022-09-26 00:41:16 +13:00
miniinit.c
mjit.c Rework vm_core to use `int first_lineno` struct member. 2022-09-26 00:41:16 +13:00
mjit.h Allow hooking a different method after --mjit=pause 2022-09-06 15:52:02 +09:00
mjit.rb Move RubyVM::MJIT to builtin Ruby 2022-06-15 10:52:37 -07:00
mjit_c.rb Only expose Ruby Shape API if VM_CHECK_MODE is enabled 2022-10-13 13:11:01 -07:00
mjit_compiler.c Avoid type limits (#6435) 2022-09-26 09:21:05 +09:00
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 Drop c_64 and c_32 2022-09-23 06:44:28 +09:00
mjit_unit.h Fix an inconsistent include guard macro 2022-08-22 19:28:58 -07:00
nilclass.rb
node.c Move `error` from top_stmts and top_stmt to stmt 2022-10-08 17:59:11 +09:00
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 of Integer#ceildiv 2022-08-12 15:57:52 +09:00
object.c Make inline cache reads / writes atomic with object shapes 2022-10-11 08:40:56 -07:00
pack.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
pack.rb [DOC] Repair format and links in What's Here sections (#5711) 2022-03-25 10:52:06 -05:00
parse.y Do not set `$!` to `SyntaxError` when error tolerant 2022-10-09 19:07:21 +09:00
prelude.rb Make Set a builtin feature [Feature #16989] 2022-02-18 11:56:24 +09:00
probes.d
probes_helper.h Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
proc.c Mark struct METHOD->owner for the GC 2022-10-03 12:03:46 +02:00
process.c Followed up 796069b288 2022-09-22 11:35:28 +09:00
ractor.c obj_refer_only_sharables_p_i: need derefernce 2022-09-21 11:44:09 +09:00
ractor.rb [DOC] Correct article of Ractor's introduction [ci skip] 2022-08-28 16:27:11 +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 Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
range.c rb_int_range_last: properly handle non-exclusive range 2022-09-04 11:16:11 +02:00
rational.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
re.c * expand tabs. [ci skip] 2022-10-10 13:22:15 +09:00
regcomp.c Use `roomof` macro for rounding up divisions 2022-10-14 19:23:25 +09:00
regenc.c
regenc.h Use `roomof` macro for rounding up divisions 2022-10-14 19:23:25 +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 Fix some UBSAN false positives (#6115) 2022-07-12 11:48:10 -07:00
regparse.h
regsyntax.c
ruby-runner.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
ruby.c Allow abbreviated dump options with additional options 2022-10-09 16:27:34 +09:00
ruby_assert.h
ruby_atomic.h
rubystub.c `ruby_init_setproctitle` declaration has moved to internal/missing.h 2022-08-31 15:31:47 +09:00
scheduler.c Improvements to IO::Buffer implementation and documentation. (#6525) 2022-10-12 12:59:05 +13:00
shape.c Only expose Ruby Shape API if VM_CHECK_MODE is enabled 2022-10-13 13:11:01 -07:00
shape.h Make inline cache reads / writes atomic with object shapes 2022-10-11 08:40:56 -07:00
signal.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
siphash.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
siphash.h
sparc.c [DOC]Some link prefix replace 2022-04-09 17:43:46 +09:00
sprintf.c [Bug #18973] Promote US-ASCII to ASCII-8BIT when adding 8-bit char 2022-08-31 17:27:59 +09:00
st.c [Bug #19038] Fix corruption of generic_iv_tbl when compacting 2022-10-06 09:01:12 -04:00
strftime.c
string.c Correcting example for swapcase! method 2022-10-04 10:07:01 +09:00
string.rb [DOC] Fix markup for `String` (#5984) 2022-06-09 13:40:21 -05:00
struct.c fix Data docs (#6497) 2022-10-06 10:13:17 -07:00
symbol.c Implement optimize send in yjit (#6488) 2022-10-11 16:37:05 -04:00
symbol.h Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
thread.c Add IO#timeout attribute and use it for blocking IO operations. (#5653) 2022-10-07 21:48:38 +13:00
thread_none.c GVL Instrumentation: remove the EXITED count assertion 2022-07-13 19:39:31 +02:00
thread_none.h introduce struct `rb_native_thread` 2022-04-23 03:08:27 +09:00
thread_pthread.c Adjust styles [ci skip] 2022-07-27 18:42:27 +09:00
thread_pthread.h altstack is native thread's attr 2022-05-24 17:50:49 +09:00
thread_sync.c Implement SizedQueue#push(timeout: sec) 2022-08-18 10:07:37 +02:00
thread_sync.rb Implement SizedQueue#push(timeout: sec) 2022-08-18 10:07:37 +02:00
thread_win32.c Allow `RUBY_DEBUG_LOG` format to be empty 2022-08-06 10:52:00 +09:00
thread_win32.h `native_tls_get()`' should not check results 2022-05-24 10:06:51 +09:00
time.c [DOC] use the local rdoc reference than the external URI 2022-10-11 16:25:09 +09:00
timev.h
timev.rb [DOC] Enhanced RDoc for Time (#6308) 2022-08-31 16:36:22 -05:00
trace_point.rb Fix comment 2022-03-29 18:14:33 -07:00
transcode.c Using is_broken_string function 2022-09-10 09:32:51 +09:00
transcode_data.h Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
transient_heap.c Refactor macros of array.c 2022-07-21 09:02:45 -04:00
transient_heap.h
util.c [Bug #18997] Don't define ruby_qsort when POSIX qsort_r is available 2022-09-08 17:37:37 +09:00
variable.c Make inline cache reads / writes atomic with object shapes 2022-10-11 08:40:56 -07:00
variable.h Revert "Revert "This commit implements the Object Shapes technique in CRuby."" 2022-10-11 08:40:56 -07:00
version.c Move macros from version.h to version.c 2022-08-31 18:00:45 +09:00
version.h Auto-generate the release date on version.h from git CommitDate (#6382) 2022-09-17 21:16:06 +09:00
vm.c Make inline cache reads / writes atomic with object shapes 2022-10-11 08:40:56 -07:00
vm_args.c Rename rb_ary_tmp_new to rb_ary_hidden_new 2022-07-26 09:12:09 -04:00
vm_backtrace.c Rework vm_core to use `int first_lineno` struct member. 2022-09-26 00:41:16 +13:00
vm_callinfo.h Prevent wrong integer expansion 2022-10-13 08:14:04 -07:00
vm_core.h Improvements to IO::Buffer implementation and documentation. (#6525) 2022-10-12 12:59:05 +13:00
vm_debug.h Allow `RUBY_DEBUG_LOG` format to be empty 2022-08-06 10:52:00 +09:00
vm_dump.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07: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 Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
vm_exec.h Add ISEQ_BODY macro 2022-03-24 10:03:51 -04:00
vm_insnhelper.c Initialize shape attr index also in non-markable CC 2022-10-12 09:14:55 -07:00
vm_insnhelper.h Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
vm_method.c Rework vm_core to use `int first_lineno` struct member. 2022-09-26 00:41:16 +13:00
vm_opts.h
vm_sync.c Fix format specifier for `rb_ractor_id()` 2022-07-28 23:46:06 +09:00
vm_sync.h `USE_RUBY_DEBUG_LOG` doesn't check `RUBY_DEVEL` 2021-12-29 00:22:02 +09:00
vm_trace.c Expand tabs [ci skip] 2022-07-21 09:42:04 -07:00
vsnprintf.c [Feature #18491] Drop support for HP-UX 2022-01-18 09:52:15 -05:00
warning.rb
yjit.c Implement optimize send in yjit (#6488) 2022-10-11 16:37:05 -04:00
yjit.h New constant caching insn: opt_getconstant_path 2022-09-01 15:20:49 -07:00
yjit.rb Speed up --yjit-trace-exits code (#6106) 2022-07-12 16:40:49 -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.

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