docspring 3.0.0 → 3.2.0

data/vendor/bundle/ruby/3.4.0/gems/byebug-12.0.0/README.md

@@ -0,0 +1,197 @@
+# Byebug
+
+[![Version][gem]][gem_url]
+[![Tidelift][tid]][tid_url]
+[![Gitter][irc]][irc_url]
+
+[gem]: https://img.shields.io/gem/v/byebug.svg
+[tid]: https://tidelift.com/badges/package/rubygems/byebug
+[irc]: https://img.shields.io/badge/IRC%20(gitter)-devs%20%26%20users-brightgreen.svg
+
+[gem_url]: https://rubygems.org/gems/byebug
+[tid_url]: https://tidelift.com/subscription/pkg/rubygems-byebug?utm_source=rubygems-byebug&utm_medium=readme_badge
+[irc_url]: https://gitter.im/deivid-rodriguez/byebug
+
+Byebug is a simple to use and feature rich debugger for Ruby. It uses the
+TracePoint API for execution control and the Debug Inspector API for call stack
+navigation. Therefore, Byebug doesn't depend on internal core sources. Byebug is also
+fast because it is developed as a C extension and reliable because it is supported
+by a full test suite.
+
+The debugger permits the ability to understand what is going on _inside_ a Ruby program
+while it executes and offers many of the traditional debugging features such as:
+
+* Stepping: Running your program one line at a time.
+* Breaking: Pausing the program at some event or specified instruction, to
+  examine the current state.
+* Evaluating: Basic REPL functionality, although [pry] does a better job at
+  that.
+* Tracking: Keeping track of the different values of your variables or the
+  different lines executed by your program.
+
+## For enterprise
+
+Byebug for enterprise is available via the Tidelift Subscription. [Learn
+more][Tidelift for enterprise].
+
+## Build Status
+
+![ubuntu](https://github.com/deivid-rodriguez/byebug/workflows/ubuntu/badge.svg)
+![windows](https://github.com/deivid-rodriguez/byebug/workflows/windows/badge.svg)
+
+## Requirements
+
+* _Required_: MRI 3.1.0 or higher.
+
+## Install
+
+```shell
+gem install byebug
+```
+
+Alternatively, if you use `bundler`:
+
+```shell
+bundle add byebug --group "development, test"
+```
+
+## Usage
+
+### From within the Ruby code
+
+Simply include `byebug` wherever you want to start debugging and the execution will
+stop there. For example, if you were debugging Rails, you would add `byebug` to
+your code:
+
+```ruby
+def index
+  byebug
+  @articles = Article.find_recent
+end
+```
+
+And then start a Rails server:
+
+```shell
+bin/rails s
+```
+
+Once the execution gets to your `byebug` command, you will receive a debugging prompt.
+
+### From the command line
+
+If you want to debug a Ruby script without editing it, you can invoke byebug from the command line.
+
+```shell
+byebug myscript.rb
+```
+
+## Byebug's commands
+
+Command     | Aliases         | Subcommands
+-------     | -------         | -----------
+`backtrace` | `bt` `w` `where`|
+`break`     | `b`             |
+`catch`     | `cat`           |
+`condition` | `cond`          |
+`continue`  | `c` `cont`      |
+`continue!` | `c!` `cont!`    |
+`debug`     |                 |
+`delete`    | `del`           |
+`disable`   | `dis`           | `breakpoints` `display`
+`display`   | `disp`          |
+`down`      |                 |
+`edit`      | `ed`            |
+`enable`    | `en`            | `breakpoints` `display`
+`finish`    | `fin`           |
+`frame`     | `f`             |
+`help`      | `h`             |
+`history`   | `hist`          |
+`info`      | `i`             | `args` `breakpoints` `catch` `display` `file` `line` `program`
+`interrupt` | `int`           |
+`irb`       |                 |
+`kill`      |                 |
+`list`      | `l`             |
+`method`    | `m`             | `instance`
+`next`      | `n`             |
+`pry`       |                 |
+`quit`      | `q`             |
+`quit!`     | `q!`            |
+`restart`   |                 |
+`save`      | `sa`            |
+`set`       |                 | `autoirb` `autolist` `autopry` `autosave` `basename` `callstyle` `fullpath` `histfile` `histsize` `linetrace` `listsize` `post_mortem` `savefile` `stack_on_error` `width`
+`show`      |                 | `autoirb` `autolist` `autopry` `autosave` `basename` `callstyle` `fullpath` `histfile` `histsize` `linetrace` `listsize` `post_mortem` `savefile` `stack_on_error` `width`
+`skip`      | `sk`            |
+`source`    | `so`            |
+`step`      | `s`             |
+`thread`    | `th`            | `current` `list` `resume` `stop` `switch`
+`tracevar`  | `tr`            |
+`undisplay` | `undisp`        |
+`untracevar`| `untr`          |
+`up`        |                 |
+`var`       | `v`             | `all` `constant` `global` `instance` `local`
+
+## Semantic Versioning
+
+Byebug attempts to follow [semantic versioning](https://semver.org) and
+bump major version only when backwards incompatible changes are released.
+Backwards compatibility is targeted to [pry-byebug] and any other plugins
+relying on `byebug`.
+
+## Getting Started
+
+Read [byebug's markdown
+guide](https://github.com/deivid-rodriguez/byebug/blob/master/GUIDE.md) to get
+started. Proper documentation will be eventually written.
+
+## Related projects
+
+* [pry-byebug] adds `next`, `step`, `finish`, `continue` and `break` commands
+  to `pry` using `byebug`.
+* [ruby-debug-passenger] adds a rake task that restarts Passenger with Byebug
+  connected.
+* [minitest-byebug] starts a byebug session on minitest failures.
+* [sublime_debugger] provides a plugin for ruby debugging on Sublime Text.
+* [atom-byebug] provides integration with the Atom editor [EXPERIMENTAL].
+
+## Contribute
+
+See [Getting Started with Development](CONTRIBUTING.md).
+
+## Funding
+
+Subscribe to [Tidelift][Tidelift support] to ensure byebug stays actively
+maintained, and at the same time get licensing assurances and timely security
+notifications for your open source dependencies.
+
+You can also help `byebug` by leaving a small (or big) tip through [Liberapay].
+
+## Security contact information
+
+Please use the Tidelift security contact to [report a security vulnerability].
+Tidelift will coordinate the fix and disclosure.
+
+## Credits
+
+Everybody who has ever contributed to this forked and reforked piece of
+software, especially:
+
+* @ko1, author of the awesome TracePoint API for Ruby.
+* @cldwalker, [debugger]'s maintainer.
+* @denofevil, author of [debase], the starting point of this.
+* @kevjames3 for testing, bug reports and the interest in the project.
+* @FooBarWidget for working and helping with remote debugging.
+
+[debugger]: https://github.com/cldwalker/debugger
+[pry]: https://github.com/pry/pry
+[debase]: https://github.com/denofevil/debase
+[pry-byebug]: https://github.com/deivid-rodriguez/pry-byebug
+[ruby-debug-passenger]: https://github.com/davejamesmiller/ruby-debug-passenger
+[minitest-byebug]: https://github.com/kaspth/minitest-byebug
+[sublime_debugger]: https://github.com/shuky19/sublime_debugger
+[atom-byebug]: https://github.com/izaera/atom-byebug
+[Liberapay]: https://liberapay.com/byebug/donate
+[Tidelift]: https://tidelift.com/subscription/pkg/rubygems-byebug?utm_source=rubygems-byebug&utm_medium=readme_text
+[Tidelift for enterprise]: https://tidelift.com/subscription/pkg/rubygems-byebug?utm_source=rubygems-byebug&utm_medium=referral&utm_campaign=github&utm_content=enterprise
+[Tidelift support]: https://tidelift.com/subscription/pkg/rubygems-byebug?utm_source=rubygems-byebug&utm_medium=referral&utm_campaign=github&utm_content=support
+[report a security vulnerability]: https://tidelift.com/security

data/vendor/bundle/ruby/3.4.0/gems/byebug-12.0.0/ext/byebug/Makefile

@@ -0,0 +1,273 @@
+
+SHELL = /bin/sh
+
+# V=0 quiet, V=1 verbose.  other values don't work.
+V = 0
+V0 = $(V:0=)
+Q1 = $(V:1=)
+Q = $(Q1:0=@)
+ECHO1 = $(V:1=@ :)
+ECHO = $(ECHO1:0=@ echo)
+NULLCMD = :
+
+#### Start of system configuration section. ####
+
+srcdir = .
+topdir = /Users/ndbroadbent/.local/share/mise/installs/ruby/3.4.6/include/ruby-3.4.0
+hdrdir = $(topdir)
+arch_hdrdir = /Users/ndbroadbent/.local/share/mise/installs/ruby/3.4.6/include/ruby-3.4.0/arm64-darwin24
+PATH_SEPARATOR = :
+VPATH = $(srcdir):$(arch_hdrdir)/ruby:$(hdrdir)/ruby
+prefix = $(DESTDIR)/Users/ndbroadbent/.local/share/mise/installs/ruby/3.4.6
+rubysitearchprefix = $(rubylibprefix)/$(sitearch)
+rubyarchprefix = $(rubylibprefix)/$(arch)
+rubylibprefix = $(libdir)/$(RUBY_BASE_NAME)
+exec_prefix = $(prefix)
+vendorarchhdrdir = $(vendorhdrdir)/$(sitearch)
+sitearchhdrdir = $(sitehdrdir)/$(sitearch)
+rubyarchhdrdir = $(rubyhdrdir)/$(arch)
+vendorhdrdir = $(rubyhdrdir)/vendor_ruby
+sitehdrdir = $(rubyhdrdir)/site_ruby
+rubyhdrdir = $(includedir)/$(RUBY_VERSION_NAME)
+vendorarchdir = $(vendorlibdir)/$(sitearch)
+vendorlibdir = $(vendordir)/$(ruby_version)
+vendordir = $(rubylibprefix)/vendor_ruby
+sitearchdir = $(sitelibdir)/$(sitearch)
+sitelibdir = $(sitedir)/$(ruby_version)
+sitedir = $(rubylibprefix)/site_ruby
+rubyarchdir = $(rubylibdir)/$(arch)
+rubylibdir = $(rubylibprefix)/$(ruby_version)
+sitearchincludedir = $(includedir)/$(sitearch)
+archincludedir = $(includedir)/$(arch)
+sitearchlibdir = $(libdir)/$(sitearch)
+archlibdir = $(libdir)/$(arch)
+ridir = $(datarootdir)/$(RI_BASE_NAME)
+modular_gc_dir = $(DESTDIR)
+mandir = $(datarootdir)/man
+localedir = $(datarootdir)/locale
+libdir = $(exec_prefix)/lib
+psdir = $(docdir)
+pdfdir = $(docdir)
+dvidir = $(docdir)
+htmldir = $(docdir)
+infodir = $(datarootdir)/info
+docdir = $(datarootdir)/doc/$(PACKAGE)
+oldincludedir = $(DESTDIR)/usr/include
+includedir = $(SDKROOT)$(prefix)/include
+runstatedir = $(localstatedir)/run
+localstatedir = $(prefix)/var
+sharedstatedir = $(prefix)/com
+sysconfdir = $(prefix)/etc
+datadir = $(datarootdir)
+datarootdir = $(prefix)/share
+libexecdir = $(exec_prefix)/libexec
+sbindir = $(exec_prefix)/sbin
+bindir = $(exec_prefix)/bin
+archdir = $(rubyarchdir)
+
+
+CC_WRAPPER = 
+CC = clang
+CXX = clang++
+LIBRUBY = $(LIBRUBY_SO)
+LIBRUBY_A = lib$(RUBY_SO_NAME)-static.a
+LIBRUBYARG_SHARED = -l$(RUBY_SO_NAME)
+LIBRUBYARG_STATIC = -l$(RUBY_SO_NAME)-static -framework CoreFoundation $(MAINLIBS)
+empty =
+OUTFLAG = -o $(empty)
+COUTFLAG = -o $(empty)
+CSRCFLAG = $(empty)
+
+RUBY_EXTCONF_H = 
+cflags   = $(hardenflags) -fdeclspec  $(optflags) $(debugflags) $(warnflags)
+cxxflags = 
+optflags = -O3 -fno-fast-math
+debugflags = -ggdb3
+warnflags = -Wall -Wextra -Wextra-tokens -Wdeprecated-declarations -Wdivision-by-zero -Wdiv-by-zero -Wimplicit-function-declaration -Wimplicit-int -Wpointer-arith -Wshorten-64-to-32 -Wwrite-strings -Wold-style-definition -Wmissing-noreturn -Wno-cast-function-type -Wno-constant-logical-operand -Wno-long-long -Wno-missing-field-initializers -Wno-overlength-strings -Wno-parentheses-equality -Wno-self-assign -Wno-tautological-compare -Wno-unused-parameter -Wno-unused-value -Wunused-variable -Wmisleading-indentation -Wundef
+cppflags = 
+CCDLFLAGS = -fno-common
+CFLAGS   = $(CCDLFLAGS) $(cflags) -fno-common -pipe $(ARCH_FLAG)
+INCFLAGS = -I. -I$(arch_hdrdir) -I$(hdrdir)/ruby/backward -I$(hdrdir) -I$(srcdir)
+DEFS     = 
+CPPFLAGS =   -I/opt/homebrew/opt/zstd/include -D_XOPEN_SOURCE -D_DARWIN_C_SOURCE -D_DARWIN_UNLIMITED_SELECT -D_REENTRANT $(DEFS) $(cppflags)
+CXXFLAGS = $(CCDLFLAGS) -fdeclspec $(ARCH_FLAG)
+ldflags  = -L.  -L/opt/homebrew/opt/zstd/lib -fstack-protector-strong -L/opt/homebrew/Cellar/gmp/6.3.0/lib
+dldflags =  -L/opt/homebrew/opt/zstd/lib -L/opt/homebrew/Cellar/gmp/6.3.0/lib -Wl,-undefined,dynamic_lookup 
+ARCH_FLAG = -arch arm64
+DLDFLAGS = $(ldflags) $(dldflags) $(ARCH_FLAG)
+LDSHARED = $(CC) -dynamic -bundle
+LDSHAREDXX = $(CXX) -dynamic -bundle
+POSTLINK = dsymutil $@ 2>/dev/null; { test -z '$(RUBY_CODESIGN)' || codesign -s '$(RUBY_CODESIGN)' $@; }
+AR = ar
+LD = ld
+EXEEXT = 
+
+RUBY_INSTALL_NAME = $(RUBY_BASE_NAME)
+RUBY_SO_NAME = ruby.3.4
+RUBYW_INSTALL_NAME = 
+RUBY_VERSION_NAME = $(RUBY_BASE_NAME)-$(ruby_version)
+RUBYW_BASE_NAME = rubyw
+RUBY_BASE_NAME = ruby
+
+arch = arm64-darwin24
+sitearch = $(arch)
+ruby_version = 3.4.0
+ruby = $(bindir)/$(RUBY_BASE_NAME)
+RUBY = $(ruby)
+BUILTRUBY = $(bindir)/$(RUBY_BASE_NAME)
+ruby_headers = $(hdrdir)/ruby.h $(hdrdir)/ruby/backward.h $(hdrdir)/ruby/ruby.h $(hdrdir)/ruby/defines.h $(hdrdir)/ruby/missing.h $(hdrdir)/ruby/intern.h $(hdrdir)/ruby/st.h $(hdrdir)/ruby/subst.h $(arch_hdrdir)/ruby/config.h
+
+RM = rm -f
+RM_RF = rm -fr
+RMDIRS = rmdir --ignore-fail-on-non-empty -p
+MAKEDIRS = /opt/homebrew/opt/coreutils/libexec/gnubin/mkdir -p
+INSTALL = /opt/homebrew/opt/coreutils/libexec/gnubin/install -c
+INSTALL_PROG = $(INSTALL) -m 0755
+INSTALL_DATA = $(INSTALL) -m 644
+COPY = cp
+TOUCH = exit >
+
+#### End of system configuration section. ####
+
+preload = 
+libpath = . $(libdir)
+LIBPATH = -L. -L$(libdir)
+DEFFILE = 
+
+CLEANFILES = mkmf.log
+DISTCLEANFILES = 
+DISTCLEANDIRS = 
+
+extout = 
+extout_prefix = 
+target_prefix = /byebug
+LOCAL_LIBS = 
+LIBS = $(LIBRUBYARG_SHARED)  -lpthread  
+ORIG_SRCS = breakpoint.c byebug.c context.c locker.c threads.c
+SRCS = $(ORIG_SRCS) 
+OBJS = breakpoint.o byebug.o context.o locker.o threads.o
+HDRS = $(srcdir)/byebug.h
+LOCAL_HDRS = 
+TARGET = byebug
+TARGET_NAME = byebug
+TARGET_ENTRY = Init_$(TARGET_NAME)
+DLLIB = $(TARGET).bundle
+EXTSTATIC = 
+STATIC_LIB = 
+
+TIMESTAMP_DIR = .
+BINDIR        = $(bindir)
+RUBYCOMMONDIR = $(sitedir)$(target_prefix)
+RUBYLIBDIR    = $(sitelibdir)$(target_prefix)
+RUBYARCHDIR   = $(sitearchdir)$(target_prefix)
+HDRDIR        = $(sitehdrdir)$(target_prefix)
+ARCHHDRDIR    = $(sitearchhdrdir)$(target_prefix)
+TARGET_SO_DIR =
+TARGET_SO     = $(TARGET_SO_DIR)$(DLLIB)
+CLEANLIBS     = $(TARGET_SO) $(TARGET_SO:=.dSYM)
+CLEANOBJS     = $(OBJS) *.bak
+TARGET_SO_DIR_TIMESTAMP = $(TIMESTAMP_DIR)/.sitearchdir.-.byebug.time
+
+all:    $(DLLIB)
+static: $(STATIC_LIB)
+.PHONY: all install static install-so install-rb
+.PHONY: clean clean-so clean-static clean-rb
+
+clean-static::
+clean-rb-default::
+clean-rb::
+clean-so::
+clean: clean-so clean-static clean-rb-default clean-rb
+		-$(Q)$(RM_RF) $(CLEANLIBS) $(CLEANOBJS) $(CLEANFILES) .*.time
+
+distclean-rb-default::
+distclean-rb::
+distclean-so::
+distclean-static::
+distclean: clean distclean-so distclean-static distclean-rb-default distclean-rb
+		-$(Q)$(RM) Makefile $(RUBY_EXTCONF_H) conftest.* mkmf.log
+		-$(Q)$(RM) core ruby$(EXEEXT) *~ $(DISTCLEANFILES)
+		-$(Q)$(RMDIRS) $(DISTCLEANDIRS) 2> /dev/null || true
+
+realclean: distclean
+install: install-so install-rb
+
+install-so: $(DLLIB) $(TARGET_SO_DIR_TIMESTAMP)
+	$(INSTALL_PROG) $(DLLIB) $(RUBYARCHDIR)
+clean-static::
+	-$(Q)$(RM) $(STATIC_LIB)
+install-rb: pre-install-rb do-install-rb install-rb-default
+install-rb-default: pre-install-rb-default do-install-rb-default
+pre-install-rb: Makefile
+pre-install-rb-default: Makefile
+do-install-rb:
+do-install-rb-default:
+pre-install-rb-default:
+	@$(NULLCMD)
+$(TARGET_SO_DIR_TIMESTAMP):
+	$(Q) $(MAKEDIRS) $(@D) $(RUBYARCHDIR)
+	$(Q) $(TOUCH) $@
+
+site-install: site-install-so site-install-rb
+site-install-so: install-so
+site-install-rb: install-rb
+
+.SUFFIXES: .c .m .cc .mm .cxx .cpp .o .S
+
+.cc.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.cc.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.mm.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.mm.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.cxx.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.cxx.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.cpp.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.cpp.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CXX) $(INCFLAGS) $(CPPFLAGS) $(CXXFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.c.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.c.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+.m.o:
+	$(ECHO) compiling $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -c $(CSRCFLAG)$<
+
+.m.S:
+	$(ECHO) translating $(<)
+	$(Q) $(CC) $(INCFLAGS) $(CPPFLAGS) $(CFLAGS) $(COUTFLAG)$@ -S $(CSRCFLAG)$<
+
+$(TARGET_SO): $(OBJS) Makefile
+	$(ECHO) linking shared-object byebug/$(DLLIB)
+	-$(Q)$(RM) $(@)
+	$(Q) $(LDSHARED) -o $@ $(OBJS) $(LIBPATH) $(DLDFLAGS) $(LOCAL_LIBS) $(LIBS)
+	$(Q) $(POSTLINK)
+
+
+
+$(OBJS): $(HDRS) $(ruby_headers)