fluid_cli 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +7 -0
- data/README.md +1 -0
- data/dev.yml +5 -0
- data/exe/fluid +24 -0
- data/lib/fluid_cli/api.rb +135 -0
- data/lib/fluid_cli/assets/post_auth_page/index.html.erb +34 -0
- data/lib/fluid_cli/assets/post_auth_page/style.css +58 -0
- data/lib/fluid_cli/command.rb +55 -0
- data/lib/fluid_cli/commands/help.rb +21 -0
- data/lib/fluid_cli/commands/login.rb +30 -0
- data/lib/fluid_cli/commands/logout.rb +38 -0
- data/lib/fluid_cli/commands/switch.rb +23 -0
- data/lib/fluid_cli/commands/theme/common/company_helper.rb +15 -0
- data/lib/fluid_cli/commands/theme/common/root_helper.rb +95 -0
- data/lib/fluid_cli/commands/theme/dev.rb +61 -0
- data/lib/fluid_cli/commands/theme/help.rb +21 -0
- data/lib/fluid_cli/commands/theme/init.rb +46 -0
- data/lib/fluid_cli/commands/theme/pull.rb +68 -0
- data/lib/fluid_cli/commands/theme/push.rb +132 -0
- data/lib/fluid_cli/commands/theme.rb +23 -0
- data/lib/fluid_cli/commands/whoami.rb +23 -0
- data/lib/fluid_cli/commands.rb +19 -0
- data/lib/fluid_cli/company_switcher.rb +69 -0
- data/lib/fluid_cli/context.rb +691 -0
- data/lib/fluid_cli/db.rb +114 -0
- data/lib/fluid_cli/entry_point.rb +10 -0
- data/lib/fluid_cli/environment.rb +32 -0
- data/lib/fluid_cli/file_system_listener.rb +29 -0
- data/lib/fluid_cli/form.rb +42 -0
- data/lib/fluid_cli/git.rb +319 -0
- data/lib/fluid_cli/http_request.rb +54 -0
- data/lib/fluid_cli/identity_auth/servlet.rb +39 -0
- data/lib/fluid_cli/identity_auth.rb +126 -0
- data/lib/fluid_cli/options.rb +38 -0
- data/lib/fluid_cli/theme/dev_server/certificate_manager.rb +79 -0
- data/lib/fluid_cli/theme/dev_server/errors.rb +9 -0
- data/lib/fluid_cli/theme/dev_server/header_hash.rb +98 -0
- data/lib/fluid_cli/theme/dev_server/hooks/file_change_hook.rb +39 -0
- data/lib/fluid_cli/theme/dev_server/hot_reload/resources/hot-reload-no-script.html +27 -0
- data/lib/fluid_cli/theme/dev_server/hot_reload/resources/hot_reload.js +28 -0
- data/lib/fluid_cli/theme/dev_server/hot_reload/resources/sse_client.js +43 -0
- data/lib/fluid_cli/theme/dev_server/hot_reload/resources/theme.js +16 -0
- data/lib/fluid_cli/theme/dev_server/hot_reload/script_injector.rb +54 -0
- data/lib/fluid_cli/theme/dev_server/hot_reload.rb +75 -0
- data/lib/fluid_cli/theme/dev_server/local_assets.rb +92 -0
- data/lib/fluid_cli/theme/dev_server/proxy.rb +235 -0
- data/lib/fluid_cli/theme/dev_server/proxy_param_builder.rb +82 -0
- data/lib/fluid_cli/theme/dev_server/reload_mode.rb +34 -0
- data/lib/fluid_cli/theme/dev_server/sse.rb +75 -0
- data/lib/fluid_cli/theme/dev_server/watcher.rb +57 -0
- data/lib/fluid_cli/theme/dev_server/web_server.rb +140 -0
- data/lib/fluid_cli/theme/dev_server.rb +289 -0
- data/lib/fluid_cli/theme/development_theme.rb +101 -0
- data/lib/fluid_cli/theme/file.rb +105 -0
- data/lib/fluid_cli/theme/forms/select.rb +33 -0
- data/lib/fluid_cli/theme/mime_type.rb +34 -0
- data/lib/fluid_cli/theme/presenters/theme_presenter.rb +49 -0
- data/lib/fluid_cli/theme/presenters/themes_presenter.rb +31 -0
- data/lib/fluid_cli/theme/root.rb +62 -0
- data/lib/fluid_cli/theme/syncer/checksums.rb +66 -0
- data/lib/fluid_cli/theme/syncer/downloader.rb +54 -0
- data/lib/fluid_cli/theme/syncer/error_reporter.rb +45 -0
- data/lib/fluid_cli/theme/syncer/merger.rb +53 -0
- data/lib/fluid_cli/theme/syncer/operation.rb +58 -0
- data/lib/fluid_cli/theme/syncer/standard_reporter.rb +32 -0
- data/lib/fluid_cli/theme/syncer/unsupported_script_warning.rb +90 -0
- data/lib/fluid_cli/theme/syncer/uploader/forms/apply_to_all.rb +41 -0
- data/lib/fluid_cli/theme/syncer/uploader/forms/apply_to_all_form.rb +37 -0
- data/lib/fluid_cli/theme/syncer/uploader/forms/base_strategy_form.rb +64 -0
- data/lib/fluid_cli/theme/syncer/uploader/forms/select_delete_strategy.rb +29 -0
- data/lib/fluid_cli/theme/syncer/uploader/forms/select_update_strategy.rb +30 -0
- data/lib/fluid_cli/theme/syncer/uploader/json_delete_handler.rb +49 -0
- data/lib/fluid_cli/theme/syncer/uploader/json_update_handler.rb +71 -0
- data/lib/fluid_cli/theme/syncer/uploader.rb +105 -0
- data/lib/fluid_cli/theme/syncer.rb +412 -0
- data/lib/fluid_cli/theme/theme.rb +186 -0
- data/lib/fluid_cli/theme/ui/sync_progress_bar.rb +22 -0
- data/lib/fluid_cli/thread_pool/job.rb +35 -0
- data/lib/fluid_cli/thread_pool.rb +49 -0
- data/lib/fluid_cli/version.rb +3 -0
- data/lib/fluid_cli.rb +59 -0
- data/vendor/deps/base64/.document +5 -0
- data/vendor/deps/base64/.gitignore +9 -0
- data/vendor/deps/base64/BSDL +22 -0
- data/vendor/deps/base64/COPYING +56 -0
- data/vendor/deps/base64/Gemfile +9 -0
- data/vendor/deps/base64/LEGAL +60 -0
- data/vendor/deps/base64/README.md +48 -0
- data/vendor/deps/base64/Rakefile +31 -0
- data/vendor/deps/base64/base64.gemspec +28 -0
- data/vendor/deps/base64/bin/console +14 -0
- data/vendor/deps/base64/bin/setup +8 -0
- data/vendor/deps/base64/lib/base64.rb +382 -0
- data/vendor/deps/base64/sig/base64.rbs +358 -0
- data/vendor/deps/base64/test/base64/test_base64.rb +115 -0
- data/vendor/deps/base64/test_sig/test_base64.rb +44 -0
- data/vendor/deps/cli-kit/REVISION +1 -0
- data/vendor/deps/cli-kit/lib/cli/kit/args/definition.rb +286 -0
- data/vendor/deps/cli-kit/lib/cli/kit/args/evaluation.rb +215 -0
- data/vendor/deps/cli-kit/lib/cli/kit/args/parser/node.rb +128 -0
- data/vendor/deps/cli-kit/lib/cli/kit/args/parser.rb +125 -0
- data/vendor/deps/cli-kit/lib/cli/kit/args/tokenizer.rb +130 -0
- data/vendor/deps/cli-kit/lib/cli/kit/args.rb +16 -0
- data/vendor/deps/cli-kit/lib/cli/kit/base_command.rb +30 -0
- data/vendor/deps/cli-kit/lib/cli/kit/command_help.rb +268 -0
- data/vendor/deps/cli-kit/lib/cli/kit/command_registry.rb +150 -0
- data/vendor/deps/cli-kit/lib/cli/kit/config.rb +137 -0
- data/vendor/deps/cli-kit/lib/cli/kit/core_ext.rb +28 -0
- data/vendor/deps/cli-kit/lib/cli/kit/error_handler.rb +166 -0
- data/vendor/deps/cli-kit/lib/cli/kit/executor.rb +92 -0
- data/vendor/deps/cli-kit/lib/cli/kit/ini.rb +91 -0
- data/vendor/deps/cli-kit/lib/cli/kit/levenshtein.rb +92 -0
- data/vendor/deps/cli-kit/lib/cli/kit/logger.rb +94 -0
- data/vendor/deps/cli-kit/lib/cli/kit/opts.rb +248 -0
- data/vendor/deps/cli-kit/lib/cli/kit/parse_args.rb +55 -0
- data/vendor/deps/cli-kit/lib/cli/kit/resolver.rb +66 -0
- data/vendor/deps/cli-kit/lib/cli/kit/support/test_helper.rb +260 -0
- data/vendor/deps/cli-kit/lib/cli/kit/support.rb +11 -0
- data/vendor/deps/cli-kit/lib/cli/kit/system.rb +290 -0
- data/vendor/deps/cli-kit/lib/cli/kit/util.rb +118 -0
- data/vendor/deps/cli-kit/lib/cli/kit/version.rb +7 -0
- data/vendor/deps/cli-kit/lib/cli/kit.rb +139 -0
- data/vendor/deps/cli-ui/REVISION +1 -0
- data/vendor/deps/cli-ui/lib/cli/ui/ansi.rb +218 -0
- data/vendor/deps/cli-ui/lib/cli/ui/color.rb +101 -0
- data/vendor/deps/cli-ui/lib/cli/ui/formatter.rb +219 -0
- data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_stack.rb +67 -0
- data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_style/box.rb +179 -0
- data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_style/bracket.rb +152 -0
- data/vendor/deps/cli-ui/lib/cli/ui/frame/frame_style.rb +127 -0
- data/vendor/deps/cli-ui/lib/cli/ui/frame.rb +286 -0
- data/vendor/deps/cli-ui/lib/cli/ui/glyph.rb +92 -0
- data/vendor/deps/cli-ui/lib/cli/ui/os.rb +63 -0
- data/vendor/deps/cli-ui/lib/cli/ui/printer.rb +64 -0
- data/vendor/deps/cli-ui/lib/cli/ui/progress.rb +132 -0
- data/vendor/deps/cli-ui/lib/cli/ui/progress_reporter.rb +209 -0
- data/vendor/deps/cli-ui/lib/cli/ui/prompt/interactive_options.rb +583 -0
- data/vendor/deps/cli-ui/lib/cli/ui/prompt/options_handler.rb +36 -0
- data/vendor/deps/cli-ui/lib/cli/ui/prompt.rb +381 -0
- data/vendor/deps/cli-ui/lib/cli/ui/spinner/async.rb +48 -0
- data/vendor/deps/cli-ui/lib/cli/ui/spinner/spin_group.rb +602 -0
- data/vendor/deps/cli-ui/lib/cli/ui/spinner.rb +79 -0
- data/vendor/deps/cli-ui/lib/cli/ui/stdout_router.rb +399 -0
- data/vendor/deps/cli-ui/lib/cli/ui/table.rb +83 -0
- data/vendor/deps/cli-ui/lib/cli/ui/terminal.rb +55 -0
- data/vendor/deps/cli-ui/lib/cli/ui/truncater.rb +106 -0
- data/vendor/deps/cli-ui/lib/cli/ui/version.rb +8 -0
- data/vendor/deps/cli-ui/lib/cli/ui/widgets/base.rb +46 -0
- data/vendor/deps/cli-ui/lib/cli/ui/widgets/status.rb +79 -0
- data/vendor/deps/cli-ui/lib/cli/ui/widgets.rb +89 -0
- data/vendor/deps/cli-ui/lib/cli/ui/work_queue.rb +142 -0
- data/vendor/deps/cli-ui/lib/cli/ui/wrap.rb +61 -0
- data/vendor/deps/cli-ui/lib/cli/ui.rb +359 -0
- data/vendor/deps/cli-ui/vendor/reentrant_mutex.rb +78 -0
- data/vendor/deps/debug/CONTRIBUTING.md +573 -0
- data/vendor/deps/debug/Gemfile +10 -0
- data/vendor/deps/debug/LICENSE.txt +22 -0
- data/vendor/deps/debug/README.md +996 -0
- data/vendor/deps/debug/Rakefile +57 -0
- data/vendor/deps/debug/TODO.md +23 -0
- data/vendor/deps/debug/debug.gemspec +33 -0
- data/vendor/deps/debug/exe/rdbg +53 -0
- data/vendor/deps/debug/ext/debug/Makefile +273 -0
- data/vendor/deps/debug/ext/debug/debug.c +228 -0
- data/vendor/deps/debug/ext/debug/debug_version.h +1 -0
- data/vendor/deps/debug/ext/debug/extconf.rb +27 -0
- data/vendor/deps/debug/ext/debug/iseq_collector.c +93 -0
- data/vendor/deps/debug/lib/debug/abbrev_command.rb +77 -0
- data/vendor/deps/debug/lib/debug/breakpoint.rb +556 -0
- data/vendor/deps/debug/lib/debug/client.rb +263 -0
- data/vendor/deps/debug/lib/debug/color.rb +123 -0
- data/vendor/deps/debug/lib/debug/config.rb +592 -0
- data/vendor/deps/debug/lib/debug/console.rb +224 -0
- data/vendor/deps/debug/lib/debug/dap_custom/traceInspector.rb +336 -0
- data/vendor/deps/debug/lib/debug/debug.bundle +0 -0
- data/vendor/deps/debug/lib/debug/frame_info.rb +190 -0
- data/vendor/deps/debug/lib/debug/irb_integration.rb +37 -0
- data/vendor/deps/debug/lib/debug/local.rb +115 -0
- data/vendor/deps/debug/lib/debug/open.rb +13 -0
- data/vendor/deps/debug/lib/debug/open_nonstop.rb +15 -0
- data/vendor/deps/debug/lib/debug/prelude.rb +50 -0
- data/vendor/deps/debug/lib/debug/server.rb +534 -0
- data/vendor/deps/debug/lib/debug/server_cdp.rb +1348 -0
- data/vendor/deps/debug/lib/debug/server_dap.rb +1108 -0
- data/vendor/deps/debug/lib/debug/session.rb +2667 -0
- data/vendor/deps/debug/lib/debug/source_repository.rb +150 -0
- data/vendor/deps/debug/lib/debug/start.rb +5 -0
- data/vendor/deps/debug/lib/debug/thread_client.rb +1457 -0
- data/vendor/deps/debug/lib/debug/tracer.rb +241 -0
- data/vendor/deps/debug/lib/debug/version.rb +5 -0
- data/vendor/deps/debug/lib/debug.rb +9 -0
- data/vendor/deps/debug/misc/README.md.erb +660 -0
- data/vendor/deps/listen/.github/release-drafter.yml +17 -0
- data/vendor/deps/listen/.github/workflows/development.yml +67 -0
- data/vendor/deps/listen/.github/workflows/push.yml +12 -0
- data/vendor/deps/listen/.gitignore +28 -0
- data/vendor/deps/listen/.rspec +3 -0
- data/vendor/deps/listen/.rubocop.yml +283 -0
- data/vendor/deps/listen/.yardopts +11 -0
- data/vendor/deps/listen/CHANGELOG.md +1 -0
- data/vendor/deps/listen/CONTRIBUTING.md +45 -0
- data/vendor/deps/listen/Gemfile +33 -0
- data/vendor/deps/listen/Guardfile +26 -0
- data/vendor/deps/listen/LICENSE.txt +22 -0
- data/vendor/deps/listen/README.md +490 -0
- data/vendor/deps/listen/Rakefile +154 -0
- data/vendor/deps/listen/bin/listen +11 -0
- data/vendor/deps/listen/lib/listen/adapter/base.rb +129 -0
- data/vendor/deps/listen/lib/listen/adapter/bsd.rb +104 -0
- data/vendor/deps/listen/lib/listen/adapter/config.rb +31 -0
- data/vendor/deps/listen/lib/listen/adapter/darwin.rb +77 -0
- data/vendor/deps/listen/lib/listen/adapter/linux.rb +108 -0
- data/vendor/deps/listen/lib/listen/adapter/polling.rb +40 -0
- data/vendor/deps/listen/lib/listen/adapter/windows.rb +96 -0
- data/vendor/deps/listen/lib/listen/adapter.rb +43 -0
- data/vendor/deps/listen/lib/listen/backend.rb +40 -0
- data/vendor/deps/listen/lib/listen/change.rb +69 -0
- data/vendor/deps/listen/lib/listen/cli.rb +65 -0
- data/vendor/deps/listen/lib/listen/directory.rb +93 -0
- data/vendor/deps/listen/lib/listen/error.rb +11 -0
- data/vendor/deps/listen/lib/listen/event/config.rb +39 -0
- data/vendor/deps/listen/lib/listen/event/loop.rb +92 -0
- data/vendor/deps/listen/lib/listen/event/processor.rb +128 -0
- data/vendor/deps/listen/lib/listen/event/queue.rb +52 -0
- data/vendor/deps/listen/lib/listen/file.rb +95 -0
- data/vendor/deps/listen/lib/listen/fsm.rb +131 -0
- data/vendor/deps/listen/lib/listen/listener/config.rb +41 -0
- data/vendor/deps/listen/lib/listen/listener.rb +136 -0
- data/vendor/deps/listen/lib/listen/logger.rb +65 -0
- data/vendor/deps/listen/lib/listen/monotonic_time.rb +27 -0
- data/vendor/deps/listen/lib/listen/options.rb +24 -0
- data/vendor/deps/listen/lib/listen/queue_optimizer.rb +129 -0
- data/vendor/deps/listen/lib/listen/record/entry.rb +66 -0
- data/vendor/deps/listen/lib/listen/record/symlink_detector.rb +47 -0
- data/vendor/deps/listen/lib/listen/record.rb +122 -0
- data/vendor/deps/listen/lib/listen/silencer/controller.rb +50 -0
- data/vendor/deps/listen/lib/listen/silencer.rb +106 -0
- data/vendor/deps/listen/lib/listen/thread.rb +54 -0
- data/vendor/deps/listen/lib/listen/version.rb +5 -0
- data/vendor/deps/listen/lib/listen.rb +47 -0
- data/vendor/deps/listen/listen.gemspec +40 -0
- data/vendor/deps/listen/spec/acceptance/listen_spec.rb +320 -0
- data/vendor/deps/listen/spec/lib/listen/adapter/base_spec.rb +101 -0
- data/vendor/deps/listen/spec/lib/listen/adapter/bsd_spec.rb +13 -0
- data/vendor/deps/listen/spec/lib/listen/adapter/config_spec.rb +122 -0
- data/vendor/deps/listen/spec/lib/listen/adapter/darwin_spec.rb +82 -0
- data/vendor/deps/listen/spec/lib/listen/adapter/linux_spec.rb +199 -0
- data/vendor/deps/listen/spec/lib/listen/adapter/polling_spec.rb +83 -0
- data/vendor/deps/listen/spec/lib/listen/adapter/windows_spec.rb +13 -0
- data/vendor/deps/listen/spec/lib/listen/adapter_spec.rb +69 -0
- data/vendor/deps/listen/spec/lib/listen/backend_spec.rb +82 -0
- data/vendor/deps/listen/spec/lib/listen/change_spec.rb +102 -0
- data/vendor/deps/listen/spec/lib/listen/cli_spec.rb +116 -0
- data/vendor/deps/listen/spec/lib/listen/directory_spec.rb +284 -0
- data/vendor/deps/listen/spec/lib/listen/event/config_spec.rb +33 -0
- data/vendor/deps/listen/spec/lib/listen/event/loop_spec.rb +118 -0
- data/vendor/deps/listen/spec/lib/listen/event/processor_spec.rb +250 -0
- data/vendor/deps/listen/spec/lib/listen/event/queue_spec.rb +118 -0
- data/vendor/deps/listen/spec/lib/listen/file_spec.rb +254 -0
- data/vendor/deps/listen/spec/lib/listen/fsm_spec.rb +147 -0
- data/vendor/deps/listen/spec/lib/listen/listener/config_spec.rb +29 -0
- data/vendor/deps/listen/spec/lib/listen/listener_spec.rb +321 -0
- data/vendor/deps/listen/spec/lib/listen/logger_spec.rb +212 -0
- data/vendor/deps/listen/spec/lib/listen/monotonic_time_spec.rb +58 -0
- data/vendor/deps/listen/spec/lib/listen/queue_optimizer_spec.rb +111 -0
- data/vendor/deps/listen/spec/lib/listen/record_spec.rb +424 -0
- data/vendor/deps/listen/spec/lib/listen/silencer/controller_spec.rb +97 -0
- data/vendor/deps/listen/spec/lib/listen/silencer_spec.rb +109 -0
- data/vendor/deps/listen/spec/lib/listen/thread_spec.rb +133 -0
- data/vendor/deps/listen/spec/lib/listen_spec.rb +25 -0
- data/vendor/deps/listen/spec/spec_helper.rb +49 -0
- data/vendor/deps/listen/spec/support/acceptance_helper.rb +260 -0
- data/vendor/deps/listen/spec/support/fixtures_helper.rb +32 -0
- data/vendor/deps/listen/spec/support/platform_helper.rb +17 -0
- data/vendor/deps/observer/.github/dependabot.yml +6 -0
- data/vendor/deps/observer/.github/workflows/test.yml +33 -0
- data/vendor/deps/observer/.gitignore +8 -0
- data/vendor/deps/observer/BSDL +22 -0
- data/vendor/deps/observer/COPYING +56 -0
- data/vendor/deps/observer/Gemfile +9 -0
- data/vendor/deps/observer/README.md +139 -0
- data/vendor/deps/observer/Rakefile +10 -0
- data/vendor/deps/observer/bin/console +14 -0
- data/vendor/deps/observer/bin/setup +8 -0
- data/vendor/deps/observer/lib/observer.rb +229 -0
- data/vendor/deps/observer/observer.gemspec +32 -0
- data/vendor/deps/observer/test/test_observer.rb +66 -0
- data/vendor/deps/webrick/.gitignore +9 -0
- data/vendor/deps/webrick/Gemfile +3 -0
- data/vendor/deps/webrick/LICENSE.txt +22 -0
- data/vendor/deps/webrick/README.md +61 -0
- data/vendor/deps/webrick/Rakefile +10 -0
- data/vendor/deps/webrick/lib/webrick/accesslog.rb +157 -0
- data/vendor/deps/webrick/lib/webrick/cgi.rb +313 -0
- data/vendor/deps/webrick/lib/webrick/compat.rb +36 -0
- data/vendor/deps/webrick/lib/webrick/config.rb +158 -0
- data/vendor/deps/webrick/lib/webrick/cookie.rb +172 -0
- data/vendor/deps/webrick/lib/webrick/htmlutils.rb +30 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/authenticator.rb +117 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/basicauth.rb +116 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/digestauth.rb +395 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/htdigest.rb +132 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/htgroup.rb +97 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/htpasswd.rb +158 -0
- data/vendor/deps/webrick/lib/webrick/httpauth/userdb.rb +53 -0
- data/vendor/deps/webrick/lib/webrick/httpauth.rb +96 -0
- data/vendor/deps/webrick/lib/webrick/httpproxy.rb +354 -0
- data/vendor/deps/webrick/lib/webrick/httprequest.rb +636 -0
- data/vendor/deps/webrick/lib/webrick/httpresponse.rb +564 -0
- data/vendor/deps/webrick/lib/webrick/https.rb +152 -0
- data/vendor/deps/webrick/lib/webrick/httpserver.rb +294 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/abstract.rb +152 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/cgi_runner.rb +47 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/cgihandler.rb +126 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/erbhandler.rb +88 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/filehandler.rb +552 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet/prochandler.rb +47 -0
- data/vendor/deps/webrick/lib/webrick/httpservlet.rb +23 -0
- data/vendor/deps/webrick/lib/webrick/httpstatus.rb +194 -0
- data/vendor/deps/webrick/lib/webrick/httputils.rb +512 -0
- data/vendor/deps/webrick/lib/webrick/httpversion.rb +76 -0
- data/vendor/deps/webrick/lib/webrick/log.rb +156 -0
- data/vendor/deps/webrick/lib/webrick/server.rb +381 -0
- data/vendor/deps/webrick/lib/webrick/ssl.rb +215 -0
- data/vendor/deps/webrick/lib/webrick/utils.rb +265 -0
- data/vendor/deps/webrick/lib/webrick/version.rb +18 -0
- data/vendor/deps/webrick/lib/webrick.rb +232 -0
- data/vendor/deps/webrick/webrick.gemspec +74 -0
- metadata +412 -0
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
# Observer
|
|
2
|
+
|
|
3
|
+
The Observer pattern (also known as publish/subscribe) provides a simple
|
|
4
|
+
mechanism for one object to inform a set of interested third-party objects
|
|
5
|
+
when its state changes.
|
|
6
|
+
|
|
7
|
+
## Mechanism
|
|
8
|
+
|
|
9
|
+
The notifying class mixes in the +Observable+
|
|
10
|
+
module, which provides the methods for managing the associated observer
|
|
11
|
+
objects.
|
|
12
|
+
|
|
13
|
+
The observable object must:
|
|
14
|
+
|
|
15
|
+
* assert that it has +#changed+
|
|
16
|
+
* call +#notify_observers+
|
|
17
|
+
|
|
18
|
+
An observer subscribes to updates using Observable#add_observer, which also
|
|
19
|
+
specifies the method called via #notify_observers. The default method for
|
|
20
|
+
notify_observers is #update.
|
|
21
|
+
|
|
22
|
+
## Installation
|
|
23
|
+
|
|
24
|
+
Add this line to your application's Gemfile:
|
|
25
|
+
|
|
26
|
+
```ruby
|
|
27
|
+
gem 'observer'
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
And then execute:
|
|
31
|
+
|
|
32
|
+
$ bundle
|
|
33
|
+
|
|
34
|
+
Or install it yourself as:
|
|
35
|
+
|
|
36
|
+
$ gem install observer
|
|
37
|
+
|
|
38
|
+
## Usage
|
|
39
|
+
|
|
40
|
+
The following example demonstrates this nicely. A +Ticker+, when run,
|
|
41
|
+
continually receives the stock +Price+ for its <tt>@symbol</tt>. A +Warner+
|
|
42
|
+
is a general observer of the price, and two warners are demonstrated, a
|
|
43
|
+
+WarnLow+ and a +WarnHigh+, which print a warning if the price is below or
|
|
44
|
+
above their set limits, respectively.
|
|
45
|
+
|
|
46
|
+
The +update+ callback allows the warners to run without being explicitly
|
|
47
|
+
called. The system is set up with the +Ticker+ and several observers, and the
|
|
48
|
+
observers do their duty without the top-level code having to interfere.
|
|
49
|
+
|
|
50
|
+
Note that the contract between publisher and subscriber (observable and
|
|
51
|
+
observer) is not declared or enforced. The +Ticker+ publishes a time and a
|
|
52
|
+
price, and the warners receive that. But if you don't ensure that your
|
|
53
|
+
contracts are correct, nothing else can warn you.
|
|
54
|
+
|
|
55
|
+
```ruby
|
|
56
|
+
require "observer"
|
|
57
|
+
|
|
58
|
+
class Ticker ### Periodically fetch a stock price.
|
|
59
|
+
|
|
60
|
+
include Observable
|
|
61
|
+
|
|
62
|
+
def initialize(symbol)
|
|
63
|
+
@symbol = symbol
|
|
64
|
+
end
|
|
65
|
+
|
|
66
|
+
def run
|
|
67
|
+
last_price = nil
|
|
68
|
+
loop do
|
|
69
|
+
price = Price.fetch(@symbol)
|
|
70
|
+
print "Current price: #{price}\n"
|
|
71
|
+
if price != last_price
|
|
72
|
+
changed # notify observers
|
|
73
|
+
last_price = price
|
|
74
|
+
notify_observers(Time.now, price)
|
|
75
|
+
end
|
|
76
|
+
sleep 1
|
|
77
|
+
end
|
|
78
|
+
end
|
|
79
|
+
end
|
|
80
|
+
|
|
81
|
+
class Price ### A mock class to fetch a stock price (60 - 140).
|
|
82
|
+
def self.fetch(symbol)
|
|
83
|
+
60 + rand(80)
|
|
84
|
+
end
|
|
85
|
+
end
|
|
86
|
+
|
|
87
|
+
class Warner ### An abstract observer of Ticker objects.
|
|
88
|
+
def initialize(ticker, limit)
|
|
89
|
+
@limit = limit
|
|
90
|
+
ticker.add_observer(self)
|
|
91
|
+
end
|
|
92
|
+
end
|
|
93
|
+
|
|
94
|
+
class WarnLow < Warner
|
|
95
|
+
def update(time, price) # callback for observer
|
|
96
|
+
if price < @limit
|
|
97
|
+
print "--- #{time.to_s}: Price below #@limit: #{price}\n"
|
|
98
|
+
end
|
|
99
|
+
end
|
|
100
|
+
end
|
|
101
|
+
|
|
102
|
+
class WarnHigh < Warner
|
|
103
|
+
def update(time, price) # callback for observer
|
|
104
|
+
if price > @limit
|
|
105
|
+
print "+++ #{time.to_s}: Price above #@limit: #{price}\n"
|
|
106
|
+
end
|
|
107
|
+
end
|
|
108
|
+
end
|
|
109
|
+
|
|
110
|
+
ticker = Ticker.new("MSFT")
|
|
111
|
+
WarnLow.new(ticker, 80)
|
|
112
|
+
WarnHigh.new(ticker, 120)
|
|
113
|
+
ticker.run
|
|
114
|
+
```
|
|
115
|
+
|
|
116
|
+
Produces:
|
|
117
|
+
|
|
118
|
+
```
|
|
119
|
+
Current price: 83
|
|
120
|
+
Current price: 75
|
|
121
|
+
--- Sun Jun 09 00:10:25 CDT 2002: Price below 80: 75
|
|
122
|
+
Current price: 90
|
|
123
|
+
Current price: 134
|
|
124
|
+
+++ Sun Jun 09 00:10:25 CDT 2002: Price above 120: 134
|
|
125
|
+
Current price: 134
|
|
126
|
+
Current price: 112
|
|
127
|
+
Current price: 79
|
|
128
|
+
--- Sun Jun 09 00:10:25 CDT 2002: Price below 80: 79
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
## Development
|
|
132
|
+
|
|
133
|
+
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
|
|
134
|
+
|
|
135
|
+
To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
|
|
136
|
+
|
|
137
|
+
## Contributing
|
|
138
|
+
|
|
139
|
+
Bug reports and pull requests are welcome on GitHub at https://github.com/ruby/observer.
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
#!/usr/bin/env ruby
|
|
2
|
+
|
|
3
|
+
require "bundler/setup"
|
|
4
|
+
require "observer"
|
|
5
|
+
|
|
6
|
+
# You can add fixtures and/or initialization code here to make experimenting
|
|
7
|
+
# with your gem easier. You can also use a different console, if you like.
|
|
8
|
+
|
|
9
|
+
# (If you use this, don't forget to add pry to your Gemfile!)
|
|
10
|
+
# require "pry"
|
|
11
|
+
# Pry.start
|
|
12
|
+
|
|
13
|
+
require "irb"
|
|
14
|
+
IRB.start(__FILE__)
|
|
@@ -0,0 +1,229 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
#
|
|
3
|
+
# Implementation of the _Observer_ object-oriented design pattern. The
|
|
4
|
+
# following documentation is copied, with modifications, from "Programming
|
|
5
|
+
# Ruby", by Hunt and Thomas; http://www.ruby-doc.org/docs/ProgrammingRuby/html/lib_patterns.html.
|
|
6
|
+
#
|
|
7
|
+
# See Observable for more info.
|
|
8
|
+
|
|
9
|
+
# The Observer pattern (also known as publish/subscribe) provides a simple
|
|
10
|
+
# mechanism for one object to inform a set of interested third-party objects
|
|
11
|
+
# when its state changes.
|
|
12
|
+
#
|
|
13
|
+
# == Mechanism
|
|
14
|
+
#
|
|
15
|
+
# The notifying class mixes in the +Observable+
|
|
16
|
+
# module, which provides the methods for managing the associated observer
|
|
17
|
+
# objects.
|
|
18
|
+
#
|
|
19
|
+
# The observable object must:
|
|
20
|
+
# * assert that it has +#changed+
|
|
21
|
+
# * call +#notify_observers+
|
|
22
|
+
#
|
|
23
|
+
# An observer subscribes to updates using Observable#add_observer, which also
|
|
24
|
+
# specifies the method called via #notify_observers. The default method for
|
|
25
|
+
# #notify_observers is #update.
|
|
26
|
+
#
|
|
27
|
+
# === Example
|
|
28
|
+
#
|
|
29
|
+
# The following example demonstrates this nicely. A +Ticker+, when run,
|
|
30
|
+
# continually receives the stock +Price+ for its <tt>@symbol</tt>. A +Warner+
|
|
31
|
+
# is a general observer of the price, and two warners are demonstrated, a
|
|
32
|
+
# +WarnLow+ and a +WarnHigh+, which print a warning if the price is below or
|
|
33
|
+
# above their set limits, respectively.
|
|
34
|
+
#
|
|
35
|
+
# The +update+ callback allows the warners to run without being explicitly
|
|
36
|
+
# called. The system is set up with the +Ticker+ and several observers, and the
|
|
37
|
+
# observers do their duty without the top-level code having to interfere.
|
|
38
|
+
#
|
|
39
|
+
# Note that the contract between publisher and subscriber (observable and
|
|
40
|
+
# observer) is not declared or enforced. The +Ticker+ publishes a time and a
|
|
41
|
+
# price, and the warners receive that. But if you don't ensure that your
|
|
42
|
+
# contracts are correct, nothing else can warn you.
|
|
43
|
+
#
|
|
44
|
+
# require "observer"
|
|
45
|
+
#
|
|
46
|
+
# class Ticker ### Periodically fetch a stock price.
|
|
47
|
+
# include Observable
|
|
48
|
+
#
|
|
49
|
+
# def initialize(symbol)
|
|
50
|
+
# @symbol = symbol
|
|
51
|
+
# end
|
|
52
|
+
#
|
|
53
|
+
# def run
|
|
54
|
+
# last_price = nil
|
|
55
|
+
# loop do
|
|
56
|
+
# price = Price.fetch(@symbol)
|
|
57
|
+
# print "Current price: #{price}\n"
|
|
58
|
+
# if price != last_price
|
|
59
|
+
# changed # notify observers
|
|
60
|
+
# last_price = price
|
|
61
|
+
# notify_observers(Time.now, price)
|
|
62
|
+
# end
|
|
63
|
+
# sleep 1
|
|
64
|
+
# end
|
|
65
|
+
# end
|
|
66
|
+
# end
|
|
67
|
+
#
|
|
68
|
+
# class Price ### A mock class to fetch a stock price (60 - 140).
|
|
69
|
+
# def self.fetch(symbol)
|
|
70
|
+
# 60 + rand(80)
|
|
71
|
+
# end
|
|
72
|
+
# end
|
|
73
|
+
#
|
|
74
|
+
# class Warner ### An abstract observer of Ticker objects.
|
|
75
|
+
# def initialize(ticker, limit)
|
|
76
|
+
# @limit = limit
|
|
77
|
+
# ticker.add_observer(self)
|
|
78
|
+
# end
|
|
79
|
+
# end
|
|
80
|
+
#
|
|
81
|
+
# class WarnLow < Warner
|
|
82
|
+
# def update(time, price) # callback for observer
|
|
83
|
+
# if price < @limit
|
|
84
|
+
# print "--- #{time.to_s}: Price below #@limit: #{price}\n"
|
|
85
|
+
# end
|
|
86
|
+
# end
|
|
87
|
+
# end
|
|
88
|
+
#
|
|
89
|
+
# class WarnHigh < Warner
|
|
90
|
+
# def update(time, price) # callback for observer
|
|
91
|
+
# if price > @limit
|
|
92
|
+
# print "+++ #{time.to_s}: Price above #@limit: #{price}\n"
|
|
93
|
+
# end
|
|
94
|
+
# end
|
|
95
|
+
# end
|
|
96
|
+
#
|
|
97
|
+
# ticker = Ticker.new("MSFT")
|
|
98
|
+
# WarnLow.new(ticker, 80)
|
|
99
|
+
# WarnHigh.new(ticker, 120)
|
|
100
|
+
# ticker.run
|
|
101
|
+
#
|
|
102
|
+
# Produces:
|
|
103
|
+
#
|
|
104
|
+
# Current price: 83
|
|
105
|
+
# Current price: 75
|
|
106
|
+
# --- Sun Jun 09 00:10:25 CDT 2002: Price below 80: 75
|
|
107
|
+
# Current price: 90
|
|
108
|
+
# Current price: 134
|
|
109
|
+
# +++ Sun Jun 09 00:10:25 CDT 2002: Price above 120: 134
|
|
110
|
+
# Current price: 134
|
|
111
|
+
# Current price: 112
|
|
112
|
+
# Current price: 79
|
|
113
|
+
# --- Sun Jun 09 00:10:25 CDT 2002: Price below 80: 79
|
|
114
|
+
#
|
|
115
|
+
# === Usage with procs
|
|
116
|
+
#
|
|
117
|
+
# The +#notify_observers+ method can also be used with +proc+s by using
|
|
118
|
+
# the +:call+ as +func+ parameter.
|
|
119
|
+
#
|
|
120
|
+
# The following example illustrates the use of a lambda:
|
|
121
|
+
#
|
|
122
|
+
# require 'observer'
|
|
123
|
+
#
|
|
124
|
+
# class Ticker
|
|
125
|
+
# include Observable
|
|
126
|
+
#
|
|
127
|
+
# def run
|
|
128
|
+
# # logic to retrieve the price (here 77.0)
|
|
129
|
+
# changed
|
|
130
|
+
# notify_observers(77.0)
|
|
131
|
+
# end
|
|
132
|
+
# end
|
|
133
|
+
#
|
|
134
|
+
# ticker = Ticker.new
|
|
135
|
+
# warner = ->(price) { puts "New price received: #{price}" }
|
|
136
|
+
# ticker.add_observer(warner, :call)
|
|
137
|
+
# ticker.run
|
|
138
|
+
module Observable
|
|
139
|
+
VERSION = "0.1.2"
|
|
140
|
+
|
|
141
|
+
#
|
|
142
|
+
# Add +observer+ as an observer on this object. So that it will receive
|
|
143
|
+
# notifications.
|
|
144
|
+
#
|
|
145
|
+
# +observer+:: the object that will be notified of changes.
|
|
146
|
+
# +func+:: Symbol naming the method that will be called when this Observable
|
|
147
|
+
# has changes.
|
|
148
|
+
#
|
|
149
|
+
# This method must return true for +observer.respond_to?+ and will
|
|
150
|
+
# receive <tt>*arg</tt> when #notify_observers is called, where
|
|
151
|
+
# <tt>*arg</tt> is the value passed to #notify_observers by this
|
|
152
|
+
# Observable
|
|
153
|
+
def add_observer(observer, func=:update)
|
|
154
|
+
@observer_peers = {} unless defined? @observer_peers
|
|
155
|
+
unless observer.respond_to? func
|
|
156
|
+
raise NoMethodError, "observer does not respond to `#{func}'"
|
|
157
|
+
end
|
|
158
|
+
@observer_peers[observer] = func
|
|
159
|
+
end
|
|
160
|
+
|
|
161
|
+
#
|
|
162
|
+
# Remove +observer+ as an observer on this object so that it will no longer
|
|
163
|
+
# receive notifications.
|
|
164
|
+
#
|
|
165
|
+
# +observer+:: An observer of this Observable
|
|
166
|
+
def delete_observer(observer)
|
|
167
|
+
@observer_peers.delete observer if defined? @observer_peers
|
|
168
|
+
end
|
|
169
|
+
|
|
170
|
+
#
|
|
171
|
+
# Remove all observers associated with this object.
|
|
172
|
+
#
|
|
173
|
+
def delete_observers
|
|
174
|
+
@observer_peers.clear if defined? @observer_peers
|
|
175
|
+
end
|
|
176
|
+
|
|
177
|
+
#
|
|
178
|
+
# Return the number of observers associated with this object.
|
|
179
|
+
#
|
|
180
|
+
def count_observers
|
|
181
|
+
if defined? @observer_peers
|
|
182
|
+
@observer_peers.size
|
|
183
|
+
else
|
|
184
|
+
0
|
|
185
|
+
end
|
|
186
|
+
end
|
|
187
|
+
|
|
188
|
+
#
|
|
189
|
+
# Set the changed state of this object. Notifications will be sent only if
|
|
190
|
+
# the changed +state+ is +true+.
|
|
191
|
+
#
|
|
192
|
+
# +state+:: Boolean indicating the changed state of this Observable.
|
|
193
|
+
#
|
|
194
|
+
def changed(state=true)
|
|
195
|
+
@observer_state = state
|
|
196
|
+
end
|
|
197
|
+
|
|
198
|
+
#
|
|
199
|
+
# Returns true if this object's state has been changed since the last
|
|
200
|
+
# #notify_observers call.
|
|
201
|
+
#
|
|
202
|
+
def changed?
|
|
203
|
+
if defined? @observer_state and @observer_state
|
|
204
|
+
true
|
|
205
|
+
else
|
|
206
|
+
false
|
|
207
|
+
end
|
|
208
|
+
end
|
|
209
|
+
|
|
210
|
+
#
|
|
211
|
+
# Notify observers of a change in state *if* this object's changed state is
|
|
212
|
+
# +true+.
|
|
213
|
+
#
|
|
214
|
+
# This will invoke the method named in #add_observer, passing <tt>*arg</tt>.
|
|
215
|
+
# The changed state is then set to +false+.
|
|
216
|
+
#
|
|
217
|
+
# <tt>*arg</tt>:: Any arguments to pass to the observers.
|
|
218
|
+
def notify_observers(*arg)
|
|
219
|
+
if defined? @observer_state and @observer_state
|
|
220
|
+
if defined? @observer_peers
|
|
221
|
+
@observer_peers.each do |k, v|
|
|
222
|
+
k.__send__(v, *arg)
|
|
223
|
+
end
|
|
224
|
+
end
|
|
225
|
+
@observer_state = false
|
|
226
|
+
end
|
|
227
|
+
end
|
|
228
|
+
|
|
229
|
+
end
|
|
@@ -0,0 +1,32 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
name = File.basename(__FILE__, ".gemspec")
|
|
4
|
+
version = ["lib", Array.new(name.count("-")+1, ".").join("/")].find do |dir|
|
|
5
|
+
break File.foreach(File.join(__dir__, dir, "#{name.tr('-', '/')}.rb")) do |line|
|
|
6
|
+
/^\s*VERSION\s*=\s*"(.*)"/ =~ line and break $1
|
|
7
|
+
end rescue nil
|
|
8
|
+
end
|
|
9
|
+
|
|
10
|
+
Gem::Specification.new do |spec|
|
|
11
|
+
spec.name = name
|
|
12
|
+
spec.version = version
|
|
13
|
+
spec.authors = ["Yukihiro Matsumoto"]
|
|
14
|
+
spec.email = ["matz@ruby-lang.org"]
|
|
15
|
+
|
|
16
|
+
spec.summary = %q{Implementation of the Observer object-oriented design pattern.}
|
|
17
|
+
spec.description = spec.summary
|
|
18
|
+
spec.homepage = "https://github.com/ruby/observer"
|
|
19
|
+
spec.licenses = ["Ruby", "BSD-2-Clause"]
|
|
20
|
+
|
|
21
|
+
spec.metadata["homepage_uri"] = spec.homepage
|
|
22
|
+
spec.metadata["source_code_uri"] = spec.homepage
|
|
23
|
+
|
|
24
|
+
# Specify which files should be added to the gem when it is released.
|
|
25
|
+
# The `git ls-files -z` loads the files in the RubyGem that have been added into git.
|
|
26
|
+
spec.files = Dir.chdir(File.expand_path('..', __FILE__)) do
|
|
27
|
+
`git ls-files -z 2>#{IO::NULL}`.split("\x0").reject { |f| f.match(%r{^(test|spec|features)/}) }
|
|
28
|
+
end
|
|
29
|
+
spec.bindir = "exe"
|
|
30
|
+
spec.executables = spec.files.grep(%r{^exe/}) { |f| File.basename(f) }
|
|
31
|
+
spec.require_paths = ["lib"]
|
|
32
|
+
end
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
require 'test/unit'
|
|
3
|
+
require 'observer'
|
|
4
|
+
|
|
5
|
+
class TestObserver < Test::Unit::TestCase
|
|
6
|
+
class TestObservable
|
|
7
|
+
include Observable
|
|
8
|
+
|
|
9
|
+
def notify(*args)
|
|
10
|
+
changed
|
|
11
|
+
notify_observers(*args)
|
|
12
|
+
end
|
|
13
|
+
end
|
|
14
|
+
|
|
15
|
+
class TestWatcher
|
|
16
|
+
def initialize(observable)
|
|
17
|
+
@notifications = []
|
|
18
|
+
observable.add_observer(self)
|
|
19
|
+
end
|
|
20
|
+
|
|
21
|
+
attr_reader :notifications
|
|
22
|
+
|
|
23
|
+
def update(*args)
|
|
24
|
+
@notifications << args
|
|
25
|
+
end
|
|
26
|
+
end
|
|
27
|
+
|
|
28
|
+
def test_observers
|
|
29
|
+
observable = TestObservable.new
|
|
30
|
+
|
|
31
|
+
assert_equal(0, observable.count_observers)
|
|
32
|
+
|
|
33
|
+
watcher1 = TestWatcher.new(observable)
|
|
34
|
+
|
|
35
|
+
assert_equal(1, observable.count_observers)
|
|
36
|
+
|
|
37
|
+
observable.notify("test", 123)
|
|
38
|
+
|
|
39
|
+
watcher2 = TestWatcher.new(observable)
|
|
40
|
+
|
|
41
|
+
assert_equal(2, observable.count_observers)
|
|
42
|
+
|
|
43
|
+
observable.notify(42)
|
|
44
|
+
|
|
45
|
+
assert_equal([["test", 123], [42]], watcher1.notifications)
|
|
46
|
+
assert_equal([[42]], watcher2.notifications)
|
|
47
|
+
|
|
48
|
+
observable.delete_observer(watcher1)
|
|
49
|
+
|
|
50
|
+
assert_equal(1, observable.count_observers)
|
|
51
|
+
|
|
52
|
+
observable.notify(:cats)
|
|
53
|
+
|
|
54
|
+
assert_equal([["test", 123], [42]], watcher1.notifications)
|
|
55
|
+
assert_equal([[42], [:cats]], watcher2.notifications)
|
|
56
|
+
|
|
57
|
+
observable.delete_observers
|
|
58
|
+
|
|
59
|
+
assert_equal(0, observable.count_observers)
|
|
60
|
+
|
|
61
|
+
observable.notify("nope")
|
|
62
|
+
|
|
63
|
+
assert_equal([["test", 123], [42]], watcher1.notifications)
|
|
64
|
+
assert_equal([[42], [:cats]], watcher2.notifications)
|
|
65
|
+
end
|
|
66
|
+
end
|
|
@@ -0,0 +1,22 @@
|
|
|
1
|
+
Copyright (C) 1993-2013 Yukihiro Matsumoto. All rights reserved.
|
|
2
|
+
|
|
3
|
+
Redistribution and use in source and binary forms, with or without
|
|
4
|
+
modification, are permitted provided that the following conditions
|
|
5
|
+
are met:
|
|
6
|
+
1. Redistributions of source code must retain the above copyright
|
|
7
|
+
notice, this list of conditions and the following disclaimer.
|
|
8
|
+
2. Redistributions in binary form must reproduce the above copyright
|
|
9
|
+
notice, this list of conditions and the following disclaimer in the
|
|
10
|
+
documentation and/or other materials provided with the distribution.
|
|
11
|
+
|
|
12
|
+
THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
13
|
+
ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
14
|
+
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
15
|
+
ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
16
|
+
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
17
|
+
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
18
|
+
OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
19
|
+
HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
20
|
+
LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
21
|
+
OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
22
|
+
SUCH DAMAGE.
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# Webrick
|
|
2
|
+
|
|
3
|
+
WEBrick is an HTTP server toolkit that can be configured as an HTTPS server, a proxy server, and a virtual-host server.
|
|
4
|
+
|
|
5
|
+
WEBrick features complete logging of both server operations and HTTP access.
|
|
6
|
+
|
|
7
|
+
WEBrick supports both basic and digest authentication in addition to algorithms not in RFC 2617.
|
|
8
|
+
|
|
9
|
+
A WEBrick server can be composed of multiple WEBrick servers or servlets to provide differing behavior on a per-host or per-path basis. WEBrick includes servlets for handling CGI scripts, ERB pages, Ruby blocks and directory listings.
|
|
10
|
+
|
|
11
|
+
WEBrick also includes tools for daemonizing a process and starting a process at a higher privilege level and dropping permissions.
|
|
12
|
+
|
|
13
|
+
## Installation
|
|
14
|
+
|
|
15
|
+
Add this line to your application's Gemfile:
|
|
16
|
+
|
|
17
|
+
```ruby
|
|
18
|
+
gem 'webrick'
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
And then execute:
|
|
22
|
+
|
|
23
|
+
$ bundle
|
|
24
|
+
|
|
25
|
+
Or install it yourself as:
|
|
26
|
+
|
|
27
|
+
$ gem install webrick
|
|
28
|
+
|
|
29
|
+
## Usage
|
|
30
|
+
|
|
31
|
+
To create a new WEBrick::HTTPServer that will listen to connections on port 8000 and serve documents from the current user's public_html folder:
|
|
32
|
+
|
|
33
|
+
```ruby
|
|
34
|
+
require 'webrick'
|
|
35
|
+
|
|
36
|
+
root = File.expand_path '~/public_html'
|
|
37
|
+
server = WEBrick::HTTPServer.new :Port => 8000, :DocumentRoot => root
|
|
38
|
+
```
|
|
39
|
+
|
|
40
|
+
To run the server you will need to provide a suitable shutdown hook as
|
|
41
|
+
starting the server blocks the current thread:
|
|
42
|
+
|
|
43
|
+
```ruby
|
|
44
|
+
trap 'INT' do server.shutdown end
|
|
45
|
+
|
|
46
|
+
server.start
|
|
47
|
+
```
|
|
48
|
+
|
|
49
|
+
## Development
|
|
50
|
+
|
|
51
|
+
After checking out the repo, run `bin/setup` to install dependencies. Then, run `rake test` to run the tests. You can also run `bin/console` for an interactive prompt that will allow you to experiment.
|
|
52
|
+
|
|
53
|
+
To install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).
|
|
54
|
+
|
|
55
|
+
## Contributing
|
|
56
|
+
|
|
57
|
+
Bug reports and Patch are welcome on https://bugs.ruby-lang.org/.
|
|
58
|
+
|
|
59
|
+
## License
|
|
60
|
+
|
|
61
|
+
The gem is available as open source under the terms of the [2-Clause BSD License](https://opensource.org/licenses/BSD-2-Clause).
|