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
Jean Boussier 60defe0a68 thread_sync.c: Clarify and document the behavior of timeout == 0
[Feature #18982]

Instead of introducing an `exception: false` argument to have `non_block`
return nil rather than raise, we can clearly document that a timeout of 0
immediately returns.

The code is refactored a bit to avoid doing a time calculation in
such case.
2022-10-17 16:56:00 +02:00
.github Disable dependabot for auto-request-review for now 2022-10-16 22:47:49 -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 Add test for ractor race condition on ivar sets 2022-10-14 11:59:36 -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 [DOC] Packed data (#6520) 2022-10-15 10:53:08 -05:00
enc reserved_word: just use gperf 3.1 declaration 2022-09-21 11:44:09 +09:00
ext [ruby/openssl] add document-method for BN#mod_inverse 2022-10-17 23:38:35 +09:00
gems Update bundled gems list at 2022-10-16 2022-10-16 18:22:20 +09:00
include Update Fiber::Scheduler documentation. (#6562) 2022-10-15 21:43:45 +13:00
internal YJIT doesn't need rb_obj_ensure_iv_index_mapping 2022-10-14 17:14:41 -07:00
lib [ruby/delegate] Fix DelegateClass block "method redefined" warning 2022-10-15 00:08:44 +09: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 thread_sync.c: Clarify and document the behavior of timeout == 0 2022-10-17 16:56:00 +02:00
template Extract RUBY_RELEASE_DATE from also revision.h 2022-09-25 22:40:05 +09:00
test [ruby/openssl] add BN#mod_sqrt 2022-10-17 23:38:34 +09: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 YJIT doesn't need rb_obj_ensure_iv_index_mapping 2022-10-14 17:14:41 -07:00
.appveyor.yml Leave only the oldest Visual Studio in AppVeyor (#6561) 2022-10-16 22:02:47 -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
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
BSDL
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 [DOC] Add the polar form in String#to_c 2022-10-17 12:02:34 +09:00
configure.ac Remove wrong dollar 2022-10-15 01:03:47 +09:00
constant.h
cont.c Update Fiber::Scheduler documentation. (#6562) 2022-10-15 21:43:45 +13:00
CONTRIBUTING.md Improve documentation on contributing to Ruby 2022-05-11 10:59:24 -04:00
COPYING
COPYING.ja
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 Fix possible use of undefined macros on very old macOS [ci skip] 2022-10-17 18:36:08 +09: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 Fix possible use of undefined macros on very old macOS [ci skip] 2022-10-17 18:36:08 +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 More precisely iterate over Object instance variables 2022-10-15 10:44:10 -07: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
GPL
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 Update Fiber::Scheduler documentation. (#6562) 2022-10-15 21:43:45 +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
KNOWNBUGS.rb
LEGAL LEGAL: mention error_highlight 2021-12-13 14:21:29 +09:00
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
NEWS.md Update default gems list at 6166fa612c [ci skip] 2022-10-17 07:43:51 +00: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 More precisely iterate over Object instance variables 2022-10-15 10:44:10 -07: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 Respect USE_COMMON_RANDOM macro by a command line option [ci skip] 2022-10-17 18:36:09 +09: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
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 Add link to how to build Ruby 2022-09-14 17:30:10 +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 Update Fiber::Scheduler documentation. (#6562) 2022-10-15 21:43:45 +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 More precisely iterate over Object instance variables 2022-10-15 10:44:10 -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 Fix possible use of undefined macros on very old macOS [ci skip] 2022-10-17 18:36:08 +09:00
thread_pthread.h altstack is native thread's attr 2022-05-24 17:50:49 +09:00
thread_sync.c thread_sync.c: Clarify and document the behavior of timeout == 0 2022-10-17 16:56:00 +02: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 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 More precisely iterate over Object instance variables 2022-10-15 10:44:10 -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 More precisely iterate over Object instance variables 2022-10-15 10:44:10 -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 YJIT: Avoid creating payloads for non-JITed ISEQs (#6549) 2022-10-14 12:45:00 -07:00

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