Module: Stretchy

Extended by:: Utils::ClientActions, Utils::Configuration

Defined in:: lib/stretchy.rb,
lib/stretchy/version.rb,
lib/stretchy/types/base.rb,
lib/stretchy/boosts/base.rb,
lib/stretchy/types/range.rb,
lib/stretchy/clauses/base.rb,
lib/stretchy/filters/base.rb,
lib/stretchy/queries/base.rb,
lib/stretchy/results/base.rb,
lib/stretchy/utils/logger.rb,
lib/stretchy/utils/colorize.rb,
lib/stretchy/types/geo_point.rb,
lib/stretchy/utils/validation.rb,
lib/stretchy/filters/or_filter.rb,
lib/stretchy/utils/dot_handler.rb,
lib/stretchy/filters/and_filter.rb,
lib/stretchy/filters/geo_filter.rb,
lib/stretchy/filters/not_filter.rb,
lib/stretchy/queries/bool_query.rb,
lib/stretchy/boosts/filter_boost.rb,
lib/stretchy/boosts/random_boost.rb,
lib/stretchy/filters/bool_filter.rb,
lib/stretchy/queries/match_query.rb,
lib/stretchy/utils/configuration.rb,
lib/stretchy/clauses/boost_clause.rb,
lib/stretchy/clauses/match_clause.rb,
lib/stretchy/clauses/where_clause.rb,
lib/stretchy/filters/query_filter.rb,
lib/stretchy/filters/range_filter.rb,
lib/stretchy/filters/terms_filter.rb,
lib/stretchy/results/null_results.rb,
lib/stretchy/utils/client_actions.rb,
lib/stretchy/filters/exists_filter.rb,
lib/stretchy/builders/boost_builder.rb,
lib/stretchy/builders/match_builder.rb,
lib/stretchy/builders/query_builder.rb,
lib/stretchy/builders/shell_builder.rb,
lib/stretchy/builders/where_builder.rb,
lib/stretchy/queries/filtered_query.rb,
lib/stretchy/builders/filter_builder.rb,
lib/stretchy/errors/validation_error.rb,
lib/stretchy/queries/match_all_query.rb,
lib/stretchy/boosts/field_decay_boost.rb,
lib/stretchy/clauses/boost_match_clause.rb,
lib/stretchy/clauses/boost_where_clause.rb,
lib/stretchy/queries/function_score_query.rb

Overview

RubyDoc.info: YARD Doc Server

RubyDoc.info is the next generation Ruby doc server, replacing http://rdoc.info and http://yardoc.org/docs. This doc server uses YARD to generate project documentation on the fly, for both published RubyGems as well as GitHub projects.

The public doc server is hosted at http://www.rubydoc.info

Getting Started

This site is a public service and is community-supported. Patches and enhancements are welcome.

Requirements

Docker Desktop
Ruby 3.3+

Configuration

1. `config/rubydoc.yml`

This server uses typical Rails configuration, but we rely on a specific config/rubydoc.yml file to configure the application level settings. You should first copy the config/rubydoc.yml.sample file to config/rubydoc.yml and then edit the file to configure your server (although the defaults should provide a working experience).

cp config/rubydoc.yml.sample config/rubydoc.yml

2. Credentials

This Ruby on Rails application stores credentials in the config/credentials.yml.enc file, however for extra security this file is not checked into the repository. You can create your own credentials file by running:

rails credentials:edit

[!NOTE] You may need to export $VISUAL or $EDITOR to your preferred editor before running this command.

This is mosty only necessary when deploying or if using custom integrations. Since we do not use the session store, the standard Rails credentials are not used for the application.

Development

Clone the repository and run the setup script to install dependencies and create the database:

git clone git://github.com/docmeta/rubydoc.info
cd rubydoc.info
./bin/setup

You can also use ./bin/dev if you have already setup the project.

[!NOTE] Windows users must use WSL2 to run the development server.

Job Queue

You can inspect running jobs at http://localhost:3000/jobs in development. In production this URL is backed behind Basic Auth using mission_control-jobs.

Run WITHOUT_JOBS=1 ./bin/dev to disable the job queue in development. You can run ./bin/jobs to start a separate job queue process if needed.

Deploying

This server can be deployed using Docker swarm. In the case of a single node deployment, you can use the following commands to deploy the server:

./script/deploy

This will build the Docker image and deploy the server using the local configuration files.

Administration Commands

RubyDoc.info comes with a set of rails tasks that can be run to update remote gems, force documentation generate, or install Ruby stdlib documentation.

# Update remote gems
rails rubydoc:gems:update

# Install Ruby stdlib documentation for X.Y.Z
rails rubydoc:stdlib:install VERSION=X.Y.Z

# Generate documentation for a gem or github project (NAME=owner/repo VERSION=branch for github projects)
rails rubydoc:docs:generate NAME=library VERSION=X.Y.Z SOURCE=github|gem

Thanks

RubyDoc.info was created by Loren Segal (YARD) and Nick Plante (rdoc.info) and is a project of DOCMETA, LLC. Additional help was provided by our friendly developer community. Pull requests welcome!

Defined Under Namespace

Modules: Boosts, Builders, Clauses, Errors, Filters, Queries, Results, Types, Utils

Constant Summary collapse

VERSION =

"0.4.1"

Instance Attribute Summary

Attributes included from Utils::Configuration

#adapter, #client, #index_name, #log_color, #log_level, #logger, #url

Method Summary

Methods included from Utils::Configuration

client_options, configure, connect, extended, log, log_handler, set_default_configuration

Methods included from Utils::ClientActions

bulk, count, create, delete, exists, extended, index, mapping, query, refresh, search