1
0
Fork 0
mirror of https://github.com/ruby/ruby.git synced 2022-11-09 12:17:21 -05:00
The Ruby Programming Language [mirror]
Find a file
David Rodríguez d767da428c
[rubygems/rubygems] Fix require issue with file extension priority
If `require "a"` is run when two folders have been specified in the -I
option including a "a.rb" file and a "a.so" file respectively, the ruby
spec says that the ".rb" file should always be preferred. However, the
logic we added in https://github.com/rubygems/rubygems/commit/6b81076d9
to make the -I option always beat default gems does not respect this
spec, creating a difference from the original ruby-core's require.

[the ruby spec says]: d80a6e2b22/core/kernel/shared/require.rb (L234-L246)

https://github.com/rubygems/rubygems/commit/b3944384f4
2020-02-06 21:57:18 +09:00
.github Allow rexml to fail on macOS of Github Actions 2020-01-19 11:56:39 +09:00
basictest Fixed misspellings 2019-12-20 09:32:42 +09:00
benchmark Improve String#slice! performance 2020-01-31 17:12:05 +09:00
bin Removed the old executables of racc 2020-01-01 07:42:42 +09:00
bootstraptest Remove special handling of $SAFE and related C-APIs 2020-01-22 09:09:47 -08:00
ccan Fix typos [ci skip] 2019-10-14 17:30:04 +09:00
coroutine function pointers are not void* 2020-02-06 11:46:51 +09:00
coverage
cygwin
defs config.status should be newer than config.cache if exists 2020-01-08 18:35:21 +09:00
doc fix rdoc formatting [ci skip] 2020-02-01 23:06:33 +09:00
enc update dependencies 2019-12-26 20:45:12 +09:00
ext Add call-seq to Pathname#open from File.open 2020-02-04 20:56:13 +09:00
gems Removed xmlrpc and net-telnet from the bundled gems. 2020-01-16 16:56:53 +09:00
include Parenthesized macro arguments 2020-02-03 14:19:02 +09:00
internal Extract a function, ruby_reset_timezone(). 2020-01-28 23:40:25 +09:00
lib [rubygems/rubygems] Fix require issue with file extension priority 2020-02-06 21:57:18 +09:00
libexec Removed the old executables of racc 2020-01-01 07:42:42 +09:00
man Merge bundler-2.1.4 2020-01-08 18:00:32 +09:00
misc Fixed misspellings 2019-12-20 09:32:42 +09:00
missing internal/stdbool.h rework 2019-12-26 20:45:12 +09:00
sample Fixed misspellings 2019-12-20 09:32:42 +09:00
spec [ruby/spec] Don't care about return values 2020-02-06 15:42:36 +09:00
template add predefined macros for Doxygen 2020-02-06 11:46:51 +09:00
test [rubygems/rubygems] Fix require issue with file extension priority 2020-02-06 21:57:18 +09:00
tool Fix readline-ext sync 2020-02-06 21:20:20 +09:00
win32 support C++ std::nullptr_t 2020-01-31 13:01:52 +09:00
.dir-locals.el emacs mode addition 2020-02-06 11:46:51 +09:00
.document NEWS.md: converted from NEWS 2020-01-15 12:42:47 +09:00
.editorconfig
.gdbinit Redmine /projects/ruby-trunk is now redirected 2019-12-31 22:06:19 -08:00
.gitattributes
.gitignore Check -1 arity for C++ 2019-11-22 18:42:49 +09:00
.rspec_parallel
.travis.yml Run specs on Ruby 2.7 too to make sure they keep passing 2020-01-28 18:37:42 +01:00
aclocal.m4
addr2line.c internal/stdbool.h rework 2019-12-26 20:45:12 +09:00
addr2line.h
appveyor.yml Remove code to prevent double build on trunk 2019-12-31 22:03:21 -08:00
array.c Moved Array#sample to rbinc 2020-01-26 19:45:58 +09:00
array.rb Removed useless shebang and executable bit [ci skip] 2020-02-01 23:25:46 +09:00
ast.c Separate builtin initialization calls 2019-12-29 12:34:55 +09:00
ast.rb Fix variable name and add more example [ci skip] 2020-01-03 01:27:25 +09:00
bignum.c bignum.c: extract bdigits_to_mpz and bdigits_from_mpz (#2805) 2020-01-01 22:55:12 +09:00
BSDL [ruby/irb] Reformat LICENSE.txt [ci skip] 2020-02-02 03:22:51 +09:00
builtin.c take care of USE_LAZY_LOAD=1. 2019-12-25 14:12:33 +09:00
builtin.h readable function names for inline functions. 2019-12-13 17:55:45 +09:00
class.c Make rb_scan_args_kw inline too 2020-02-03 13:07:34 +09:00
common.mk Fix file dependency in make 2020-01-28 16:11:53 -05:00
compar.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
compile.c Check type of empty keyword [Bug #16603] 2020-02-03 17:54:44 +09:00
complex.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
configure.ac support C++ std::nullptr_t 2020-01-31 13:01:52 +09:00
constant.h decouple internal.h headers 2019-12-26 20:45:12 +09:00
cont.c Let execution context local storage be an ID table 2020-01-11 14:40:36 +13:00
CONTRIBUTING.md
COPYING
COPYING.ja
debug.c move internal/debug.h definitions to internal.h 2020-01-03 04:46:51 +09:00
debug_counter.c add debug_counter access functions. 2019-12-25 01:34:41 +09:00
debug_counter.h debug_counter.h must be self-contained 2019-12-26 20:45:12 +09:00
dir.c Fixed double closedir 2020-01-20 09:49:27 +09:00
dln.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
dln.h decouple internal.h headers 2019-12-26 20:45:12 +09:00
dln_find.c
dmydln.c
dmyenc.c
dmyext.c
encindex.h decouple internal.h headers 2019-12-26 20:45:12 +09:00
encoding.c Fix description of Encoding.default_(in|ex)ternal 2020-02-03 08:42:01 -08:00
enum.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
enumerator.c Fully separate positional arguments and keyword arguments 2020-01-02 18:40:45 -08:00
error.c Added rb_warn_deprecated_to_remove 2020-01-23 21:42:15 +09:00
eval.c Fully separate positional arguments and keyword arguments 2020-01-02 18:40:45 -08:00
eval_error.c
eval_intern.h Create backtrace location array directly 2019-12-13 20:47:07 +09:00
eval_jump.c
file.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
gc.c Removed type-punning pointer casts around st_data_t 2020-01-31 12:13:00 +09:00
gc.h Rename RUBY_MARK_NO_PIN_UNLESS_NULL to RUBY_MARK_MOVABLE_UNLESS_NULL 2020-01-23 00:11:03 +13:00
gc.rb Fix call-seq of GC.verify_compaction_references [ci skip] 2020-01-27 18:58:39 +09:00
gem_prelude.rb Do not call 'gem "did_you_mean"' for now 2019-11-30 21:08:19 -05:00
golf_prelude.rb
goruby.c
GPL
hash.c Extract a function, ruby_reset_timezone(). 2020-01-28 23:40:25 +09:00
hrtime.h
id_table.c Revert https://github.com/ruby/ruby/pull/2486 2019-10-03 12:45:24 +09:00
id_table.h decouple internal.h headers 2019-12-26 20:45:12 +09:00
inits.c Moved Array#shuffle and Array#shuffle! to rbinc 2020-01-26 19:40:34 +09:00
insns.def Fixed a typo, missing "i" [ci skip] 2020-01-27 16:23:52 +09:00
internal.h move internal/debug.h definitions to internal.h 2020-01-03 04:46:51 +09:00
io.c Drop executable bit set by 25f2005a63 2020-01-22 08:54:49 +09:00
io.rb Define IO#read/write_nonblock with builtins. 2019-11-08 10:03:19 +09:00
iseq.c this ternary operator is an undefined behaviour 2020-02-06 11:46:51 +09:00
iseq.h decouple internal.h headers 2019-12-26 20:45:12 +09:00
KNOWNBUGS.rb
LEGAL
lex.c.blt
load.c Add the loaded feature after no exception raised 2020-02-04 16:10:39 +09:00
loadpath.c
localeinit.c
main.c
marshal.c marshal.c: Support dump and load of a Hash with the ruby2_keywords flag 2020-01-17 17:20:19 +09:00
math.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
method.h decouple internal.h headers 2019-12-26 20:45:12 +09:00
mini_builtin.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
miniinit.c support builtin features with Ruby and C. 2019-11-08 09:09:29 +09:00
mjit.c function pointers are not void* 2020-02-06 11:46:51 +09:00
mjit.h decouple internal.h headers 2019-12-26 20:45:12 +09:00
mjit_compile.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
mjit_worker.c Allow specifying arbitrary MJIT flags by --jit-debug 2019-12-01 00:58:47 -08:00
NEWS.md Add #verify_hostname= and #verify_hostname to skip hostname verification 2020-01-24 15:17:02 +09:00
node.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
node.h Deprecate taint/trust and related methods, and make the methods no-ops 2019-11-18 01:00:25 +02:00
numeric.c Check the encoding of half: option 2020-01-27 16:12:15 +09:00
object.c [DOC] fixed line numbers [ci skip] 2020-01-24 09:46:34 +09:00
pack.c Separate builtin initialization calls 2019-12-29 12:34:55 +09:00
pack.rb Rubified the APIs of pack.c 2019-11-08 23:51:51 +09:00
parse.y Do not warn CR inside string literal 2020-02-04 14:41:52 +09:00
prelude.rb Define IO#read/write_nonblock with builtins. 2019-11-08 10:03:19 +09:00
probes.d
probes_helper.h internal/vm.h rework 2019-12-26 20:45:12 +09:00
proc.c Fix wrong return value in proc documentation. 2020-01-30 12:35:15 -08:00
process.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
random.c Ensure seed data to be cleared 2020-01-10 10:28:49 +09:00
range.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
rational.c rb_rational_raw: convert num and den by to_int 2020-01-17 10:57:51 +09:00
re.c Regexp in MatchData can be nil 2020-01-16 11:32:11 +09:00
README.EXT
README.EXT.ja
README.ja.md README*.md: defines.h moved [ci skip] 2020-02-01 00:38:38 +09:00
README.md README*.md: defines.h moved [ci skip] 2020-02-01 00:38:38 +09:00
regcomp.c
regenc.c
regenc.h
regerror.c
regexec.c
regint.h
regparse.c Fixed misspellings 2019-12-20 09:32:42 +09:00
regparse.h
regsyntax.c
ruby-runner.c
ruby.c io.c, ruby.c: include internal/variable.h for rb_gvar_readonly_setter 2020-01-09 23:57:46 +09:00
ruby_assert.h
ruby_atomic.h fine-grained #ifdef guard for Sparc systems 2020-02-06 11:46:51 +09:00
rubystub.c
signal.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
siphash.c
siphash.h
sparc.c
sprintf.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
st.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
strftime.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
string.c Improve String#slice! performance 2020-01-31 17:12:05 +09:00
struct.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
symbol.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
symbol.h decouple internal.h headers 2019-12-26 20:45:12 +09:00
thread.c st_delete_wrap is no longer used 2020-01-11 10:43:39 +09:00
thread_pthread.c
thread_pthread.h
thread_sync.c add assertion for mutex_lock. 2019-10-28 12:19:18 +09:00
thread_win32.c
thread_win32.h
time.c ruby_reset_timezone resets leap_second_info. 2020-01-29 00:01:57 +09:00
timev.h decouple internal.h headers 2019-12-26 20:45:12 +09:00
trace_point.rb Fix output of example [ci skip] 2020-01-05 00:52:43 +09:00
transcode.c Warn when :newline precedes other newline options 2020-01-11 10:42:22 +09:00
transcode_data.h
transient_heap.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
transient_heap.h
util.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
variable.c Use rb_gc_mark when marking globals 2020-01-30 08:23:07 -08:00
variable.h fastpath for ivar read of FL_EXIVAR objects. 2019-11-29 03:11:04 +09:00
version.c Provides ruby2_keywords 2019-10-23 00:19:25 +09:00
version.h * 2020-02-06 [ci skip] 2020-02-06 10:38:41 +09:00
vm.c Increase the frozen_strings table initial size 2020-02-06 10:38:21 +09:00
vm_args.c Do not autosplat when calling proc with empty keyword splat 2020-01-24 13:04:14 -08:00
vm_backtrace.c decouple internal.h headers 2019-12-26 20:45:12 +09:00
vm_core.h rb_vm_t::postponed_job_index shall be rb_atomic_t 2020-02-06 11:46:51 +09:00
vm_debug.h
vm_dump.c support RUBY_ON_BUG envval on assert failure. 2020-01-06 15:06:03 +09:00
vm_eval.c script_compiled event on compile error. 2020-01-06 11:36:51 +09:00
vm_exec.c Add VM insns counter like debug_counter (#2789) 2019-12-28 00:44:09 -08:00
vm_exec.h Add VM insns counter like debug_counter (#2789) 2019-12-28 00:44:09 -08:00
vm_insnhelper.c support MJIT with debug option. 2020-02-03 16:57:41 +09:00
vm_insnhelper.h per-method serial number 2019-12-18 12:52:28 +09:00
vm_method.c VALUE is narrower than rb_serial_t 2020-01-21 14:21:15 +09:00
vm_opts.h Use cppflags to pass preprocessor options 2019-10-23 02:53:36 +09:00
vm_trace.c rb_vm_t::postponed_job_index shall be rb_atomic_t 2020-02-06 11:46:51 +09:00
vsnprintf.c
warning.rb Fix a typo [ci skip] 2020-01-02 12:12:05 +09:00

Build Status Build status Actions Status Actions Status Actions Status Actions Status Actions Status

What's 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, Haiku, etc.) cf. https://github.com/ruby/ruby/blob/master/doc/contributing.rdoc#platform-maintainers

How to get Ruby

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

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

Git

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.

Subversion

Stable branches for older Ruby versions can be checked out with the following command:

$ svn co https://svn.ruby-lang.org/repos/ruby/branches/ruby_2_6/ ruby

Try the following command to see the list of branches:

$ svn ls https://svn.ruby-lang.org/repos/ruby/branches/

Ruby home page

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

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.

How to compile and install

  1. If you want to use Microsoft Visual C++ to compile Ruby, read win32/README.win32 instead of this document.

  2. If ./configure does not exist or is older than configure.ac, run autoconf to (re)generate configure.

  3. Run ./configure, which will generate config.h and Makefile.

    Some C compiler flags may be added by default depending on your environment. Specify optflags=.. and warnflags=.. as necessary to override them.

  4. Edit include/ruby/defines.h if you need. Usually this step will not be needed.

  5. Remove comment mark(#) before the module names from ext/Setup (or add module names if not present), if you want to link modules statically.

    If you don't want to compile non static extension modules (probably on architectures which do not allow dynamic loading), remove comment mark from the line "#option nodynamic" in ext/Setup.

    Usually this step will not be needed.

  6. Run make.

    • On Mac, set RUBY_CODESIGN environment variable with a signing identity. It uses the identity to sign ruby binary. See also codesign(1).
  7. Optionally, run 'make check' to check whether the compiled Ruby interpreter works well. If you see the message "check succeeded", your Ruby works as it should (hopefully).

  8. Optionally, run make update-gems and make extract-gems.

    If you want to install bundled gems, run make update-gems and make extract-gems before running make install.

  9. Run 'make install'.

    This command will create the following directories and install files into them.

    • ${DESTDIR}${prefix}/bin
    • ${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}
    • ${DESTDIR}${prefix}/include/ruby-${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}
    • ${DESTDIR}${prefix}/lib
    • ${DESTDIR}${prefix}/lib/ruby
    • ${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}
    • ${DESTDIR}${prefix}/lib/ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}
    • ${DESTDIR}${prefix}/lib/ruby/site_ruby
    • ${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}
    • ${DESTDIR}${prefix}/lib/ruby/site_ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}
    • ${DESTDIR}${prefix}/lib/ruby/vendor_ruby
    • ${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}
    • ${DESTDIR}${prefix}/lib/ruby/vendor_ruby/${MAJOR}.${MINOR}.${TEENY}/${PLATFORM}
    • ${DESTDIR}${prefix}/lib/ruby/gems/${MAJOR}.${MINOR}.${TEENY}
    • ${DESTDIR}${prefix}/share/man/man1
    • ${DESTDIR}${prefix}/share/ri/${MAJOR}.${MINOR}.${TEENY}/system

    If Ruby's API version is 'x.y.z', the ${MAJOR} is 'x', the ${MINOR} is 'y', and the ${TEENY} is 'z'.

    NOTE: teeny of the API version may be different from one of Ruby's program version

    You may have to be a super user to install Ruby.

If you fail to compile Ruby, please send the detailed error report with the error log and machine/OS type, to help others.

Some extension libraries may not get compiled because of lack of necessary external libraries and/or headers, then you will need to run 'make distclean-ext' to remove old configuration after installing them in such case.

Copying

See the file COPYING.

Feedback

Questions about the Ruby language can be asked on the Ruby-Talk mailing list (https://www.ruby-lang.org/en/community/mailing-lists) or on websites like (https://stackoverflow.com).

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

Contributing

See the file CONTRIBUTING.md

The Author

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

matz@ruby-lang.org