diff --git "a/saved_models/fine_tune/ruby/docstring_list.json" "b/saved_models/fine_tune/ruby/docstring_list.json"
new file mode 100644--- /dev/null
+++ "b/saved_models/fine_tune/ruby/docstring_list.json"
@@ -0,0 +1 @@
+["Render but returns a valid Rack body. If fibers are defined, we return\n a streaming body that renders the template piece by piece.\n\n Note that partials are not supported to be rendered with streaming,\n so in such cases, we just wrap them in an array.", "+attribute_missing+ is like +method_missing+, but for attributes. When\n +method_missing+ is called we check to see if there is a matching\n attribute method. If so, we tell +attribute_missing+ to dispatch the\n attribute. This method can be overloaded to customize the behavior.", "Returns a struct representing the matching attribute method.\n The struct's attributes are prefix, base and suffix.", "Removes the module part from the expression in the string.\n\n demodulize('ActiveSupport::Inflector::Inflections') # => \"Inflections\"\n demodulize('Inflections') # => \"Inflections\"\n demodulize('::Inflections') # => \"Inflections\"\n demodulize('') # => \"\"\n\n See also #deconstantize.", "Mounts a regular expression, returned as a string to ease interpolation,\n that will match part by part the given constant.\n\n const_regexp(\"Foo::Bar::Baz\") # => \"Foo(::Bar(::Baz)?)?\"\n const_regexp(\"::\") # => \"::\"", "Applies inflection rules for +singularize+ and +pluralize+.\n\n If passed an optional +locale+ parameter, the uncountables will be\n found for that locale.\n\n apply_inflections('post', inflections.plurals, :en) # => \"posts\"\n apply_inflections('posts', inflections.singulars, :en) # => \"post\"", "Attempt to autoload the provided module name by searching for a directory\n matching the expected path suffix. If found, the module is created and\n assigned to +into+'s constants with the name +const_name+. Provided that\n the directory was loaded from a reloadable base path, it is added to the\n set of constants that are to be unloaded.", "Parse an XML Document string or IO into a simple hash.\n\n Same as XmlSimple::xml_in but doesn't shoot itself in the foot,\n and uses the defaults from Active Support.\n\n data::\n XML Document string or IO to parse", "Connects a model to the databases specified. The +database+ keyword\n takes a hash consisting of a +role+ and a +database_key+.\n\n This will create a connection handler for switching between connections,\n look up the config hash using the +database_key+ and finally\n establishes a connection to that config.\n\n class AnimalsModel < ApplicationRecord\n self.abstract_class = true\n\n connects_to database: { writing: :primary, reading: :primary_replica }\n end\n\n Returns an array of established connections.", "Clears the query cache for all connections associated with the current thread.", "turns 20170404131909 into \"2017_04_04_131909\"", "Keep it for indexing materialized views", "Returns a formatted string of the offset from UTC, or an alternative\n string if the time zone is already UTC.\n\n Time.zone = 'Eastern Time (US & Canada)' # => \"Eastern Time (US & Canada)\"\n Time.zone.now.formatted_offset(true) # => \"-05:00\"\n Time.zone.now.formatted_offset(false) # => \"-0500\"\n Time.zone = 'UTC' # => \"UTC\"\n Time.zone.now.formatted_offset(true, \"0\") # => \"0\"", "Uses Date to provide precise Time calculations for years, months, and days\n according to the proleptic Gregorian calendar. The result is returned as a\n new TimeWithZone object.\n\n The +options+ parameter takes a hash with any of these keys:\n :years , :months , :weeks , :days ,\n :hours , :minutes , :seconds .\n\n If advancing by a value of variable length (i.e., years, weeks, months,\n days), move forward from #time, otherwise move forward from #utc, for\n accuracy when moving across DST boundaries.\n\n Time.zone = 'Eastern Time (US & Canada)' # => 'Eastern Time (US & Canada)'\n now = Time.zone.now # => Sun, 02 Nov 2014 01:26:28 EDT -04:00\n now.advance(seconds: 1) # => Sun, 02 Nov 2014 01:26:29 EDT -04:00\n now.advance(minutes: 1) # => Sun, 02 Nov 2014 01:27:28 EDT -04:00\n now.advance(hours: 1) # => Sun, 02 Nov 2014 01:26:28 EST -05:00\n now.advance(days: 1) # => Mon, 03 Nov 2014 01:26:28 EST -05:00\n now.advance(weeks: 1) # => Sun, 09 Nov 2014 01:26:28 EST -05:00\n now.advance(months: 1) # => Tue, 02 Dec 2014 01:26:28 EST -05:00\n now.advance(years: 1) # => Mon, 02 Nov 2015 01:26:28 EST -05:00", "Calls the action going through the entire action dispatch stack.\n\n The actual method that is called is determined by calling\n #method_for_action. If no method can handle the action, then an\n AbstractController::ActionNotFound error is raised.\n\n ==== Returns\n * self ", "Passes each element of +candidates+ collection to ArrayInquirer collection.\n The method returns true if any element from the ArrayInquirer collection\n is equal to the stringified or symbolized form of any element in the +candidates+ collection.\n\n If +candidates+ collection is not given, method returns true.\n\n variants = ActiveSupport::ArrayInquirer.new([:phone, :tablet])\n\n variants.any? # => true\n variants.any?(:phone, :tablet) # => true\n variants.any?('phone', 'desktop') # => true\n variants.any?(:desktop, :watch) # => false", "Returns a stable cache key that can be used to identify this record.\n\n Product.new.cache_key # => \"products/new\"\n Product.find(5).cache_key # => \"products/5\"\n\n If ActiveRecord::Base.cache_versioning is turned off, as it was in Rails 5.1 and earlier,\n the cache key will also include a version.\n\n Product.cache_versioning = false\n Product.find(5).cache_key # => \"products/5-20071224150000\" (updated_at available)", "Returns +text+ wrapped at +len+ columns and indented +indent+ spaces.\n By default column length +len+ equals 72 characters and indent\n +indent+ equal two spaces.\n\n my_text = 'Here is a sample text with more than 40 characters'\n\n format_paragraph(my_text, 25, 4)\n # => \" Here is a sample text with\\n more than 40 characters\"", "Yields each batch of records that was found by the find options as\n an array.\n\n Person.where(\"age > 21\").find_in_batches do |group|\n sleep(50) # Make sure it doesn't get too crowded in there!\n group.each { |person| person.party_all_night! }\n end\n\n If you do not provide a block to #find_in_batches, it will return an Enumerator\n for chaining with other methods:\n\n Person.find_in_batches.with_index do |group, batch|\n puts \"Processing group ##{batch}\"\n group.each(&:recover_from_last_night!)\n end\n\n To be yielded each record one by one, use #find_each instead.\n\n ==== Options\n * :batch_size - Specifies the size of the batch. Defaults to 1000.\n * :start - Specifies the primary key value to start from, inclusive of the value.\n * :finish - Specifies the primary key value to end at, inclusive of the value.\n * :error_on_ignore - Overrides the application config to specify if an error should be raised when\n an order is present in the relation.\n\n Limits are honored, and if present there is no requirement for the batch\n size: it can be less than, equal to, or greater than the limit.\n\n The options +start+ and +finish+ are especially useful if you want\n multiple workers dealing with the same processing queue. You can make\n worker 1 handle all the records between id 1 and 9999 and worker 2\n handle from 10000 and beyond by setting the +:start+ and +:finish+\n option on each worker.\n\n # Let's process from record 10_000 on.\n Person.find_in_batches(start: 10_000) do |group|\n group.each { |person| person.party_all_night! }\n end\n\n NOTE: It's not possible to set the order. That is automatically set to\n ascending on the primary key (\"id ASC\") to make the batch ordering\n work. This also means that this method only works when the primary key is\n orderable (e.g. an integer or string).\n\n NOTE: By its nature, batch processing is subject to race conditions if\n other processes are modifying the database.", "See if error matches provided +attribute+, +type+ and +options+.", "`order_by` is an enumerable object containing keys of the cache,\n all keys are passed in whether found already or not.\n\n `cached_partials` is a hash. If the value exists\n it represents the rendered partial from the cache\n otherwise `Hash#fetch` will take the value of its block.\n\n This method expects a block that will return the rendered\n partial. An example is to render all results\n for each element that was not found in the cache and store it as an array.\n Order it so that the first empty cache element in `cached_partials`\n corresponds to the first element in `rendered_partials`.\n\n If the partial is not already cached it will also be\n written back to the underlying cache store.", "Runs the callbacks for the given event.\n\n Calls the before and around callbacks in the order they were set, yields\n the block (if given one), and then runs the after callbacks in reverse\n order.\n\n If the callback chain was halted, returns +false+. Otherwise returns the\n result of the block, +nil+ if no callbacks have been set, or +true+\n if callbacks have been set but no block is given.\n\n run_callbacks :save do\n save\n end\n\n--\n\n As this method is used in many places, and often wraps large portions of\n user code, it has an additional design goal of minimizing its impact on\n the visible call stack. An exception from inside a :before or :after\n callback can be as noisy as it likes -- but when control has passed\n smoothly through and into the supplied block, we want as little evidence\n as possible that we were here.", "If +file+ is the filename of a file that contains annotations this method returns\n a hash with a single entry that maps +file+ to an array of its annotations.\n Otherwise it returns an empty hash.", "Checks if we should perform parameters wrapping.", "create a new session. If a block is given, the new session will be yielded\n to the block before being returned.", "reloads the environment", "The DOM id convention is to use the singular form of an object or class with the id following an underscore.\n If no id is found, prefix with \"new_\" instead.\n\n dom_id(Post.find(45)) # => \"post_45\"\n dom_id(Post.new) # => \"new_post\"\n\n If you need to address multiple instances of the same class in the same view, you can prefix the dom_id:\n\n dom_id(Post.find(45), :edit) # => \"edit_post_45\"\n dom_id(Post.new, :custom) # => \"custom_post\"", "Evaluate given block in context of base class,\n so that you can write class macros here.\n When you define more than one +included+ block, it raises an exception.", "Define class methods from given block.\n You can define private class methods as well.\n\n module Example\n extend ActiveSupport::Concern\n\n class_methods do\n def foo; puts 'foo'; end\n\n private\n def bar; puts 'bar'; end\n end\n end\n\n class Buzz\n include Example\n end\n\n Buzz.foo # => \"foo\"\n Buzz.bar # => private method 'bar' called for Buzz:Class(NoMethodError)", "Convenience accessor.", "Checks if a signed message could have been generated by signing an object\n with the +MessageVerifier+'s secret.\n\n verifier = ActiveSupport::MessageVerifier.new 's3Krit'\n signed_message = verifier.generate 'a private message'\n verifier.valid_message?(signed_message) # => true\n\n tampered_message = signed_message.chop # editing the message invalidates the signature\n verifier.valid_message?(tampered_message) # => false", "Decodes the signed message using the +MessageVerifier+'s secret.\n\n verifier = ActiveSupport::MessageVerifier.new 's3Krit'\n\n signed_message = verifier.generate 'a private message'\n verifier.verified(signed_message) # => 'a private message'\n\n Returns +nil+ if the message was not signed with the same secret.\n\n other_verifier = ActiveSupport::MessageVerifier.new 'd1ff3r3nt-s3Krit'\n other_verifier.verified(signed_message) # => nil\n\n Returns +nil+ if the message is not Base64-encoded.\n\n invalid_message = \"f--46a0120593880c733a53b6dad75b42ddc1c8996d\"\n verifier.verified(invalid_message) # => nil\n\n Raises any error raised while decoding the signed message.\n\n incompatible_message = \"test--dad7b06c94abba8d46a15fafaef56c327665d5ff\"\n verifier.verified(incompatible_message) # => TypeError: incompatible marshal file format", "Generates a signed message for the provided value.\n\n The message is signed with the +MessageVerifier+'s secret. Without knowing\n the secret, the original value cannot be extracted from the message.\n\n verifier = ActiveSupport::MessageVerifier.new 's3Krit'\n verifier.generate 'a private message' # => \"BAhJIhRwcml2YXRlLW1lc3NhZ2UGOgZFVA==--e2d724331ebdee96a10fb99b089508d1c72bd772\"", "Creates a new job instance. Takes the arguments that will be\n passed to the perform method.\n Returns a hash with the job data that can safely be passed to the\n queuing adapter.", "Attaches the stored job data to the current instance. Receives a hash\n returned from +serialize+\n\n ==== Examples\n\n class DeliverWebhookJob < ActiveJob::Base\n attr_writer :attempt_number\n\n def attempt_number\n @attempt_number ||= 0\n end\n\n def serialize\n super.merge('attempt_number' => attempt_number + 1)\n end\n\n def deserialize(job_data)\n super\n self.attempt_number = job_data['attempt_number']\n end\n\n rescue_from(Timeout::Error) do |exception|\n raise exception if attempt_number > 5\n retry_job(wait: 10)\n end\n end", "Takes a path to a file. If the file is found, has valid encoding, and has\n correct read permissions, the return value is a URI-escaped string\n representing the filename. Otherwise, false is returned.\n\n Used by the +Static+ class to check the existence of a valid file\n in the server's +public/+ directory (see Static#call).", "Compares one Duration with another or a Numeric to this Duration.\n Numeric values are treated as seconds.\n Adds another Duration or a Numeric to this Duration. Numeric values\n are treated as seconds.", "Multiplies this Duration by a Numeric and returns a new Duration.", "Returns the modulo of this Duration by another Duration or Numeric.\n Numeric values are treated as seconds.", "Overload locale= to also set the I18n.locale. If the current I18n.config object responds\n to original_config, it means that it has a copy of the original I18n configuration and it's\n acting as proxy, which we need to skip.", "Normalizes the arguments and passes it on to find_templates.", "Handles templates caching. If a key is given and caching is on\n always check the cache before hitting the resolver. Otherwise,\n it always hits the resolver but if the key is present, check if the\n resolver is fresher before returning it.", "Extract handler, formats and variant from path. If a format cannot be found neither\n from the path, or the handler, we should return the array of formats given\n to the resolver.", "For streaming, instead of rendering a given a template, we return a Body\n object that responds to each. This object is initialized with a block\n that knows how to render the template.", "If the record is new or it has changed, returns true.", "Replaces non-ASCII characters with an ASCII approximation, or if none\n exists, a replacement character which defaults to \"?\".\n\n transliterate('\u00c6r\u00f8sk\u00f8bing')\n # => \"AEroskobing\"\n\n Default approximations are provided for Western/Latin characters,\n e.g, \"\u00f8\", \"\u00f1\", \"\u00e9\", \"\u00df\", etc.\n\n This method is I18n aware, so you can set up custom approximations for a\n locale. This can be useful, for example, to transliterate German's \"\u00fc\"\n and \"\u00f6\" to \"ue\" and \"oe\", or to add support for transliterating Russian\n to ASCII.\n\n In order to make your custom transliterations available, you must set\n them as the i18n.transliterate.rule i18n key:\n\n # Store the transliterations in locales/de.yml\n i18n:\n transliterate:\n rule:\n \u00fc: \"ue\"\n \u00f6: \"oe\"\n\n # Or set them using Ruby\n I18n.backend.store_translations(:de, i18n: {\n transliterate: {\n rule: {\n '\u00fc' => 'ue',\n '\u00f6' => 'oe'\n }\n }\n })\n\n The value for i18n.transliterate.rule can be a simple Hash that\n maps characters to ASCII approximations as shown above, or, for more\n complex requirements, a Proc:\n\n I18n.backend.store_translations(:de, i18n: {\n transliterate: {\n rule: ->(string) { MyTransliterator.transliterate(string) }\n }\n })\n\n Now you can have different transliterations for each locale:\n\n transliterate('J\u00fcrgen', locale: :en)\n # => \"Jurgen\"\n\n transliterate('J\u00fcrgen', locale: :de)\n # => \"Juergen\"", "Imports one error\n Imported errors are wrapped as a NestedError,\n providing access to original error object.\n If attribute or type needs to be overriden, use `override_options`.\n\n override_options - Hash\n @option override_options [Symbol] :attribute Override the attribute the error belongs to\n @option override_options [Symbol] :type Override type of the error.", "Removes all errors except the given keys. Returns a hash containing the removed errors.\n\n person.errors.keys # => [:name, :age, :gender, :city]\n person.errors.slice!(:age, :gender) # => { :name=>[\"cannot be nil\"], :city=>[\"cannot be nil\"] }\n person.errors.keys # => [:age, :gender]", "Search for errors matching +attribute+, +type+ or +options+.\n\n Only supplied params will be matched.\n\n person.errors.where(:name) # => all name errors.\n person.errors.where(:name, :too_short) # => all name errors being too short\n person.errors.where(:name, :too_short, minimum: 2) # => all name errors being too short and minimum is 2", "Delete messages for +key+. Returns the deleted messages.\n\n person.errors[:name] # => [\"cannot be nil\"]\n person.errors.delete(:name) # => [\"cannot be nil\"]\n person.errors[:name] # => []", "Iterates through each error key, value pair in the error messages hash.\n Yields the attribute and the error for that attribute. If the attribute\n has more than one error message, yields once for each error message.\n\n person.errors.add(:name, :blank, message: \"can't be blank\")\n person.errors.each do |attribute, error|\n # Will yield :name and \"can't be blank\"\n end\n\n person.errors.add(:name, :not_specified, message: \"must be specified\")\n person.errors.each do |attribute, error|\n # Will yield :name and \"can't be blank\"\n # then yield :name and \"must be specified\"\n end", "Returns an xml formatted representation of the Errors hash.\n\n person.errors.add(:name, :blank, message: \"can't be blank\")\n person.errors.add(:name, :not_specified, message: \"must be specified\")\n person.errors.to_xml\n # =>\n # \n # \n # name can't be blank \n # name must be specified \n # ", "Reverses the migration commands for the given block and\n the given migrations.\n\n The following migration will remove the table 'horses'\n and create the table 'apples' on the way up, and the reverse\n on the way down.\n\n class FixTLMigration < ActiveRecord::Migration[5.0]\n def change\n revert do\n create_table(:horses) do |t|\n t.text :content\n t.datetime :remind_at\n end\n end\n create_table(:apples) do |t|\n t.string :variety\n end\n end\n end\n\n Or equivalently, if +TenderloveMigration+ is defined as in the\n documentation for Migration:\n\n require_relative '20121212123456_tenderlove_migration'\n\n class FixupTLMigration < ActiveRecord::Migration[5.0]\n def change\n revert TenderloveMigration\n\n create_table(:apples) do |t|\n t.string :variety\n end\n end\n end\n\n This command can be nested.", "Outputs text along with how long it took to run its block.\n If the block returns an integer it assumes it is the number of rows affected.", "Determines the version number of the next migration.", "Used for running a specific migration.", "Used for running multiple migrations up to or down to a certain value.", "Sets the +permitted+ attribute to +true+. This can be used to pass\n mass assignment. Returns +self+.\n\n class Person < ActiveRecord::Base\n end\n\n params = ActionController::Parameters.new(name: \"Francesco\")\n params.permitted? # => false\n Person.new(params) # => ActiveModel::ForbiddenAttributesError\n params.permit!\n params.permitted? # => true\n Person.new(params) # => #", "This method accepts both a single key and an array of keys.\n\n When passed a single key, if it exists and its associated value is\n either present or the singleton +false+, returns said value:\n\n ActionController::Parameters.new(person: { name: \"Francesco\" }).require(:person)\n # => \"Francesco\"} permitted: false>\n\n Otherwise raises ActionController::ParameterMissing :\n\n ActionController::Parameters.new.require(:person)\n # ActionController::ParameterMissing: param is missing or the value is empty: person\n\n ActionController::Parameters.new(person: nil).require(:person)\n # ActionController::ParameterMissing: param is missing or the value is empty: person\n\n ActionController::Parameters.new(person: \"\\t\").require(:person)\n # ActionController::ParameterMissing: param is missing or the value is empty: person\n\n ActionController::Parameters.new(person: {}).require(:person)\n # ActionController::ParameterMissing: param is missing or the value is empty: person\n\n When given an array of keys, the method tries to require each one of them\n in order. If it succeeds, an array with the respective return values is\n returned:\n\n params = ActionController::Parameters.new(user: { ... }, profile: { ... })\n user_params, profile_params = params.require([:user, :profile])\n\n Otherwise, the method re-raises the first exception found:\n\n params = ActionController::Parameters.new(user: {}, profile: {})\n user_params, profile_params = params.require([:user, :profile])\n # ActionController::ParameterMissing: param is missing or the value is empty: user\n\n Technically this method can be used to fetch terminal values:\n\n # CAREFUL\n params = ActionController::Parameters.new(person: { name: \"Finn\" })\n name = params.require(:person).require(:name) # CAREFUL\n\n but take into account that at some point those ones have to be permitted:\n\n def person_params\n params.require(:person).permit(:name).tap do |person_params|\n person_params.require(:name) # SAFER\n end\n end\n\n for example.", "Adds existing keys to the params if their values are scalar.\n\n For example:\n\n puts self.keys #=> [\"zipcode(90210i)\"]\n params = {}\n\n permitted_scalar_filter(params, \"zipcode\")\n\n puts params.keys # => [\"zipcode\"]", "Overwrite process to setup I18n proxy.", "Find and render a template based on the options given.", "Normalize options.", "Enqueues the job to be performed by the queue adapter.\n\n ==== Options\n * :wait - Enqueues the job with the specified delay\n * :wait_until - Enqueues the job at the time specified\n * :queue - Enqueues the job on the specified queue\n * :priority - Enqueues the job with the specified priority\n\n ==== Examples\n\n my_job_instance.enqueue\n my_job_instance.enqueue wait: 5.minutes\n my_job_instance.enqueue queue: :important\n my_job_instance.enqueue wait_until: Date.tomorrow.midnight\n my_job_instance.enqueue priority: 10", "Returns a hash of rows to be inserted. The key is the table, the value is\n a list of rows to insert to that table.", "Loads the fixtures from the YAML file at +path+.\n If the file sets the +model_class+ and current instance value is not set,\n it uses the file value.", "Efficiently downloads blob data into the given file.", "Sets an HTTP 1.1 Cache-Control header. Defaults to issuing a +private+\n instruction, so that intermediate caches must not cache the response.\n\n expires_in 20.minutes\n expires_in 3.hours, public: true\n expires_in 3.hours, public: true, must_revalidate: true\n\n This method will overwrite an existing Cache-Control header.\n See https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html for more possibilities.\n\n HTTP Cache-Control Extensions for Stale Content. See https://tools.ietf.org/html/rfc5861\n It helps to cache an asset and serve it while is being revalidated and/or returning with an error.\n\n expires_in 3.hours, public: true, stale_while_revalidate: 60.seconds\n expires_in 3.hours, public: true, stale_while_revalidate: 60.seconds, stale_if_error: 5.minutes\n\n The method will also ensure an HTTP Date header for client compatibility.", "Cache or yield the block. The cache is supposed to never expire.\n\n You can use this method when you have an HTTP response that never changes,\n and the browser and proxies should cache it indefinitely.\n\n * +public+: By default, HTTP responses are private, cached only on the\n user's web browser. To allow proxies to cache the response, set +true+ to\n indicate that they can serve the cached response to all users.", "Executes a system command, capturing its binary output in a tempfile. Yields the tempfile.\n\n Use this method to shell out to a system library (e.g. muPDF or FFmpeg) for preview image\n generation. The resulting tempfile can be used as the +:io+ value in an attachable Hash:\n\n def preview\n download_blob_to_tempfile do |input|\n draw \"my-drawing-command\", input.path, \"--format\", \"png\", \"-\" do |output|\n yield io: output, filename: \"#{blob.filename.base}.png\", content_type: \"image/png\"\n end\n end\n end\n\n The output tempfile is opened in the directory returned by #tmpdir.", "Overwrite render_to_string because body can now be set to a Rack body.", "Normalize both text and status options.", "Process controller specific options, as status, content-type and location.", "Create a new +RemoteIp+ middleware instance.\n\n The +ip_spoofing_check+ option is on by default. When on, an exception\n is raised if it looks like the client is trying to lie about its own IP\n address. It makes sense to turn off this check on sites aimed at non-IP\n clients (like WAP devices), or behind proxies that set headers in an\n incorrect or confusing way (like AWS ELB).\n\n The +custom_proxies+ argument can take an Array of string, IPAddr, or\n Regexp objects which will be used instead of +TRUSTED_PROXIES+. If a\n single string, IPAddr, or Regexp object is provided, it will be used in\n addition to +TRUSTED_PROXIES+. Any proxy setup will put the value you\n want in the middle (or at the beginning) of the X-Forwarded-For list,\n with your proxy servers after it. If your proxies aren't removed, pass\n them in via the +custom_proxies+ parameter. That way, the middleware will\n ignore those IP addresses, and return the one that you want.\n Since the IP address may not be needed, we store the object here\n without calculating the IP to keep from slowing down the majority of\n requests. For those requests that do need to know the IP, the\n GetIp#calculate_ip method will calculate the memoized client IP address.", "Passes the record off to the class or classes specified and allows them\n to add errors based on more complex conditions.\n\n class Person\n include ActiveModel::Validations\n\n validate :instance_validations\n\n def instance_validations\n validates_with MyValidator\n end\n end\n\n Please consult the class method documentation for more information on\n creating your own validator.\n\n You may also pass it multiple classes, like so:\n\n class Person\n include ActiveModel::Validations\n\n validate :instance_validations, on: :create\n\n def instance_validations\n validates_with MyValidator, MyOtherValidator\n end\n end\n\n Standard configuration options (:on , :if and\n :unless ), which are available on the class version of\n +validates_with+, should instead be placed on the +validates+ method\n as these are applied and tested in the callback.\n\n If you pass any additional configuration options, they will be passed\n to the class and available as +options+, please refer to the\n class version of this method for more information.", "Render a template. If the template was not compiled yet, it is done\n exactly before rendering.\n\n This method is instrumented as \"!render_template.action_view\". Notice that\n we use a bang in this instrumentation because you don't want to\n consume this in production. This is only slow if it's being listened to.", "Compile a template. This method ensures a template is compiled\n just once and removes the source after it is compiled.", "Reloads the record from the database.\n\n This method finds the record by its primary key (which could be assigned\n manually) and modifies the receiver in-place:\n\n account = Account.new\n # => #\n account.id = 1\n account.reload\n # Account Load (1.2ms) SELECT \"accounts\".* FROM \"accounts\" WHERE \"accounts\".\"id\" = $1 LIMIT 1 [[\"id\", 1]]\n # => #\n\n Attributes are reloaded from the database, and caches busted, in\n particular the associations cache and the QueryCache.\n\n If the record no longer exists in the database ActiveRecord::RecordNotFound\n is raised. Otherwise, in addition to the in-place modification the method\n returns +self+ for convenience.\n\n The optional :lock flag option allows you to lock the reloaded record:\n\n reload(lock: true) # reload with pessimistic locking\n\n Reloading is commonly used in test suites to test something is actually\n written to the database, or when some action modifies the corresponding\n row in the database but not the object in memory:\n\n assert account.deposit!(25)\n assert_equal 25, account.credit # check it is updated in memory\n assert_equal 25, account.reload.credit # check it is also persisted\n\n Another common use case is optimistic locking handling:\n\n def with_optimistic_retry\n begin\n yield\n rescue ActiveRecord::StaleObjectError\n begin\n # Reload lock_version in particular.\n reload\n rescue ActiveRecord::RecordNotFound\n # If the record is gone there is nothing to do.\n else\n retry\n end\n end\n end", "Creates a masked version of the authenticity token that varies\n on each request. The masking is used to mitigate SSL attacks\n like BREACH.", "Checks the client's masked token to see if it matches the\n session token. Essentially the inverse of\n +masked_authenticity_token+.", "Checks if the request originated from the same origin by looking at the\n Origin header.", "Save the new record state and id of a record so it can be restored later if a transaction fails.", "Updates the attributes on this particular Active Record object so that\n if it's associated with a transaction, then the state of the Active Record\n object will be updated to reflect the current state of the transaction.\n\n The @transaction_state variable stores the states of the associated\n transaction. This relies on the fact that a transaction can only be in\n one rollback or commit (otherwise a list of states would be required).\n Each Active Record object inside of a transaction carries that transaction's\n TransactionState.\n\n This method checks to see if the ActiveRecord object's state reflects\n the TransactionState, and rolls back or commits the Active Record object\n as appropriate.", "Constant time string comparison, for fixed length strings.\n\n The values compared should be of fixed length, such as strings\n that have already been processed by HMAC. Raises in case of length mismatch.", "Constant time string comparison, for variable length strings.\n\n The values are first processed by SHA256, so that we don't leak length info\n via timing attacks.", "Declares a block that will be executed when a Rails component is fully\n loaded.\n\n Options:\n\n * :yield - Yields the object that run_load_hooks to +block+.\n * :run_once - Given +block+ will run only once.", "This method should return a hash with assigns.\n You can overwrite this configuration per controller.", "Normalize args and options.", "Provides options for converting numbers into formatted strings.\n Options are provided for phone numbers, currency, percentage,\n precision, positional notation, file size and pretty printing.\n\n ==== Options\n\n For details on which formats use which options, see ActiveSupport::NumberHelper\n\n ==== Examples\n\n Phone Numbers:\n 5551234.to_s(:phone) # => \"555-1234\"\n 1235551234.to_s(:phone) # => \"123-555-1234\"\n 1235551234.to_s(:phone, area_code: true) # => \"(123) 555-1234\"\n 1235551234.to_s(:phone, delimiter: ' ') # => \"123 555 1234\"\n 1235551234.to_s(:phone, area_code: true, extension: 555) # => \"(123) 555-1234 x 555\"\n 1235551234.to_s(:phone, country_code: 1) # => \"+1-123-555-1234\"\n 1235551234.to_s(:phone, country_code: 1, extension: 1343, delimiter: '.')\n # => \"+1.123.555.1234 x 1343\"\n\n Currency:\n 1234567890.50.to_s(:currency) # => \"$1,234,567,890.50\"\n 1234567890.506.to_s(:currency) # => \"$1,234,567,890.51\"\n 1234567890.506.to_s(:currency, precision: 3) # => \"$1,234,567,890.506\"\n 1234567890.506.to_s(:currency, locale: :fr) # => \"1 234 567 890,51 \u20ac\"\n -1234567890.50.to_s(:currency, negative_format: '(%u%n)')\n # => \"($1,234,567,890.50)\"\n 1234567890.50.to_s(:currency, unit: '£', separator: ',', delimiter: '')\n # => \"£1234567890,50\"\n 1234567890.50.to_s(:currency, unit: '£', separator: ',', delimiter: '', format: '%n %u')\n # => \"1234567890,50 £\"\n\n Percentage:\n 100.to_s(:percentage) # => \"100.000%\"\n 100.to_s(:percentage, precision: 0) # => \"100%\"\n 1000.to_s(:percentage, delimiter: '.', separator: ',') # => \"1.000,000%\"\n 302.24398923423.to_s(:percentage, precision: 5) # => \"302.24399%\"\n 1000.to_s(:percentage, locale: :fr) # => \"1 000,000%\"\n 100.to_s(:percentage, format: '%n %') # => \"100.000 %\"\n\n Delimited:\n 12345678.to_s(:delimited) # => \"12,345,678\"\n 12345678.05.to_s(:delimited) # => \"12,345,678.05\"\n 12345678.to_s(:delimited, delimiter: '.') # => \"12.345.678\"\n 12345678.to_s(:delimited, delimiter: ',') # => \"12,345,678\"\n 12345678.05.to_s(:delimited, separator: ' ') # => \"12,345,678 05\"\n 12345678.05.to_s(:delimited, locale: :fr) # => \"12 345 678,05\"\n 98765432.98.to_s(:delimited, delimiter: ' ', separator: ',')\n # => \"98 765 432,98\"\n\n Rounded:\n 111.2345.to_s(:rounded) # => \"111.235\"\n 111.2345.to_s(:rounded, precision: 2) # => \"111.23\"\n 13.to_s(:rounded, precision: 5) # => \"13.00000\"\n 389.32314.to_s(:rounded, precision: 0) # => \"389\"\n 111.2345.to_s(:rounded, significant: true) # => \"111\"\n 111.2345.to_s(:rounded, precision: 1, significant: true) # => \"100\"\n 13.to_s(:rounded, precision: 5, significant: true) # => \"13.000\"\n 111.234.to_s(:rounded, locale: :fr) # => \"111,234\"\n 13.to_s(:rounded, precision: 5, significant: true, strip_insignificant_zeros: true)\n # => \"13\"\n 389.32314.to_s(:rounded, precision: 4, significant: true) # => \"389.3\"\n 1111.2345.to_s(:rounded, precision: 2, separator: ',', delimiter: '.')\n # => \"1.111,23\"\n\n Human-friendly size in Bytes:\n 123.to_s(:human_size) # => \"123 Bytes\"\n 1234.to_s(:human_size) # => \"1.21 KB\"\n 12345.to_s(:human_size) # => \"12.1 KB\"\n 1234567.to_s(:human_size) # => \"1.18 MB\"\n 1234567890.to_s(:human_size) # => \"1.15 GB\"\n 1234567890123.to_s(:human_size) # => \"1.12 TB\"\n 1234567890123456.to_s(:human_size) # => \"1.1 PB\"\n 1234567890123456789.to_s(:human_size) # => \"1.07 EB\"\n 1234567.to_s(:human_size, precision: 2) # => \"1.2 MB\"\n 483989.to_s(:human_size, precision: 2) # => \"470 KB\"\n 1234567.to_s(:human_size, precision: 2, separator: ',') # => \"1,2 MB\"\n 1234567890123.to_s(:human_size, precision: 5) # => \"1.1228 TB\"\n 524288000.to_s(:human_size, precision: 5) # => \"500 MB\"\n\n Human-friendly format:\n 123.to_s(:human) # => \"123\"\n 1234.to_s(:human) # => \"1.23 Thousand\"\n 12345.to_s(:human) # => \"12.3 Thousand\"\n 1234567.to_s(:human) # => \"1.23 Million\"\n 1234567890.to_s(:human) # => \"1.23 Billion\"\n 1234567890123.to_s(:human) # => \"1.23 Trillion\"\n 1234567890123456.to_s(:human) # => \"1.23 Quadrillion\"\n 1234567890123456789.to_s(:human) # => \"1230 Quadrillion\"\n 489939.to_s(:human, precision: 2) # => \"490 Thousand\"\n 489939.to_s(:human, precision: 4) # => \"489.9 Thousand\"\n 1234567.to_s(:human, precision: 4,\n significant: false) # => \"1.2346 Million\"\n 1234567.to_s(:human, precision: 1,\n separator: ',',\n significant: false) # => \"1,2 Million\"", "Returns the config hash that corresponds with the environment\n\n If the application has multiple databases +default_hash+ will\n return the first config hash for the environment.\n\n { database: \"my_db\", adapter: \"mysql2\" }", "Returns a single DatabaseConfig object based on the requested environment.\n\n If the application has multiple databases +find_db_config+ will return\n the first DatabaseConfig for the environment.", "Returns the DatabaseConfigurations object as a Hash.", "An email was delivered.", "Returns the backtrace after all filters and silencers have been run\n against it. Filters run first, then silencers.", "Determine the template to be rendered using the given options.", "Renders the given template. A string representing the layout can be\n supplied as well.", "Set proper cache control and transfer encoding when streaming", "Call render_body if we are streaming instead of usual +render+.", "Determine the layout for a given name, taking into account the name type.\n\n ==== Parameters\n * name - The name of the template", "Returns the default layout for this controller.\n Optionally raises an exception if the layout could not be found.\n\n ==== Parameters\n * formats - The formats accepted to this layout\n * require_layout - If set to +true+ and layout is not found,\n an +ArgumentError+ exception is raised (defaults to +false+)\n\n ==== Returns\n * template - The template object for the default layout (or +nil+)", "Runs all the specified validations and returns +true+ if no errors were\n added otherwise +false+.\n\n class Person\n include ActiveModel::Validations\n\n attr_accessor :name\n validates_presence_of :name\n end\n\n person = Person.new\n person.name = ''\n person.valid? # => false\n person.name = 'david'\n person.valid? # => true\n\n Context can optionally be supplied to define which callbacks to test\n against (the context is defined on the validations using :on ).\n\n class Person\n include ActiveModel::Validations\n\n attr_accessor :name\n validates_presence_of :name, on: :new\n end\n\n person = Person.new\n person.valid? # => true\n person.valid?(:new) # => false", "Returns a message verifier object.\n\n This verifier can be used to generate and verify signed messages in the application.\n\n It is recommended not to use the same verifier for different things, so you can get different\n verifiers passing the +verifier_name+ argument.\n\n ==== Parameters\n\n * +verifier_name+ - the name of the message verifier.\n\n ==== Examples\n\n message = Rails.application.message_verifier('sensitive_data').generate('my sensible data')\n Rails.application.message_verifier('sensitive_data').verify(message)\n # => 'my sensible data'\n\n See the +ActiveSupport::MessageVerifier+ documentation for more information.", "Stores some of the Rails initial environment parameters which\n will be used by middlewares and engines to configure themselves.", "Shorthand to decrypt any encrypted configurations or files.\n\n For any file added with rails encrypted:edit call +read+ to decrypt\n the file with the master key.\n The master key is either stored in +config/master.key+ or ENV[\"RAILS_MASTER_KEY\"] .\n\n Rails.application.encrypted(\"config/mystery_man.txt.enc\").read\n # => \"We've met before, haven't we?\"\n\n It's also possible to interpret encrypted YAML files with +config+.\n\n Rails.application.encrypted(\"config/credentials.yml.enc\").config\n # => { next_guys_line: \"I don't think so. Where was it you think we met?\" }\n\n Any top-level configs are also accessible directly on the return value:\n\n Rails.application.encrypted(\"config/credentials.yml.enc\").next_guys_line\n # => \"I don't think so. Where was it you think we met?\"\n\n The files or configs can also be encrypted with a custom key. To decrypt with\n a key in the +ENV+, use:\n\n Rails.application.encrypted(\"config/special_tokens.yml.enc\", env_key: \"SPECIAL_TOKENS\")\n\n Or to decrypt with a file, that should be version control ignored, relative to +Rails.root+:\n\n Rails.application.encrypted(\"config/special_tokens.yml.enc\", key_path: \"config/special_tokens.key\")", "Returns the ordered railties for this application considering railties_order.", "Read the request \\body. This is useful for web services that need to\n work with raw requests directly.", "The request body is an IO input stream. If the RAW_POST_DATA environment\n variable is already set, wrap it in a StringIO.", "Override Rack's GET method to support indifferent access.", "Override Rack's POST method to support indifferent access.", "Sets up instance variables needed for rendering a partial. This method\n finds the options and details and extracts them. The method also contains\n logic that handles the type of object passed in as the partial.\n\n If +options[:partial]+ is a string, then the @path instance variable is\n set to that string. Otherwise, the +options[:partial]+ object must\n respond to +to_partial_path+ in order to setup the path.", "Obtains the path to where the object's partial is located. If the object\n responds to +to_partial_path+, then +to_partial_path+ will be called and\n will provide the path. If the object does not respond to +to_partial_path+,\n then an +ArgumentError+ is raised.\n\n If +prefix_partial_path_with_controller_namespace+ is true, then this\n method will prefix the partial paths with a namespace.", "Returns a serialized hash of your object.\n\n class Person\n include ActiveModel::Serialization\n\n attr_accessor :name, :age\n\n def attributes\n {'name' => nil, 'age' => nil}\n end\n\n def capitalized_name\n name.capitalize\n end\n end\n\n person = Person.new\n person.name = 'bob'\n person.age = 22\n person.serializable_hash # => {\"name\"=>\"bob\", \"age\"=>22}\n person.serializable_hash(only: :name) # => {\"name\"=>\"bob\"}\n person.serializable_hash(except: :name) # => {\"age\"=>22}\n person.serializable_hash(methods: :capitalized_name)\n # => {\"name\"=>\"bob\", \"age\"=>22, \"capitalized_name\"=>\"Bob\"}\n\n Example with :include option\n\n class User\n include ActiveModel::Serializers::JSON\n attr_accessor :name, :notes # Emulate has_many :notes\n def attributes\n {'name' => nil}\n end\n end\n\n class Note\n include ActiveModel::Serializers::JSON\n attr_accessor :title, :text\n def attributes\n {'title' => nil, 'text' => nil}\n end\n end\n\n note = Note.new\n note.title = 'Battle of Austerlitz'\n note.text = 'Some text here'\n\n user = User.new\n user.name = 'Napoleon'\n user.notes = [note]\n\n user.serializable_hash\n # => {\"name\" => \"Napoleon\"}\n user.serializable_hash(include: { notes: { only: 'title' }})\n # => {\"name\" => \"Napoleon\", \"notes\" => [{\"title\"=>\"Battle of Austerlitz\"}]}", "Returns a module with all the helpers defined for the engine.", "Returns the underlying Rack application for this engine.", "Defines the routes for this engine. If a block is given to\n routes, it is appended to the engine.", "Attaches an +attachable+ to the record.\n\n If the record is persisted and unchanged, the attachment is saved to\n the database immediately. Otherwise, it'll be saved to the DB when the\n record is next saved.\n\n person.avatar.attach(params[:avatar]) # ActionDispatch::Http::UploadedFile object\n person.avatar.attach(params[:signed_blob_id]) # Signed reference to blob from direct upload\n person.avatar.attach(io: File.open(\"/path/to/face.jpg\"), filename: \"face.jpg\", content_type: \"image/jpg\")\n person.avatar.attach(avatar_blob) # ActiveStorage::Blob object", "Reads the file for the given key in chunks, yielding each to the block.", "It accepts two parameters on initialization. The first is an array\n of files and the second is an optional hash of directories. The hash must\n have directories as keys and the value is an array of extensions to be\n watched under that directory.\n\n This method must also receive a block that will be called once a path\n changes. The array of files and list of directories cannot be changed\n after FileUpdateChecker has been initialized.\n Check if any of the entries were updated. If so, the watched and/or\n updated_at values are cached until the block is executed via +execute+\n or +execute_if_updated+.", "This method returns the maximum mtime of the files in +paths+, or +nil+\n if the array is empty.\n\n Files with a mtime in the future are ignored. Such abnormal situation\n can happen for example if the user changes the clock by hand. It is\n healthy to consider this edge case because with mtimes in the future\n reloading is not triggered.", "Allows you to measure the execution time of a block in a template and\n records the result to the log. Wrap this block around expensive operations\n or possible bottlenecks to get a time reading for the operation. For\n example, let's say you thought your file processing method was taking too\n long; you could wrap it in a benchmark block.\n\n <% benchmark 'Process data files' do %>\n <%= expensive_files_operation %>\n <% end %>\n\n That would add something like \"Process data files (345.2ms)\" to the log,\n which you can then use to compare timings when optimizing your code.\n\n You may give an optional logger level (:debug , :info ,\n :warn , :error ) as the :level option. The\n default logger level value is :info .\n\n <% benchmark 'Low-level files', level: :debug do %>\n <%= lowlevel_files_operation %>\n <% end %>\n\n Finally, you can pass true as the third argument to silence all log\n activity (other than the timing information) from inside the block. This\n is great for boiling down a noisy block to just a single statement that\n produces one log line:\n\n <% benchmark 'Process data files', level: :info, silence: true do %>\n <%= expensive_and_chatty_files_operation %>\n <% end %>", "Initializes new record from relation while maintaining the current\n scope.\n\n Expects arguments in the same format as {ActiveRecord::Base.new}[rdoc-ref:Core.new].\n\n users = User.where(name: 'DHH')\n user = users.new # => #\n\n You can also pass a block to new with the new record as argument:\n\n user = users.new { |user| user.name = 'Oscar' }\n user.name # => Oscar", "Tries to create a new record with the same scoped attributes\n defined in the relation. Returns the initialized object if validation fails.\n\n Expects arguments in the same format as\n {ActiveRecord::Base.create}[rdoc-ref:Persistence::ClassMethods#create].\n\n ==== Examples\n\n users = User.where(name: 'Oscar')\n users.create # => #\n\n users.create(name: 'fxn')\n users.create # => #\n\n users.create { |user| user.name = 'tenderlove' }\n # => #\n\n users.create(name: nil) # validation on name\n # => #", "Returns sql statement for the relation.\n\n User.where(name: 'Oscar').to_sql\n # => SELECT \"users\".* FROM \"users\" WHERE \"users\".\"name\" = 'Oscar'", "Initialize an empty model object from +attributes+.\n +attributes+ should be an attributes object, and unlike the\n `initialize` method, no assignment calls are made per attribute.", "Returns the contents of the record as a nicely formatted string.", "The main method that creates the message and renders the email templates. There are\n two ways to call this method, with a block, or without a block.\n\n It accepts a headers hash. This hash allows you to specify\n the most used headers in an email message, these are:\n\n * +:subject+ - The subject of the message, if this is omitted, Action Mailer will\n ask the Rails I18n class for a translated +:subject+ in the scope of\n [mailer_scope, action_name] or if this is missing, will translate the\n humanized version of the +action_name+\n * +:to+ - Who the message is destined for, can be a string of addresses, or an array\n of addresses.\n * +:from+ - Who the message is from\n * +:cc+ - Who you would like to Carbon-Copy on this email, can be a string of addresses,\n or an array of addresses.\n * +:bcc+ - Who you would like to Blind-Carbon-Copy on this email, can be a string of\n addresses, or an array of addresses.\n * +:reply_to+ - Who to set the Reply-To header of the email to.\n * +:date+ - The date to say the email was sent on.\n\n You can set default values for any of the above headers (except +:date+)\n by using the ::default class method:\n\n class Notifier < ActionMailer::Base\n default from: 'no-reply@test.lindsaar.net',\n bcc: 'email_logger@test.lindsaar.net',\n reply_to: 'bounces@test.lindsaar.net'\n end\n\n If you need other headers not listed above, you can either pass them in\n as part of the headers hash or use the headers['name'] = value \n method.\n\n When a +:return_path+ is specified as header, that value will be used as\n the 'envelope from' address for the Mail message. Setting this is useful\n when you want delivery notifications sent to a different address than the\n one in +:from+. Mail will actually use the +:return_path+ in preference\n to the +:sender+ in preference to the +:from+ field for the 'envelope\n from' value.\n\n If you do not pass a block to the +mail+ method, it will find all\n templates in the view paths using by default the mailer name and the\n method name that it is being called from, it will then create parts for\n each of these templates intelligently, making educated guesses on correct\n content type and sequence, and return a fully prepared Mail::Message \n ready to call :deliver on to send.\n\n For example:\n\n class Notifier < ActionMailer::Base\n default from: 'no-reply@test.lindsaar.net'\n\n def welcome\n mail(to: 'mikel@test.lindsaar.net')\n end\n end\n\n Will look for all templates at \"app/views/notifier\" with name \"welcome\".\n If no welcome template exists, it will raise an ActionView::MissingTemplate error.\n\n However, those can be customized:\n\n mail(template_path: 'notifications', template_name: 'another')\n\n And now it will look for all templates at \"app/views/notifications\" with name \"another\".\n\n If you do pass a block, you can render specific templates of your choice:\n\n mail(to: 'mikel@test.lindsaar.net') do |format|\n format.text\n format.html\n end\n\n You can even render plain text directly without using a template:\n\n mail(to: 'mikel@test.lindsaar.net') do |format|\n format.text { render plain: \"Hello Mikel!\" }\n format.html { render html: \"Hello Mikel! \".html_safe }\n end\n\n Which will render a +multipart/alternative+ email with +text/plain+ and\n +text/html+ parts.\n\n The block syntax also allows you to customize the part headers if desired:\n\n mail(to: 'mikel@test.lindsaar.net') do |format|\n format.text(content_transfer_encoding: \"base64\")\n format.html\n end", "Attaches one or more +attachables+ to the record.\n\n If the record is persisted and unchanged, the attachments are saved to\n the database immediately. Otherwise, they'll be saved to the DB when the\n record is next saved.\n\n document.images.attach(params[:images]) # Array of ActionDispatch::Http::UploadedFile objects\n document.images.attach(params[:signed_blob_id]) # Signed reference to blob from direct upload\n document.images.attach(io: File.open(\"/path/to/racecar.jpg\"), filename: \"racecar.jpg\", content_type: \"image/jpg\")\n document.images.attach([ first_blob, second_blob ])", "Sets the HTTP character set. In case of +nil+ parameter\n it sets the charset to +default_charset+.\n\n response.charset = 'utf-16' # => 'utf-16'\n response.charset = nil # => 'utf-8'", "Returns the number of days to the start of the week on the given day.\n Week is assumed to start on +start_day+, default is\n +Date.beginning_of_week+ or +config.beginning_of_week+ when set.", "remote_send sends a request to the remote endpoint.\n\n It blocks until the remote endpoint accepts the message.\n\n @param req [Object, String] the object to send or it's marshal form.\n @param marshalled [false, true] indicates if the object is already\n marshalled.", "send_status sends a status to the remote endpoint.\n\n @param code [int] the status code to send\n @param details [String] details\n @param assert_finished [true, false] when true(default), waits for\n FINISHED.\n @param metadata [Hash] metadata to send to the server. If a value is a\n list, mulitple metadata for its key are sent", "remote_read reads a response from the remote endpoint.\n\n It blocks until the remote endpoint replies with a message or status.\n On receiving a message, it returns the response after unmarshalling it.\n On receiving a status, it returns nil if the status is OK, otherwise\n raising BadStatus", "each_remote_read passes each response to the given block or returns an\n enumerator the responses if no block is given.\n Used to generate the request enumerable for\n server-side client-streaming RPC's.\n\n == Enumerator ==\n\n * #next blocks until the remote endpoint sends a READ or FINISHED\n * for each read, enumerator#next yields the response\n * on status\n * if it's is OK, enumerator#next raises StopException\n * if is not OK, enumerator#next raises RuntimeException\n\n == Block ==\n\n * if provided it is executed for each response\n * the call blocks until no more responses are provided\n\n @return [Enumerator] if no block was given", "each_remote_read_then_finish passes each response to the given block or\n returns an enumerator of the responses if no block is given.\n\n It is like each_remote_read, but it blocks on finishing on detecting\n the final message.\n\n == Enumerator ==\n\n * #next blocks until the remote endpoint sends a READ or FINISHED\n * for each read, enumerator#next yields the response\n * on status\n * if it's is OK, enumerator#next raises StopException\n * if is not OK, enumerator#next raises RuntimeException\n\n == Block ==\n\n * if provided it is executed for each response\n * the call blocks until no more responses are provided\n\n @return [Enumerator] if no block was given", "request_response sends a request to a GRPC server, and returns the\n response.\n\n @param req [Object] the request sent to the server\n @param metadata [Hash] metadata to be sent to the server. If a value is\n a list, multiple metadata for its key are sent\n @return [Object] the response received from the server", "client_streamer sends a stream of requests to a GRPC server, and\n returns a single response.\n\n requests provides an 'iterable' of Requests. I.e. it follows Ruby's\n #each enumeration protocol. In the simplest case, requests will be an\n array of marshallable objects; in typical case it will be an Enumerable\n that allows dynamic construction of the marshallable objects.\n\n @param requests [Object] an Enumerable of requests to send\n @param metadata [Hash] metadata to be sent to the server. If a value is\n a list, multiple metadata for its key are sent\n @return [Object] the response received from the server", "server_streamer sends one request to the GRPC server, which yields a\n stream of responses.\n\n responses provides an enumerator over the streamed responses, i.e. it\n follows Ruby's #each iteration protocol. The enumerator blocks while\n waiting for each response, stops when the server signals that no\n further responses will be supplied. If the implicit block is provided,\n it is executed with each response as the argument and no result is\n returned.\n\n @param req [Object] the request sent to the server\n @param metadata [Hash] metadata to be sent to the server. If a value is\n a list, multiple metadata for its key are sent\n @return [Enumerator|nil] a response Enumerator", "bidi_streamer sends a stream of requests to the GRPC server, and yields\n a stream of responses.\n\n This method takes an Enumerable of requests, and returns and enumerable\n of responses.\n\n == requests ==\n\n requests provides an 'iterable' of Requests. I.e. it follows Ruby's\n #each enumeration protocol. In the simplest case, requests will be an\n array of marshallable objects; in typical case it will be an\n Enumerable that allows dynamic construction of the marshallable\n objects.\n\n == responses ==\n\n This is an enumerator of responses. I.e, its #next method blocks\n waiting for the next response. Also, if at any point the block needs\n to consume all the remaining responses, this can be done using #each or\n #collect. Calling #each or #collect should only be done if\n the_call#writes_done has been called, otherwise the block will loop\n forever.\n\n @param requests [Object] an Enumerable of requests to send\n @param metadata [Hash] metadata to be sent to the server. If a value is\n a list, multiple metadata for its key are sent\n @return [Enumerator, nil] a response Enumerator", "run_server_bidi orchestrates a BiDi stream processing on a server.\n\n N.B. gen_each_reply is a func(Enumerable)\n\n It takes an enumerable of requests as an arg, in case there is a\n relationship between the stream of requests and the stream of replies.\n\n This does not mean that must necessarily be one. E.g, the replies\n produced by gen_each_reply could ignore the received_msgs\n\n @param mth [Proc] generates the BiDi stream replies\n @param interception_ctx [InterceptionContext]", "Creates a BidiCall.\n\n BidiCall should only be created after a call is accepted. That means\n different things on a client and a server. On the client, the call is\n accepted after call.invoke. On the server, this is after call.accept.\n\n #initialize cannot determine if the call is accepted or not; so if a\n call that's not accepted is used here, the error won't be visible until\n the BidiCall#run is called.\n\n deadline is the absolute deadline for the call.\n\n @param call [Call] the call used by the ActiveCall\n @param marshal [Function] f(obj)->string that marshal requests\n @param unmarshal [Function] f(string)->obj that unmarshals responses\n @param metadata_received [true|false] indicates if metadata has already\n been received. Should always be true for server calls\n Begins orchestration of the Bidi stream for a client sending requests.\n\n The method either returns an Enumerator of the responses, or accepts a\n block that can be invoked with each response.\n\n @param requests the Enumerable of requests to send\n @param set_input_stream_done [Proc] called back when we're done\n reading the input stream\n @param set_output_stream_done [Proc] called back when we're done\n sending data on the output stream\n @return an Enumerator of requests to yield", "Begins orchestration of the Bidi stream for a server generating replies.\n\n N.B. gen_each_reply is a func(Enumerable)\n\n It takes an enumerable of requests as an arg, in case there is a\n relationship between the stream of requests and the stream of replies.\n\n This does not mean that must necessarily be one. E.g, the replies\n produced by gen_each_reply could ignore the received_msgs\n\n @param [Proc] gen_each_reply generates the BiDi stream replies.\n @param [Enumerable] requests The enumerable of requests to run", "performs a read using @call.run_batch, ensures metadata is set up", "set_output_stream_done is relevant on client-side", "Provides an enumerator that yields results of remote reads", "Runs the given block on the queue with the provided args.\n\n @param args the args passed blk when it is called\n @param blk the block to call", "Starts running the jobs in the thread pool.", "Stops the jobs in the pool", "Forcibly shutdown any threads that are still alive.", "Creates a new RpcServer.\n\n The RPC server is configured using keyword arguments.\n\n There are some specific keyword args used to configure the RpcServer\n instance.\n\n * pool_size: the size of the thread pool the server uses to run its\n threads. No more concurrent requests can be made than the size\n of the thread pool\n\n * max_waiting_requests: Deprecated due to internal changes to the thread\n pool. This is still an argument for compatibility but is ignored.\n\n * poll_period: The amount of time in seconds to wait for\n currently-serviced RPC's to finish before cancelling them when shutting\n down the server.\n\n * pool_keep_alive: The amount of time in seconds to wait\n for currently busy thread-pool threads to finish before\n forcing an abrupt exit to each thread.\n\n * connect_md_proc:\n when non-nil is a proc for determining metadata to send back the client\n on receiving an invocation req. The proc signature is:\n {key: val, ..} func(method_name, {key: val, ...})\n\n * server_args:\n A server arguments hash to be passed down to the underlying core server\n\n * interceptors:\n Am array of GRPC::ServerInterceptor objects that will be used for\n intercepting server handlers to provide extra functionality.\n Interceptors are an EXPERIMENTAL API.\n\n stops a running server\n\n the call has no impact if the server is already stopped, otherwise\n server's current call loop is it's last.", "Can only be called while holding @run_mutex", "handle registration of classes\n\n service is either a class that includes GRPC::GenericService and whose\n #new function can be called without argument or any instance of such a\n class.\n\n E.g, after\n\n class Divider\n include GRPC::GenericService\n rpc :div DivArgs, DivReply # single request, single response\n def initialize(optional_arg='default option') # no args\n ...\n end\n\n srv = GRPC::RpcServer.new(...)\n\n # Either of these works\n\n srv.handle(Divider)\n\n # or\n\n srv.handle(Divider.new('replace optional arg'))\n\n It raises RuntimeError:\n - if service is not valid service class or object\n - its handler methods are already registered\n - if the server is already running\n\n @param service [Object|Class] a service class or object as described\n above", "runs the server\n\n - if no rpc_descs are registered, this exits immediately, otherwise it\n continues running permanently and does not return until program exit.\n\n - #running? returns true after this is called, until #stop cause the\n the server to stop.", "runs the server with signal handlers\n @param signals\n List of String, Integer or both representing signals that the user\n would like to send to the server for graceful shutdown\n @param wait_interval (optional)\n Integer seconds that user would like stop_server_thread to poll\n stop_server", "Sends RESOURCE_EXHAUSTED if there are too many unprocessed jobs", "Sends UNIMPLEMENTED if the method is not implemented by this server", "handles calls to the server", "Creates a new ClientStub.\n\n Minimally, a stub is created with the just the host of the gRPC service\n it wishes to access, e.g.,\n\n my_stub = ClientStub.new(example.host.com:50505,\n :this_channel_is_insecure)\n\n If a channel_override argument is passed, it will be used as the\n underlying channel. Otherwise, the channel_args argument will be used\n to construct a new underlying channel.\n\n There are some specific keyword args that are not used to configure the\n channel:\n\n - :channel_override\n when present, this must be a pre-created GRPC::Core::Channel. If it's\n present the host and arbitrary keyword arg areignored, and the RPC\n connection uses this channel.\n\n - :timeout\n when present, this is the default timeout used for calls\n\n @param host [String] the host the stub connects to\n @param creds [Core::ChannelCredentials|Symbol] the channel credentials, or\n :this_channel_is_insecure, which explicitly indicates that the client\n should be created with an insecure connection. Note: this argument is\n ignored if the channel_override argument is provided.\n @param channel_override [Core::Channel] a pre-created channel\n @param timeout [Number] the default timeout to use in requests\n @param propagate_mask [Number] A bitwise combination of flags in\n GRPC::Core::PropagateMasks. Indicates how data should be propagated\n from parent server calls to child client calls if this client is being\n used within a gRPC server.\n @param channel_args [Hash] the channel arguments. Note: this argument is\n ignored if the channel_override argument is provided.\n @param interceptors [Array] An array of\n GRPC::ClientInterceptor objects that will be used for\n intercepting calls before they are executed\n Interceptors are an EXPERIMENTAL API.\n request_response sends a request to a GRPC server, and returns the\n response.\n\n == Flow Control ==\n This is a blocking call.\n\n * it does not return until a response is received.\n\n * the requests is sent only when GRPC core's flow control allows it to\n be sent.\n\n == Errors ==\n An RuntimeError is raised if\n\n * the server responds with a non-OK status\n\n * the deadline is exceeded\n\n == Return Value ==\n\n If return_op is false, the call returns the response\n\n If return_op is true, the call returns an Operation, calling execute\n on the Operation returns the response.\n\n @param method [String] the RPC method to call on the GRPC server\n @param req [Object] the request sent to the server\n @param marshal [Function] f(obj)->string that marshals requests\n @param unmarshal [Function] f(string)->obj that unmarshals responses\n @param deadline [Time] (optional) the time the request should complete\n @param return_op [true|false] return an Operation if true\n @param parent [Core::Call] a prior call whose reserved metadata\n will be propagated by this one.\n @param credentials [Core::CallCredentials] credentials to use when making\n the call\n @param metadata [Hash] metadata to be sent to the server\n @return [Object] the response received from the server", "Creates a new active stub\n\n @param method [string] the method being called.\n @param marshal [Function] f(obj)->string that marshals requests\n @param unmarshal [Function] f(string)->obj that unmarshals responses\n @param parent [Grpc::Call] a parent call, available when calls are\n made from server\n @param credentials [Core::CallCredentials] credentials to use when making\n the call", "Lookup a Liquid variable in the given context.\n\n context - the Liquid context in question.\n variable - the variable name, as a string.\n\n Returns the value of the variable in the context\n or the variable name if not found.", "Determine which converters to use based on this document's\n extension.\n\n Returns Array of Converter instances.", "Prepare payload and render the document\n\n Returns String rendered document output", "Render the document.\n\n Returns String rendered document output\n rubocop: disable AbcSize", "Render layouts and place document content inside.\n\n Returns String rendered content", "Checks if the layout specified in the document actually exists\n\n layout - the layout to check\n Returns nothing", "Render layout content into document.output\n\n Returns String rendered content", "Set page content to payload and assign pager if document has one.\n\n Returns nothing", "Read Site data from disk and load it into internal data structures.\n\n Returns nothing.", "Recursively traverse directories with the read_directories function.\n\n base - The String representing the site's base directory.\n dir - The String representing the directory to traverse down.\n dot_dirs - The Array of subdirectories in the dir.\n\n Returns nothing.", "Read the entries from a particular directory for processing\n\n dir - The String representing the relative path of the directory to read.\n subfolder - The String representing the directory to read.\n\n Returns the list of entries to process", "Write static files, pages, and posts.\n\n Returns nothing.", "Construct a Hash of Posts indexed by the specified Post attribute.\n\n post_attr - The String name of the Post attribute.\n\n Examples\n\n post_attr_hash('categories')\n # => { 'tech' => [, ],\n # 'ruby' => [] }\n\n Returns the Hash: { attr => posts } where\n attr - One of the values for the requested attribute.\n posts - The Array of Posts with the given attr value.", "Get the implementation class for the given Converter.\n Returns the Converter instance implementing the given Converter.\n klass - The Class of the Converter to fetch.", "klass - class or module containing the subclasses.\n Returns array of instances of subclasses of parameter.\n Create array of instances of the subclasses of the class or module\n passed in as argument.", "Get all the documents\n\n Returns an Array of all Documents", "Disable Marshaling cache to disk in Safe Mode", "Finds a default value for a given setting, filtered by path and type\n\n path - the path (relative to the source) of the page,\n post or :draft the default is used in\n type - a symbol indicating whether a :page,\n a :post or a :draft calls this method\n\n Returns the default value or nil if none was found", "Collects a hash with all default values for a page or post\n\n path - the relative path of the page or post\n type - a symbol indicating the type (:post, :page or :draft)\n\n Returns a hash with all default values (an empty hash if there are none)", "Returns a list of valid sets\n\n This is not cached to allow plugins to modify the configuration\n and have their changes take effect\n\n Returns an array of hashes", "Retrieve a cached item\n Raises if key does not exist in cache\n\n Returns cached value", "Add an item to cache\n\n Returns nothing.", "Remove one particular item from the cache\n\n Returns nothing.", "Check if `key` already exists in this cache\n\n Returns true if key exists in the cache, false otherwise", "Given a hashed key, return the path to where this item would be saved on disk.", "Render Liquid in the content\n\n content - the raw Liquid content to render\n payload - the payload for Liquid\n info - the info for Liquid\n\n Returns the converted content", "Convert this Convertible's data to a Hash suitable for use by Liquid.\n\n Returns the Hash representation of this Convertible.", "Recursively render layouts\n\n layouts - a list of the layouts\n payload - the payload for Liquid\n info - the info for Liquid\n\n Returns nothing", "Add any necessary layouts to this convertible document.\n\n payload - The site payload Drop or Hash.\n layouts - A Hash of {\"name\" => \"layout\"}.\n\n Returns nothing.", "Require each of the runtime_dependencies specified by the theme's gemspec.\n\n Returns false only if no dependencies have been specified, otherwise nothing.", "Require all .rb files if safe mode is off\n\n Returns nothing.", "Initialize a new StaticFile.\n\n site - The Site.\n base - The String path to the .\n dir - The String path between and the file.\n name - The String filename of the file.\n rubocop: disable ParameterLists\n rubocop: enable ParameterLists\n Returns source file path.", "Merge some data in with this document's data.\n\n Returns the merged data.", "Merges a master hash with another hash, recursively.\n\n master_hash - the \"parent\" hash whose values will be overridden\n other_hash - the other hash whose values will be persisted after the merge\n\n This code was lovingly stolen from some random gem:\n http://gemjack.com/gems/tartan-0.1.1/classes/Hash.html\n\n Thanks to whoever made it.", "Read array from the supplied hash favouring the singular key\n and then the plural key, and handling any nil entries.\n\n hash - the hash to read from\n singular_key - the singular key\n plural_key - the plural key\n\n Returns an array", "Determine whether the given content string contains Liquid Tags or Vaiables\n\n Returns true is the string contains sequences of `{%` or `{{`", "Add an appropriate suffix to template so that it matches the specified\n permalink style.\n\n template - permalink template without trailing slash or file extension\n permalink_style - permalink style, either built-in or custom\n\n The returned permalink template will use the same ending style as\n specified in permalink_style. For example, if permalink_style contains a\n trailing slash (or is :pretty, which indirectly has a trailing slash),\n then so will the returned template. If permalink_style has a trailing\n \":output_ext\" (or is :none, :date, or :ordinal) then so will the returned\n template. Otherwise, template will be returned without modification.\n\n Examples:\n add_permalink_suffix(\"/:basename\", :pretty)\n # => \"/:basename/\"\n\n add_permalink_suffix(\"/:basename\", :date)\n # => \"/:basename:output_ext\"\n\n add_permalink_suffix(\"/:basename\", \"/:year/:month/:title/\")\n # => \"/:basename/\"\n\n add_permalink_suffix(\"/:basename\", \"/:year/:month/:title\")\n # => \"/:basename\"\n\n Returns the updated permalink template", "Replace each character sequence with a hyphen.\n\n See Utils#slugify for a description of the character sequence specified\n by each mode.", "Extract information from the page filename.\n\n name - The String filename of the page file.\n\n NOTE: `String#gsub` removes all trailing periods (in comparison to `String#chomp`)\n Returns nothing.", "Add any necessary layouts to this post\n\n layouts - The Hash of {\"name\" => \"layout\"}.\n site_payload - The site payload Hash.\n\n Returns String rendered page.", "Filters an array of objects against an expression\n\n input - the object array\n variable - the variable to assign each item to in the expression\n expression - a Liquid comparison expression passed in as a string\n\n Returns the filtered array of objects", "Sort an array of objects\n\n input - the object array\n property - property within each object to filter by\n nils ('first' | 'last') - nils appear before or after non-nil values\n\n Returns the filtered array of objects", "Sort the input Enumerable by the given property.\n If the property doesn't exist, return the sort order respective of\n which item doesn't have the property.\n We also utilize the Schwartzian transform to make this more efficient.", "`where` filter helper", "All the entries in this collection.\n\n Returns an Array of file paths to the documents in this collection\n relative to the collection's directory", "The full path to the directory containing the collection, with\n optional subpaths.\n\n *files - (optional) any other path pieces relative to the\n directory to append to the path\n\n Returns a String containing th directory name where the collection\n is stored on the filesystem.", "Add a path to the metadata\n\n Returns true, also on failure.", "Add a dependency of a path\n\n Returns nothing.", "Write the metadata to disk\n\n Returns nothing.", "Fetches the finished configuration for a given path. This will try to look for a specific value\n and fallback to a default value if nothing was found", "Use absolute paths instead of relative", "this endpoint is used by Xcode to fetch provisioning profiles.\n The response is an xml plist but has the added benefit of containing the appId of each provisioning profile.\n\n Use this method over `provisioning_profiles` if possible because no secondary API calls are necessary to populate the ProvisioningProfile data model.", "Ensures that there are csrf tokens for the appropriate entity type\n Relies on store_csrf_tokens to set csrf_tokens to the appropriate value\n then stores that in the correct place in cache\n This method also takes a block, if you want to send a custom request, instead of\n calling `.all` on the given klass. This is used for provisioning profiles.", "puts the screenshot into the frame", "Everything below is related to title, background, etc. and is not used in the easy mode\n\n this is used to correct the 1:1 offset information\n the offset information is stored to work for the template images\n since we resize the template images to have higher quality screenshots\n we need to modify the offset information by a certain factor", "Horizontal adding around the frames", "Minimum height for the title", "Returns a correctly sized background image", "Resize the frame as it's too low quality by default", "Add the title above or below the device", "This will build up to 2 individual images with the title and optional keyword, which will then be added to the real image", "Fetches the title + keyword for this particular screenshot", "The font we want to use", "If itc_provider was explicitly specified, use it.\n If there are multiple teams, infer the provider from the selected team name.\n If there are fewer than two teams, don't infer the provider.", "Responsible for setting all required header attributes for the requests\n to succeed", "Uploads the modified package back to App Store Connect\n @param app_id [Integer] The unique App ID\n @param dir [String] the path in which the package file is located\n @return (Bool) True if everything worked fine\n @raise [Deliver::TransporterTransferError] when something went wrong\n when transferring", "Returns the password to be used with the transporter", "Tells the user how to get an application specific password", "Used when creating a new certificate or profile", "Helpers\n Every installation setup that needs an Xcode project should\n call this method", "Set a new team ID which will be used from now on", "Returns preferred path for storing cookie\n for two step verification.", "Handles the paging for you... for free\n Just pass a block and use the parameter as page number", "Authenticates with Apple's web services. This method has to be called once\n to generate a valid session. The session will automatically be used from then\n on.\n\n This method will automatically use the username from the Appfile (if available)\n and fetch the password from the Keychain (if available)\n\n @param user (String) (optional): The username (usually the email address)\n @param password (String) (optional): The password\n\n @raise InvalidUserCredentialsError: raised if authentication failed\n\n @return (Spaceship::Client) The client the login method was called for", "This method is used for both the Apple Dev Portal and App Store Connect\n This will also handle 2 step verification and 2 factor authentication\n\n It is called in `send_login_request` of sub classes (which the method `login`, above, transferred over to via `do_login`)", "Get contract messages from App Store Connect's \"olympus\" endpoint", "This also gets called from subclasses", "Actually sends the request to the remote server\n Automatically retries the request up to 3 times if something goes wrong", "Returns a path relative to FastlaneFolder.path\n This is needed as the Preview.html file is located inside FastlaneFolder.path", "Renders all data available to quickly see if everything was correctly generated.\n @param export_path (String) The path to a folder where the resulting HTML file should be stored.", "Execute shell command", "pass an array of device types", "Append a lane to the current Fastfile template we're generating", "This method is responsible for ensuring there is a working\n Gemfile, and that `fastlane` is defined as a dependency\n while also having `rubygems` as a gem source", "Parses command options and executes actions", "Add entry to Apple Keychain using AccountManager", "This method takes care of creating a new 'deliver' folder, containing the app metadata\n and screenshots folders", "Checks if the gem name is still free on RubyGems", "Applies a series of replacement rules to turn the requested plugin name into one\n that is acceptable, returning that suggestion", "Hash of available signing identities", "Initializes the listing to use the given api client, language, and fills it with the current listing if available\n Updates the listing in the current edit", "Call this method to ask the user to re-enter the credentials\n @param force: if false, the user is asked before it gets deleted\n @return: Did the user decide to remove the old entry and enter a new password?", "Use env variables from this method to augment internet password item with additional data.\n These variables are used by Xamarin Studio to authenticate Apple developers.", "Called just as the investigation has begun.", "Called once the inspector has received a report with more than one issue.", "Shows a team selection for the user in the terminal. This should not be\n called on CI systems\n\n @param team_id (String) (optional): The ID of an App Store Connect team\n @param team_name (String) (optional): The name of an App Store Connect team", "Sometimes we get errors or info nested in our data\n This method allows you to pass in a set of keys to check for\n along with the name of the sub_section of your original data\n where we should check\n Returns a mapping of keys to data array if we find anything, otherwise, empty map", "Creates a new application on App Store Connect\n @param name (String): The name of your app as it will appear on the App Store.\n This can't be longer than 255 characters.\n @param primary_language (String): If localized app information isn't available in an\n App Store territory, the information from your primary language will be used instead.\n @param version *DEPRECATED: Use `Spaceship::Tunes::Application.ensure_version!` method instead*\n (String): The version number is shown on the App Store and should match the one you used in Xcode.\n @param sku (String): A unique ID for your app that is not visible on the App Store.\n @param bundle_id (String): The bundle ID must match the one you used in Xcode. It\n can't be changed after you submit your first build.", "Returns an array of all available pricing tiers\n\n @note Although this information is publicly available, the current spaceship implementation requires you to have a logged in client to access it\n\n @return [Array] the PricingTier objects (Spaceship::Tunes::PricingTier)\n [{\n \"tierStem\": \"0\",\n \"tierName\": \"Free\",\n \"pricingInfo\": [{\n \"country\": \"United States\",\n \"countryCode\": \"US\",\n \"currencySymbol\": \"$\",\n \"currencyCode\": \"USD\",\n \"wholesalePrice\": 0.0,\n \"retailPrice\": 0.0,\n \"fRetailPrice\": \"$0.00\",\n \"fWholesalePrice\": \"$0.00\"\n }, {\n ...\n }, {\n ...", "Returns an array of all supported territories\n\n @note Although this information is publicly available, the current spaceship implementation requires you to have a logged in client to access it\n\n @return [Array] the Territory objects (Spaceship::Tunes::Territory)", "Uploads a watch icon\n @param app_version (AppVersion): The version of your app\n @param upload_image (UploadFile): The icon to upload\n @return [JSON] the response", "Uploads an In-App-Purchase Review screenshot\n @param app_id (AppId): The id of the app\n @param upload_image (UploadFile): The icon to upload\n @return [JSON] the screenshot data, ready to be added to an In-App-Purchase", "Uploads a screenshot\n @param app_version (AppVersion): The version of your app\n @param upload_image (UploadFile): The image to upload\n @param device (string): The target device\n @param is_messages (Bool): True if the screenshot is for iMessage\n @return [JSON] the response", "Uploads an iMessage screenshot\n @param app_version (AppVersion): The version of your app\n @param upload_image (UploadFile): The image to upload\n @param device (string): The target device\n @return [JSON] the response", "Uploads the trailer preview\n @param app_version (AppVersion): The version of your app\n @param upload_trailer_preview (UploadFile): The trailer preview to upload\n @param device (string): The target device\n @return [JSON] the response", "Fetches the App Version Reference information from ITC\n @return [AppVersionRef] the response", "All build trains, even if there is no TestFlight", "updates an In-App-Purchases-Family", "updates an In-App-Purchases", "Creates an In-App-Purchases", "generates group hash used in the analytics time_series API.\n Using rank=DESCENDING and limit=3 as this is what the App Store Connect analytics dashboard uses.", "This is its own method so that it can re-try if the tests fail randomly\n @return true/false depending on if the tests succeeded", "Returns true if it succeeded", "Verifies the default value is also valid", "This method takes care of parsing and using the configuration file as values\n Call this once you know where the config file might be located\n Take a look at how `gym` uses this method\n\n @param config_file_name [String] The name of the configuration file to use (optional)\n @param block_for_missing [Block] A ruby block that is called when there is an unknown method\n in the configuration file", "Allows the user to call an action from an action", "Makes sure to get the value for the language\n Instead of using the user's value `UK English` spaceship should send\n `English_UK` to the server", "lookup if an alias exists", "This is being called from `method_missing` from the Fastfile\n It's also used when an action is called from another action\n @param from_action Indicates if this action is being trigged by another action.\n If so, it won't show up in summary.", "Called internally to setup the runner object\n\n @param lane [Lane] A lane object", "Makes sure a Fastfile is available\n Shows an appropriate message to the user\n if that's not the case\n return true if the Fastfile is available", "Make sure the version on App Store Connect matches the one in the ipa\n If not, the new version will automatically be created", "Upload all metadata, screenshots, pricing information, etc. to App Store Connect", "Upload the binary to App Store Connect", "Upload binary apk and obb and corresponding change logs with client\n\n @param [String] apk_path\n Path of the apk file to upload.\n\n @return [Integer] The apk version code returned after uploading, or nil if there was a problem", "returns only language directories from metadata_path", "searches for obbs in the directory where the apk is located and\n upload at most one main and one patch file. Do nothing if it finds\n more than one of either of them.", "Calls the appropriate methods for commander to show the available parameters", "Intialize with values from Scan.config matching these param names", "Aborts the current edit deleting all pending changes", "Commits the current edit saving all pending changes on Google Play", "Returns the listing for the given language filled with the current values if it already exists", "Get a list of all APK version codes - returns the list of version codes", "Get a list of all AAB version codes - returns the list of version codes", "Get list of version codes for track", "Returns an array of gems that are added to the Gemfile or Pluginfile", "Check if a plugin is added as dependency to either the\n Gemfile or the Pluginfile", "Modify the user's Gemfile to load the plugins", "Prints a table all the plugins that were loaded", "Some device commands fail if executed against a device path that does not exist, so this helper method\n provides a way to conditionally execute a block only if the provided path exists on the device.", "Return an array of packages that are installed on the device", "Fetches a profile matching the user's search requirements", "Create a new profile and return it", "Certificate to use based on the current distribution mode", "Downloads and stores the provisioning profile", "Makes sure the current App ID exists. If not, it will show an appropriate error message", "Download all valid provisioning profiles", "we got a server control command from the client to do something like shutdown", "send json back to client", "execute fastlane action command", "Get all available schemes in an array", "Let the user select a scheme\n Use a scheme containing the preferred_to_include string when multiple schemes were found", "Get all available configurations in an array", "Returns the build settings and sets the default scheme to the options hash", "Print tables to ask the user", "Make sure to call `load_from_filesystem` before calling upload", "Uploads metadata individually by language to help identify exactly which items have issues", "Makes sure all languages we need are actually created", "Loads the metadata files and stores them into the options object", "Normalizes languages keys from symbols to strings", "Identifies the resolution of a video or an image.\n Supports all video and images required by DU-UTC right now\n @param path (String) the path to the file", "Some actions have special handling in fast_file.rb, that means we can't directly call the action\n but we have to use the same logic that is in fast_file.rb instead.\n That's where this switch statement comes into play", "Builds the app and prepares the archive", "Post-processing of build_app", "Moves over the binary and dsym file to the output directory\n @return (String) The path to the resulting ipa file", "Copies the .app from the archive into the output directory", "Move the manifest.plist if exists into the output directory", "Move the app-thinning.plist file into the output directory", "Move the App Thinning Size Report.txt file into the output directory", "Move the Apps folder to the output directory", "compares the new file content to the old and figures out what api_version the new content should be", "expects format to be \"X.Y.Z\" where each value is a number", "Override Appfile configuration for a specific lane.\n\n lane_name - Symbol representing a lane name. (Can be either :name, 'name' or 'platform name')\n block - Block to execute to override configuration values.\n\n Discussion If received lane name does not match the lane name available as environment variable, no changes will\n be applied.", "compares source file against the target file's FastlaneRunnerAPIVersion and returned `true` if there is a difference", "currently just copies file, even if not needed.", "exceptions that happen in worker threads simply cause that thread\n to die and another to be spawned in its place.", "Write the character ch as part of a JSON string, escaping as appropriate.", "Write out the contents of the string str as a JSON string, escaping characters as appropriate.", "Write out the contents of the string as JSON string, base64-encoding\n the string's contents, and escaping as appropriate", "Convert the given double to a JSON string, which is either the number,\n \"NaN\" or \"Infinity\" or \"-Infinity\".", "Decodes the four hex parts of a JSON escaped string character and returns\n the character via out.\n\n Note - this only supports Unicode characters in the BMP (U+0000 to U+FFFF);\n characters above the BMP are encoded as two escape sequences (surrogate pairs),\n which is not yet implemented", "Decodes a JSON string, including unescaping, and returns the string via str", "Reads a block of base64 characters, decoding it, and returns via str", "Reads a sequence of characters, stopping at the first one that is not\n a valid JSON numeric character.", "Reads a sequence of characters and assembles them into a number,\n returning them via num", "Reads a JSON number or string and interprets it as a double.", "Writes a field based on the field information, field ID and value.\n\n field_info - A Hash containing the definition of the field:\n :name - The name of the field.\n :type - The type of the field, which must be a Thrift::Types constant.\n :binary - A Boolean flag that indicates if Thrift::Types::STRING is a binary string (string without encoding).\n fid - The ID of the field.\n value - The field's value to write; object type varies based on :type.\n\n Returns nothing.", "Writes a field value based on the field information.\n\n field_info - A Hash containing the definition of the field:\n :type - The Thrift::Types constant that determines how the value is written.\n :binary - A Boolean flag that indicates if Thrift::Types::STRING is a binary string (string without encoding).\n value - The field's value to write; object type varies based on field_info[:type].\n\n Returns nothing.", "Reads a field value based on the field information.\n\n field_info - A Hash containing the pertinent data to write:\n :type - The Thrift::Types constant that determines how the value is written.\n :binary - A flag that indicates if Thrift::Types::STRING is a binary string (string without encoding).\n\n Returns the value read; object type varies based on field_info[:type].", "The workhorse of writeFieldBegin. It has the option of doing a\n 'type override' of the type header. This is used specifically in the\n boolean field case.", "Abstract method for writing the start of lists and sets. List and sets on\n the wire differ only by the type indicator.", "Reads a number of bytes from the transport into the buffer passed.\n\n buffer - The String (byte buffer) to write data to; this is assumed to have a BINARY encoding.\n size - The number of bytes to read from the transport and write to the buffer.\n\n Returns the number of bytes read.", "1-based index into the fibonacci sequence", "Writes the output buffer to the stream in the format of a 4-byte length\n followed by the actual data.", "Parse an input into a URI object, optionally resolving it\n against a base URI if given.\n\n A URI object will have the following properties: scheme,\n userinfo, host, port, registry, path, opaque, query, and\n fragment.", "Escape a string for use in XPath expression", "This method returns true if the result should be stored as a new event.\n If mode is set to 'on_change', this method may return false and update an existing\n event to expire further in the future.", "Run all the queued up actions, parallelizing if possible.\n\n This will parallelize if and only if the provider of every machine\n supports parallelization and parallelization is possible from\n initialization of the class.", "Get a value by the given key.\n\n This will evaluate the block given to `register` and return the\n resulting value.", "Merge one registry with another and return a completely new\n registry. Note that the result cache is completely busted, so\n any gets on the new registry will result in a cache miss.", "Initializes Bundler and the various gem paths so that we can begin\n loading gems.", "Update updates the given plugins, or every plugin if none is given.\n\n @param [Hash] plugins\n @param [Array] specific Specific plugin names to update. If\n empty or nil, all plugins will be updated.", "Clean removes any unused gems.", "Iterates each configured RubyGem source to validate that it is properly\n available. If source is unavailable an exception is raised.", "Generate the builtin resolver set", "Activate a given solution", "Initializes a MachineIndex at the given file location.\n\n @param [Pathname] data_dir Path to the directory where data for the\n index can be stored. This folder should exist and must be writable.\n Deletes a machine by UUID.\n\n The machine being deleted with this UUID must either be locked\n by this index or must be unlocked.\n\n @param [Entry] entry The entry to delete.\n @return [Boolean] true if delete is successful", "Finds a machine where the UUID is prefixed by the given string.\n\n @return [Hash]", "Locks a machine exclusively to us, returning the file handle\n that holds the lock.\n\n If the lock cannot be acquired, then nil is returned.\n\n This should be called within an index lock.\n\n @return [File]", "Releases a local lock on a machine. This does not acquire any locks\n so make sure to lock around it.\n\n @param [String] id", "This will reload the data without locking the index. It is assumed\n the caller with lock the index outside of this call.\n\n @param [File] f", "This will hold a lock to the index so it can be read or updated.", "Loads the metadata associated with the box from the given\n IO.\n\n @param [IO] io An IO object to read the metadata from.\n Returns data about a single version that is included in this\n metadata.\n\n @param [String] version The version to return, this can also\n be a constraint.\n @return [Version] The matching version or nil if a matching\n version was not found.", "This prints out the help for the CLI.", "Action runner for executing actions in the context of this environment.\n\n @return [Action::Runner]", "Returns a list of machines that this environment is currently\n managing that physically have been created.\n\n An \"active\" machine is a machine that Vagrant manages that has\n been created. The machine itself may be in any state such as running,\n suspended, etc. but if a machine is \"active\" then it exists.\n\n Note that the machines in this array may no longer be present in\n the Vagrantfile of this environment. In this case the machine can\n be considered an \"orphan.\" Determining which machines are orphan\n and which aren't is not currently a supported feature, but will\n be in a future version.\n\n @return [Array]", "This creates a new batch action, yielding it, and then running it\n once the block is called.\n\n This handles the case where batch actions are disabled by the\n VAGRANT_NO_PARALLEL environmental variable.", "This defines a hook point where plugin action hooks that are registered\n against the given name will be run in the context of this environment.\n\n @param [Symbol] name Name of the hook.\n @param [Action::Runner] action_runner A custom action runner for running hooks.", "Returns the host object associated with this environment.\n\n @return [Class]", "This acquires a process-level lock with the given name.\n\n The lock file is held within the data directory of this environment,\n so make sure that all environments that are locking are sharing\n the same data directory.\n\n This will raise Errors::EnvironmentLockedError if the lock can't\n be obtained.\n\n @param [String] name Name of the lock, since multiple locks can\n be held at one time.", "This executes the push with the given name, raising any exceptions that\n occur.\n\n Precondition: the push is not nil and exists.", "This returns a machine with the proper provider for this environment.\n The machine named by `name` must be in this environment.\n\n @param [Symbol] name Name of the machine (as configured in the\n Vagrantfile).\n @param [Symbol] provider The provider that this machine should be\n backed by.\n @param [Boolean] refresh If true, then if there is a cached version\n it is reloaded.\n @return [Machine]", "This creates the local data directory and show an error if it\n couldn't properly be created.", "Check for any local plugins defined within the Vagrantfile. If\n found, validate they are available. If they are not available,\n request to install them, or raise an exception\n\n @return [Hash] plugin list for loading", "This method copies the private key into the home directory if it\n doesn't already exist.\n\n This must be done because `ssh` requires that the key is chmod\n 0600, but if Vagrant is installed as a separate user, then the\n effective uid won't be able to read the key. So the key is copied\n to the home directory and chmod 0600.", "Finds the Vagrantfile in the given directory.\n\n @param [Pathname] path Path to search in.\n @return [Pathname]", "This upgrades a home directory that was in the v1.1 format to the\n v1.5 format. It will raise exceptions if anything fails.", "This upgrades a Vagrant 1.0.x \"dotfile\" to the new V2 format.\n\n This is a destructive process. Once the upgrade is complete, the\n old dotfile is removed, and the environment becomes incompatible for\n Vagrant 1.0 environments.\n\n @param [Pathname] path The path to the dotfile", "This will detect the proper guest OS for the machine and set up\n the class to actually execute capabilities.", "Initializes by loading a Vagrantfile.\n\n @param [Config::Loader] loader Configuration loader that should\n already be configured with the proper Vagrantfile locations.\n This usually comes from {Vagrant::Environment}\n @param [Array] keys The Vagrantfiles to load and the\n order to load them in (keys within the loader).\n Returns a {Machine} for the given name and provider that\n is represented by this Vagrantfile.\n\n @param [Symbol] name Name of the machine.\n @param [Symbol] provider The provider the machine should\n be backed by (required for provider overrides).\n @param [BoxCollection] boxes BoxCollection to look up the\n box Vagrantfile.\n @param [Pathname] data_path Path where local machine data\n can be stored.\n @param [Environment] env The environment running this machine\n @return [Machine]", "Returns a list of the machine names as well as the options that\n were specified for that machine.\n\n @return [Hash]", "Returns the name of the machine that is designated as the\n \"primary.\"\n\n In the case of a single-machine environment, this is just the\n single machine name. In the case of a multi-machine environment,\n then this is the machine that is marked as primary, or nil if\n no primary machine was specified.\n\n @return [Symbol]", "Initialize a new machine.\n\n @param [String] name Name of the virtual machine.\n @param [Class] provider The provider backing this machine. This is\n currently expected to be a V1 `provider` plugin.\n @param [Object] provider_config The provider-specific configuration for\n this machine.\n @param [Hash] provider_options The provider-specific options from the\n plugin definition.\n @param [Object] config The configuration for this machine.\n @param [Pathname] data_dir The directory where machine-specific data\n can be stored. This directory is ensured to exist.\n @param [Box] box The box that is backing this virtual machine.\n @param [Environment] env The environment that this machine is a\n part of.\n This calls an action on the provider. The provider may or may not\n actually implement the action.\n\n @param [Symbol] name Name of the action to run.\n @param [Hash] extra_env This data will be passed into the action runner\n as extra data set on the environment hash for the middleware\n runner.", "This calls a raw callable in the proper context of the machine using\n the middleware stack.\n\n @param [Symbol] name Name of the action\n @param [Proc] callable\n @param [Hash] extra_env Extra env for the action env.\n @return [Hash] The resulting env", "This sets the unique ID associated with this machine. This will\n persist this ID so that in the future Vagrant will be able to find\n this machine again. The unique ID must be absolutely unique to the\n virtual machine, and can be used by providers for finding the\n actual machine associated with this instance.\n\n **WARNING:** Only providers should ever use this method.\n\n @param [String] value The ID.", "This reloads the ID of the underlying machine.", "Returns the state of this machine. The state is queried from the\n backing provider, so it can be any arbitrary symbol.\n\n @return [MachineState]", "Checks the current directory for a given machine\n and displays a warning if that machine has moved\n from its previous location on disk. If the machine\n has moved, it prints a warning to the user.", "This returns an array of all the boxes on the system, given by\n their name and their provider.\n\n @return [Array] Array of `[name, version, provider]` of the boxes\n installed on this system.", "Find a box in the collection with the given name and provider.\n\n @param [String] name Name of the box (logical name).\n @param [Array] providers Providers that the box implements.\n @param [String] version Version constraints to adhere to. Example:\n \"~> 1.0\" or \"= 1.0, ~> 1.1\"\n @return [Box] The box found, or `nil` if not found.", "This upgrades a v1.1 - v1.4 box directory structure up to a v1.5\n directory structure. This will raise exceptions if it fails in any\n way.", "Cleans the directory for a box by removing the folders that are\n empty.", "Returns the directory name for the box of the given name.\n\n @param [String] name\n @return [String]", "Returns the directory name for the box cleaned up", "This upgrades the V1 box contained unpacked in the given directory\n and returns the directory of the upgraded version. This is\n _destructive_ to the contents of the old directory. That is, the\n contents of the old V1 box will be destroyed or moved.\n\n Preconditions:\n * `dir` is a valid V1 box. Verify with {#v1_box?}\n\n @param [Pathname] dir Directory where the V1 box is unpacked.\n @return [Pathname] Path to the unpackaged V2 box.", "This is a helper that makes sure that our temporary directories\n are cleaned up no matter what.\n\n @param [String] dir Path to a temporary directory\n @return [Object] The result of whatever the yield is", "Initializes the capability system by detecting the proper capability\n host to execute on and building the chain of capabilities to execute.\n\n @param [Symbol] host The host to use for the capabilities, or nil if\n we should auto-detect it.\n @param [Hash>] hosts Potential capability\n hosts. The key is the name of the host, value[0] is a class that\n implements `#detect?` and value[1] is a parent host (if any).\n @param [Hash>] capabilities The capabilities\n that are supported. The key is the host of the capability. Within that\n is a hash where the key is the name of the capability and the value\n is the class/module implementing it.", "Executes the capability with the given name, optionally passing more\n arguments onwards to the capability. If the capability returns a value,\n it will be returned.\n\n @param [Symbol] cap_name Name of the capability", "Returns the registered module for a capability with the given name.\n\n @param [Symbol] cap_name\n @return [Module]", "Checks if this box is in use according to the given machine\n index and returns the entries that appear to be using the box.\n\n The entries returned, if any, are not tested for validity\n with {MachineIndex::Entry#valid?}, so the caller should do that\n if the caller cares.\n\n @param [MachineIndex] index\n @return [Array]", "Loads the metadata URL and returns the latest metadata associated\n with this box.\n\n @param [Hash] download_options Options to pass to the downloader.\n @return [BoxMetadata]", "Checks if the box has an update and returns the metadata, version,\n and provider. If the box doesn't have an update that satisfies the\n constraints, it will return nil.\n\n This will potentially make a network call if it has to load the\n metadata from the network.\n\n @param [String] version Version constraints the update must\n satisfy. If nil, the version constrain defaults to being a\n larger version than this box.\n @return [Array]", "Check if a box update check is allowed. Uses a file\n in the box data directory to track when the last auto\n update check was performed and returns true if the\n BOX_UPDATE_CHECK_INTERVAL has passed.\n\n @return [Boolean]", "This repackages this box and outputs it to the given path.\n\n @param [Pathname] path The full path (filename included) of where\n to output this box.\n @return [Boolean] true if this succeeds.", "This interprets a raw line from the aliases file.", "This registers an alias.", "Halt processing and redirect to the URI provided.", "Generates the absolute URI for a given path in the app.\n Takes Rack routers and reverse proxies into account.", "Set the Content-Type of the response body given a media type or file\n extension.", "Allows to start sending data to the client even though later parts of\n the response body have not yet been generated.\n\n The close parameter specifies whether Stream#close should be called\n after the block has been executed. This is only relevant for evented\n servers like Thin or Rainbows.", "Helper method checking if a ETag value list includes the current ETag.", "logic shared between builder and nokogiri", "Run filters defined on the class and all superclasses.", "Run routes defined on the class and all superclasses.", "Creates a Hash with indifferent access.", "reduce 21 omitted", "Set Engine's dry_run_mode true to override all target_id of worker sections", "This method returns MultiEventStream, because there are no reason\n to surve binary serialized by msgpack.", "return chunk id to be committed", "to include TimeParseError", "search a plugin by plugin_id", "This method returns an array because\n multiple plugins could have the same type", "get monitor info from the plugin `pe` and return a hash object", "Sanitize the parameters for a specific +action+.\n\n === Arguments\n\n * +action+ - A +Symbol+ with the action that the controller is\n performing, like +sign_up+, +sign_in+, etc.\n\n === Examples\n\n # Inside the `RegistrationsController#create` action.\n resource = build_resource(devise_parameter_sanitizer.sanitize(:sign_up))\n resource.save\n\n Returns an +ActiveSupport::HashWithIndifferentAccess+ with the permitted\n attributes.", "Add or remove new parameters to the permitted list of an +action+.\n\n === Arguments\n\n * +action+ - A +Symbol+ with the action that the controller is\n performing, like +sign_up+, +sign_in+, etc.\n * +keys:+ - An +Array+ of keys that also should be permitted.\n * +except:+ - An +Array+ of keys that shouldn't be permitted.\n * +block+ - A block that should be used to permit the action\n parameters instead of the +Array+ based approach. The block will be\n called with an +ActionController::Parameters+ instance.\n\n === Examples\n\n # Adding new parameters to be permitted in the `sign_up` action.\n devise_parameter_sanitizer.permit(:sign_up, keys: [:subscribe_newsletter])\n\n # Removing the `password` parameter from the `account_update` action.\n devise_parameter_sanitizer.permit(:account_update, except: [:password])\n\n # Using the block form to completely override how we permit the\n # parameters for the `sign_up` action.\n devise_parameter_sanitizer.permit(:sign_up) do |user|\n user.permit(:email, :password, :password_confirmation)\n end\n\n\n Returns nothing.", "Force keys to be string to avoid injection on mongoid related database.", "Parse source code.\n Returns self for easy chaining", "Render takes a hash with local variables.\n\n if you use the same filters over and over again consider registering them globally\n with Template.register_filter \n\n if profiling was enabled in Template#parse then the resulting profiling information\n will be available via Template#profiler \n\n Following options can be passed:\n\n * filters : array with local filters\n * registers : hash with register variables. Those can be accessed from\n filters and tags and might be useful to integrate liquid more with its host application", "Truncate a string down to x characters", "Sort elements of the array\n provide optional property with which to sort an array of hashes or drops", "Filter the elements of an array to those with a certain property value.\n By default the target is any truthy value.", "Remove duplicate elements from an array\n provide optional property with which to determine uniqueness", "Replace occurrences of a string with another", "Replace the first occurrences of a string with another", "Pushes a new local scope on the stack, pops it at the end of the block\n\n Example:\n context.stack do\n context['var'] = 'hi'\n end\n\n context['var] #=> nil", "Fetches an object starting at the local scope and then moving up the hierachy", "Restore an offense object loaded from a JSON file.", "Checks if there is whitespace before token", "Sets a value in the @options hash, based on the given long option and its\n value, in addition to calling the block if a block is given.", "Returns true if there's a chance that an Include pattern matches hidden\n files, false if that's definitely not possible.", "Check whether a run created source identical to a previous run, which\n means that we definitely have an infinite loop.", "Finds all Ruby source files under the current or other supplied\n directory. A Ruby source file is defined as a file with the `.rb`\n extension or a file with no extension that has a ruby shebang line\n as its first line.\n It is possible to specify includes and excludes using the config file,\n so you can include other Ruby files like Rakefiles and gemspecs.\n @param base_dir Root directory under which to search for\n ruby source files\n @return [Array] Array of filenames", "The checksum of the rubocop program running the inspection.", "Return a hash of the options given at invocation, minus the ones that have\n no effect on which offenses and disabled line ranges are found, and thus\n don't affect caching.", "Return a recursive merge of two hashes. That is, a normal hash merge,\n with the addition that any value that is a hash, and occurs in both\n arguments, will also be merged. And so on.\n\n rubocop:disable Metrics/AbcSize", "DoppelGanger implementation of build_node. preserves as many of the node's\n attributes, and does not save updates to the server", "paper over inconsistencies in the model classes APIs, and return the objects\n the user wanted instead of the URI=>object stuff", "Apply default configuration values for workstation-style tools.\n\n Global defaults should go in {ChefConfig::Config} instead, this is only\n for things like `knife` and `chef`.\n\n @api private\n @since 14.3\n @return [void]", "Look for a default key file.\n\n This searches for any of a list of possible default keys, checking both\n the local `.chef/` folder and the home directory `~/.chef/`. Returns `nil`\n if no matching file is found.\n\n @api private\n @since 14.3\n @param key_names [Array] A list of possible filenames to check for.\n The first one found will be returned.\n @return [String, nil]", "Set or retrieve the response status code.", "Loads the configuration from the YAML files whose +paths+ are passed as\n arguments, filtering the settings for the current environment. Note that\n these +paths+ can actually be globs.", "Returns true if supplied with a hash that has any recognized\n +environments+ in its root keys.", "Sets Link HTTP header and returns HTML tags for using stylesheets.", "Sets Link HTTP header and returns corresponding HTML tags.\n\n Example:\n\n # Sets header:\n # Link: ; rel=\"next\"\n # Returns String:\n # ' '\n link '/foo', :rel => :next\n\n # Multiple URLs\n link :stylesheet, '/a.css', '/b.css'", "Parse a file of run definitions and yield each run.\n\n @params [ String ] file The YAML file containing the matrix of test run definitions.\n\n @yieldparam [ Hash ] A test run definition.\n\n @since 7.0.0", "Adds an attribute to the factory.\n The attribute value will be generated \"lazily\"\n by calling the block whenever an instance is generated.\n The block will not be called if the\n attribute is overridden for a specific instance.\n\n Arguments:\n * name: +Symbol+ or +String+\n The name of this attribute. This will be assigned using \"name=\" for\n generated instances.", "Adds an attribute that will have unique values generated by a sequence with\n a specified format.\n\n The result of:\n factory :user do\n sequence(:email) { |n| \"person#{n}@example.com\" }\n end\n\n Is equal to:\n sequence(:email) { |n| \"person#{n}@example.com\" }\n\n factory :user do\n email { FactoryBot.generate(:email) }\n end\n\n Except that no globally available sequence will be defined.", "Adds an attribute that builds an association. The associated instance will\n be built using the same build strategy as the parent instance.\n\n Example:\n factory :user do\n name 'Joey'\n end\n\n factory :post do\n association :author, factory: :user\n end\n\n Arguments:\n * name: +Symbol+\n The name of this attribute.\n * options: +Hash+\n\n Options:\n * factory: +Symbol+ or +String+\n The name of the factory to use when building the associated instance.\n If no name is given, the name of the attribute is assumed to be the\n name of the factory. For example, a \"user\" association will by\n default use the \"user\" factory.", "A lookahead for the root selections of this query\n @return [GraphQL::Execution::Lookahead]", "Get the result for this query, executing it once\n @return [Hash] A GraphQL response, with `\"data\"` and/or `\"errors\"` keys", "Declare that this object implements this interface.\n This declaration will be validated when the schema is defined.\n @param interfaces [Array] add a new interface that this type implements\n @param inherits [Boolean] If true, copy the interfaces' field definitions to this type", "Given a callable whose API used to take `from` arguments,\n check its arity, and if needed, apply a wrapper so that\n it can be called with `to` arguments.\n If a wrapper is applied, warn the application with `name`.\n\n If `last`, then use the last arguments to call the function.", "`event` was triggered on `object`, and `subscription_id` was subscribed,\n so it should be updated.\n\n Load `subscription_id`'s GraphQL data, re-evaluate the query, and deliver the result.\n\n This is where a queue may be inserted to push updates in the background.\n\n @param subscription_id [String]\n @param event [GraphQL::Subscriptions::Event] The event which was triggered\n @param object [Object] The value for the subscription field\n @return [void]", "Event `event` occurred on `object`,\n Update all subscribers.\n @param event [Subscriptions::Event]\n @param object [Object]\n @return [void]", "Return a GraphQL string for the type definition\n @param schema [GraphQL::Schema]\n @param printer [GraphQL::Schema::Printer]\n @see {GraphQL::Schema::Printer#initialize for additional options}\n @return [String] type definition", "Use the provided `method_name` to generate a string from the specified schema\n then write it to `file`.", "Use the Rake DSL to add tasks", "Prepare a lazy value for this field. It may be `then`-ed and resolved later.\n @return [GraphQL::Execution::Lazy] A lazy wrapper around `obj` and its registered method name", "Returns true if `member, ctx` passes this filter", "Visit `query`'s internal representation, calling `analyzers` along the way.\n\n - First, query analyzers are filtered down by calling `.analyze?(query)`, if they respond to that method\n - Then, query analyzers are initialized by calling `.initial_value(query)`, if they respond to that method.\n - Then, they receive `.call(memo, visit_type, irep_node)`, where visit type is `:enter` or `:leave`.\n - Last, they receive `.final_value(memo)`, if they respond to that method.\n\n It returns an array of final `memo` values in the order that `analyzers` were passed in.\n\n @param query [GraphQL::Query]\n @param analyzers [Array<#call>] Objects that respond to `#call(memo, visit_type, irep_node)`\n @return [Array] Results from those analyzers", "Enter the node, visit its children, then leave the node.", "Validate a query string according to this schema.\n @param string_or_document [String, GraphQL::Language::Nodes::Document]\n @return [Array]", "Execute a query on itself. Raises an error if the schema definition is invalid.\n @see {Query#initialize} for arguments.\n @return [Hash] query result, ready to be serialized as JSON", "This is a compatibility hack so that instance-level and class-level\n methods can get correctness checks without calling one another\n @api private", "Get a unique identifier from this object\n @param object [Any] An application object\n @param type [GraphQL::BaseType] The current type definition\n @param ctx [GraphQL::Query::Context] the context for the current query\n @return [String] a unique identifier for `object` which clients can use to refetch it", "Return the GraphQL IDL for the schema\n @param context [Hash]\n @param only [<#call(member, ctx)>]\n @param except [<#call(member, ctx)>]\n @return [String]", "Get the underlying value for this enum value\n\n @example get episode value from Enum\n episode = EpisodeEnum.coerce(\"NEWHOPE\")\n episode # => 6\n\n @param value_name [String] the string representation of this enum value\n @return [Object] the underlying value for this enum value", "This is for testing input object behavior", "Customize the JSON serialization for Elasticsearch", "Text representation of the client, masking tokens and passwords\n\n @return [String]", "Hypermedia agent for the GitHub API\n\n @return [Sawyer::Agent]", "Executes the request, checking if it was successful\n\n @return [Boolean] True on success, false otherwise", "Adds the `aria-selected` attribute to a link when it's pointing to the\n current path. The API is the same than the `link_to` one, and uses this\n helper internally.\n\n text - a String with the link text\n link - Where the link should point to. Accepts the same value than\n `link_to` helper.\n options - An options Hash that will be passed to `link_to`.", "Renders all form attributes defined by the handler.\n\n Returns a String.", "Renders a single attribute from the form handlers.\n\n name - The String name of the attribute.\n options - An optional Hash, accepted options are:\n :as - A String name with the type the field to render\n :input - An optional Hash to pass to the field method.\n\n Returns a String.", "All the resource types that are eligible to be included as an activity.", "Creates a ew authorization form in a view, accepts the same arguments as\n `form_for`.\n\n record - The record to use in the form, it shoulde be a descendant of\n AuthorizationHandler.\n options - An optional hash with options to pass wo the form builder.\n block - A block with the content of the form.\n\n Returns a String.", "Stores the url where the user will be redirected after login.\n\n Uses the `redirect_url` param or the current url if there's no param.\n In Devise controllers we only store the URL if it's from the params, we don't\n want to overwrite the stored URL for a Devise one.", "Checks if the resource should show its scope or not.\n resource - the resource to analize\n\n Returns boolean.", "Renders a scopes picker field in a form, not linked to a specific model.\n name - name for the input\n value - value for the input\n\n Returns nothing.", "Renders the emendations of an amendable resource\n\n Returns Html grid of CardM.", "Checks if the user can accept and reject the emendation", "Checks if the user can promote the emendation", "Checks if the unique ActionLog created in the promote command exists.", "Renders a UserGroup select field in a form.", "Return the edited field value or presents the original attribute value in a form.", "Renders a link to openstreetmaps with the resource latitude and longitude.\n The link's content is a static map image.\n\n resource - A geolocalizable resource\n options - An optional hash of options (default: { zoom: 17 })\n * zoom: A number to represent the zoom value of the map", "Renders the attachment's title.\n Checks if the attachment's title is translated or not and use\n the correct render method.\n\n attachment - An Attachment object\n\n Returns String.", "Overrides the submit tags to always be buttons instead of inputs.\n Buttons are much more stylable and less prone to bugs.\n\n value - The text of the button\n options - Options to provide to the actual tag.\n\n Returns a SafeString with the tag.", "Calls the `create` method to the given class and sets the author of the version.\n\n klass - An ActiveRecord class that implements `Decidim::Traceable`\n author - An object that implements `to_gid` or a String\n params - a Hash with the attributes of the new resource\n extra_log_info - a Hash with extra info that will be saved to the log\n\n Returns an instance of `klass`.", "Calls the `create!` method to the given class and sets the author of the version.\n\n klass - An ActiveRecord class that implements `Decidim::Traceable`\n author - An object that implements `to_gid` or a String\n params - a Hash with the attributes of the new resource\n extra_log_info - a Hash with extra info that will be saved to the log\n\n Returns an instance of `klass`.", "Performs the given block and sets the author of the action.\n It also logs the action with the given `action` parameter.\n The action and the logging are run inside a transaction.\n\n action - a String or Symbol representing the action performed\n resource - An ActiveRecord instance that implements `Decidim::Traceable`\n author - An object that implements `to_gid` or a String\n extra_log_info - a Hash with extra info that will be saved to the log\n\n Returns whatever the given block returns.", "Updates the `resource` with `update!` and sets the author of the version.\n\n resource - An ActiveRecord instance that implements `Decidim::Traceable`\n author - An object that implements `to_gid` or a String\n params - a Hash with the attributes to update to the resource\n extra_log_info - a Hash with extra info that will be saved to the log\n\n Returns the updated `resource`.", "Truncates a given text respecting its HTML tags.\n\n text - The String text to be truncated.\n options - A Hash with the options to truncate the text (default: {}):\n :length - An Integer number with the max length of the text.\n :separator - A String to append to the text when it's being\n truncated. See `truncato` gem for more options.\n\n Returns a String.", "Generates a link to be added to the global Edit link so admins\n can easily manage data without having to look for it at the admin\n panel when they're at a public page.\n\n link - The String with the URL.\n action - The Symbol action to check the permissions for.\n subject - The Symbol subject to perform the action to.\n extra_context - An optional Hash to check the permissions.\n\n Returns nothing.", "A context used to set the layout and behavior of a participatory space. Full documentation can\n be found looking at the `ParticipatorySpaceContextManifest` class.\n\n Example:\n\n context(:public) do |context|\n context.layout \"layouts/decidim/some_layout\"\n end\n\n context(:public).layout\n # => \"layouts/decidim/some_layout\"\n\n Returns Nothing.", "Returns the creation date in a friendly relative format.", "Search for all Participatory Space manifests and then all records available\n Limited to ParticipatoryProcesses only", "Converts a given array of strings to an array of Objects representing\n locales.\n\n collection - an Array of Strings. By default it uses all the available\n locales in Decidim, but you can passa nother collection of locales (for\n example, the available locales for an organization)", "Initializes the Rack Middleware.\n\n app - The Rack application\n Main entry point for a Rack Middleware.\n\n env - A Hash.", "Destroy a user's account.\n\n user - The user to be updated.\n form - The form with the data.", "Initializes the ActionAuthorizer.\n\n user - The user to authorize against.\n action - The action to authenticate.\n component - The component to authenticate against.\n resource - The resource to authenticate against. Can be nil.\n\n\n Authorize user to perform an action in the context of a component.\n\n Returns:\n :ok an empty hash - When there is no authorization handler related to the action.\n result of authorization handler check - When there is an authorization handler related to the action. Check Decidim::Verifications::DefaultActionAuthorizer class docs.", "Updates a user's account.\n\n user - The user to be updated.\n form - The form with the data.", "Renders a collection of linked resources for a resource.\n\n resource - The resource to get the links from.\n type - The String type fo the resources we want to render.\n link_name - The String name of the link between the resources.\n\n Example to render the proposals in a meeting view:\n\n linked_resources_for(:meeting, :proposals, \"proposals_from_meeting\")\n\n Returns nothing.", "Returns a descriptive title for the resource", "Displays pagination links for the given collection, setting the correct\n theme. This mostly acts as a proxy for the underlying pagination engine.\n\n collection - a collection of elements that need to be paginated\n paginate_params - a Hash with options to delegate to the pagination helper.", "Lazy loads the `participatory_space` association through BatchLoader, can be used\n as a regular object.", "Handles the scope_id filter. When we want to show only those that do not\n have a scope_id set, we cannot pass an empty String or nil because Searchlight\n will automatically filter out these params, so the method will not be used.\n Instead, we need to pass a fake ID and then convert it inside. In this case,\n in order to select those elements that do not have a scope_id set we use\n `\"global\"` as parameter, and in the method we do the needed changes to search\n properly.", "this method is used to generate the root link on mail with the utm_codes\n If the newsletter_id is nil, it returns the root_url", "Outputs an SVG-based icon.\n\n name - The String with the icon name.\n options - The Hash options used to customize the icon (default {}):\n :width - The Number of width in pixels (optional).\n :height - The Number of height in pixels (optional).\n :aria_label - The String to set as aria label (optional).\n :aria_hidden - The Truthy value to enable aria_hidden (optional).\n :role - The String to set as the role (optional).\n :class - The String to add as a CSS class (optional).\n\n Returns a String.", "Outputs a SVG icon from an external file. It apparently renders an image\n tag, but then a JS script kicks in and replaces it with an inlined SVG\n version.\n\n path - The asset's path\n\n Returns an tag with the SVG icon.", "Initializes the class with a polymorphic subject\n\n subject - A in instance of a subclass of ActiveRecord::Base to be tracked\n\n Public: Tracks the past activity of a user to update the continuity badge's\n score. It will set it to the amount of consecutive days a user has logged into\n the system.\n\n date - The date of the last user's activity. Usually `Time.zone.today`.\n\n Returns nothing.", "Sends an email with the invitation instructions to a new user.\n\n user - The User that has been invited.\n token - The String to be sent as a token to verify the invitation.\n opts - A Hash with options to send the email (optional).", "Since we're rendering each activity separatedly we need to trigger\n BatchLoader in order to accumulate all the ids to be found later.", "Returns the defined root path for a given component.\n\n component - the Component we want to find the root path for.\n\n Returns a relative url.", "Returns the defined root url for a given component.\n\n component - the Component we want to find the root path for.\n\n Returns an absolute url.", "Returns the defined admin root path for a given component.\n\n component - the Component we want to find the root path for.\n\n Returns a relative url.", "Renders the human name of the given class name.\n\n klass_name - a String representing the class name of the resource to render\n count - (optional) the number of resources so that the I18n backend\n can decide to translate into singluar or plural form.", "Generates a link to filter the current search by the given type. If no\n type is given, it generates a link to the main results page.\n\n resource_type - An optional String with the name of the model class to filter\n space_state - An optional String with the name of the state of the space", "Generates the path and link to filter by space state, taking into account\n the other filters applied.", "A custom form for that injects client side validations with Abide.\n\n record - The object to build the form for.\n options - A Hash of options to pass to the form builder.\n &block - The block to execute as content of the form.\n\n Returns a String.", "A custom helper to include an editor field without requiring a form object\n\n name - The input name\n value - The input value\n options - The set of options to send to the field\n :label - The Boolean value to create or not the input label (optional) (default: true)\n :toolbar - The String value to configure WYSIWYG toolbar. It should be 'basic' or\n or 'full' (optional) (default: 'basic')\n :lines - The Integer to indicate how many lines should editor have (optional)\n\n Returns a rich editor to be included in an html template.", "A custom helper to include a scope picker field without requiring a form\n object\n\n name - The input name\n value - The input value as a scope id\n options - The set of options to send to the field\n :id - The id to generate for the element (optional)\n\n Returns a scopes picker tag to be included in an html template.", "A custom helper to include a translated field without requiring a form object.\n\n type - The type of the translated input field.\n object_name - The object name used to identify the Foundation tabs.\n name - The name of the input which will be suffixed with the corresponding locales.\n value - A hash containing the value for each locale.\n options - An optional hash of options.\n * enable_tabs: Adds the data-tabs attribute so Foundation picks up automatically.\n * tabs_id: The id to identify the Foundation tabs element.\n * label: The label used for the field.\n\n Returns a Foundation tabs element with the translated input field.", "Helper method to show how slugs will look like. Intended to be used in forms\n together with some JavaScript code. More precisely, this will most probably\n show in help texts in forms. The space slug is surrounded with a `span` so\n the slug can be updated via JavaScript with the input value.\n\n prepend_path - a path to prepend to the slug, without final slash\n value - the initial value of the slug field, so that edit forms have a value\n\n Returns an HTML-safe String.", "Renders the avatar and author name of the author of the last version of the given\n resource.\n\n resource - an object implementing `Decidim::Traceable`\n\n Returns an HTML-safe String representing the HTML to render the author.", "Renders the avatar and author name of the author of the given version.\n\n version - an object that responds to `whodunnit` and returns a String.\n\n Returns an HTML-safe String representing the HTML to render the author.", "Caches a DiffRenderer instance for the `current_version`.", "Renders the given value in a user-friendly way based on the value class.\n\n value - an object to be rendered\n\n Returns an HTML-ready String.", "The title to show at the card.\n\n The card will also be displayed OK if there's no title.", "The description to show at the card.\n\n The card will also be displayed OK if there's no description.", "Renders the Call To Action button. Link and text can be configured\n per organization.", "Finds the CTA button path to reuse it in other places.", "Returns a String with the absolute file_path to be read or generate.", "This method wraps everything in a div with class filters and calls\n the form_for helper with a custom builder\n\n filter - A filter object\n url - A String with the URL to post the from. Self URL by default.\n block - A block to be called with the form builder\n\n Returns the filter resource form wrapped in a div", "Checks if the file is an image based on the content type. We need this so\n we only create different versions of the file when it's an image.\n\n new_file - The uploaded file.\n\n Returns a Boolean.", "Copies the content type and file size to the model where this is mounted.\n\n Returns nothing.", "Wrap the radio buttons collection in a custom fieldset.\n It also renders the inputs inside its labels.", "Wrap the check_boxes collection in a custom fieldset.\n It also renders the inputs inside its labels.", "Catch common beginner mistake and give a helpful error message on stderr", "Loop through all methods for each class and makes special prewarm call to each method.", "The user must at least pass in an SQL statement", "Accounts for inherited class_properties", "Properties managed by Jets with merged with finality.", "only process policy_document once", "1. Convert API Gateway event event to Rack env\n 2. Process using full Rack middleware stack\n 3. Convert back to API gateway response structure payload", "Validate routes that deployable", "resources macro expands to all the routes", "Useful for creating API Gateway Resources", "Useful for RouterMatcher\n\n Precedence:\n 1. Routes with no captures get highest precedence: posts/new\n 2. Then consider the routes with captures: post/:id\n 3. Last consider the routes with wildcards: *catchall\n\n Within these 2 groups we consider the routes with the longest path first\n since posts/:id and posts/:id/edit can both match.", "Show pretty route table for user to help with debugging in non-production mode", "Always the pre-flight headers in this case", "Runs in the child process", "blocks until rack server is up", "Only need to override the add method as the other calls all lead to it.", "Use command's long description as main description", "Use for both jets.gemspec and rake rdoc task", "Written as method to easily not include webpacker for case when either\n webpacker not installed at all or disabled upon `jets deploy`.", "aws sts get-caller-identity", "Checks that all routes are validate and have corresponding lambda functions", "Checks for a few things before deciding to delete the parent stack\n\n * Parent stack status status is ROLLBACK_COMPLETE\n * Parent resources are in the DELETE_COMPLETE state", "Class heirachry in top to down order", "For anonymous classes method_added during task registration contains \"\"\n for the class name. We adjust it here.", "Returns the content of a section.\n\n @return [String] Generate section content", "Parse issue and generate single line formatted issue line.\n\n Example output:\n - Add coveralls integration [\\#223](https://github.com/github-changelog-generator/github-changelog-generator/pull/223) (@github-changelog-generator)\n\n @param [Hash] issue Fetched issue from GitHub\n @return [String] Markdown-formatted single issue", "Encapsulate characters to make Markdown look as expected.\n\n @param [String] string\n @return [String] encapsulated input string", "Async fetching of all tags dates", "Find correct closed dates, if issues was closed by commits", "Adds a key \"first_occurring_tag\" to each PR with a value of the oldest\n tag that a PR's merge commit occurs in in the git history. This should\n indicate the release of each PR by git's history regardless of dates and\n divergent branches.\n\n @param [Array] tags The tags sorted by time, newest to oldest.\n @param [Array] prs The PRs to discover the tags of.\n @return [Nil] No return; PRs are updated in-place.", "Associate merged PRs by the merge SHA contained in each tag. If the\n merge_commit_sha is not found in any tag's history, skip association.\n\n @param [Array] tags The tags sorted by time, newest to oldest.\n @param [Array] prs The PRs to associate.\n @return [Array] PRs without their merge_commit_sha in a tag.", "Set closed date from this issue\n\n @param [Hash] event\n @param [Hash] issue", "Returns the number of pages for a API call\n\n @return [Integer] number of pages for this API call in total", "Fill input array with tags\n\n @return [Array ] array of tags in repo", "Fetch event for all issues and add them to 'events'\n\n @param [Array] issues\n @return [Void]", "Fetch comments for PRs and add them to \"comments\"\n\n @param [Array] prs The array of PRs.\n @return [Void] No return; PRs are updated in-place.", "Fetch tag time from repo\n\n @param [Hash] tag GitHub data item about a Tag\n\n @return [Time] time of specified tag", "Fetch and cache comparison between two github refs\n\n @param [String] older The older sha/tag/branch.\n @param [String] newer The newer sha/tag/branch.\n @return [Hash] Github api response for comparison.", "Fetch commit for specified event\n\n @param [String] commit_id the SHA of a commit to fetch\n @return [Hash]", "Fetch all SHAs occurring in or before a given tag and add them to\n \"shas_in_tag\"\n\n @param [Array] tags The array of tags.\n @return [Nil] No return; tags are updated in-place.", "This is wrapper with rescue block\n\n @return [Object] returns exactly the same, what you put in the block, but wrap it with begin-rescue block", "fetch, filter tags, fetch dates and sort them in time order", "Returns date for given GitHub Tag hash\n\n Memoize the date by tag name.\n\n @param [Hash] tag_name\n\n @return [Time] time of specified tag", "Detect link, name and time for specified tag.\n\n @param [Hash] newer_tag newer tag. Can be nil, if it's Unreleased section.\n @return [Array] link, name and time of the tag", "Parse a single heading and return a Hash\n\n The following heading structures are currently valid:\n - ## [v1.0.2](https://github.com/zanui/chef-thumbor/tree/v1.0.1) (2015-03-24)\n - ## [v1.0.2](https://github.com/zanui/chef-thumbor/tree/v1.0.1)\n - ## v1.0.2 (2015-03-24)\n - ## v1.0.2\n\n @param [String] heading Heading from the ChangeLog File\n @return [Hash] Returns a structured Hash with version, url and date", "Parse the given ChangeLog data into a list of Hashes\n\n @param [String] data File data from the ChangeLog.md\n @return [Array] Parsed data, e.g. [{ 'version' => ..., 'url' => ..., 'date' => ..., 'content' => ...}, ...]", "Add all issues, that should be in that tag, according milestone\n\n @param [Array] all_issues\n @param [String] tag_name\n @return [Array] issues with milestone #tag_name", "General filtered function\n\n @param [Array] all_issues PRs or issues\n @return [Array] filtered issues", "Generates log entry with header and body\n\n @param [Array] pull_requests List or PR's in new section\n @param [Array] issues List of issues in new section\n @param [String] newer_tag_name Name of the newer tag. Could be nil for `Unreleased` section.\n @param [String] newer_tag_link Name of the newer tag. Could be \"HEAD\" for `Unreleased` section.\n @param [Time] newer_tag_time Time of the newer tag\n @param [Hash, nil] older_tag_name Older tag, used for the links. Could be nil for last tag.\n @return [String] Ready and parsed section content.", "Generates header text for an entry.\n\n @param [String] newer_tag_name The name of a newer tag\n @param [String] newer_tag_link Used for URL generation. Could be same as #newer_tag_name or some specific value, like HEAD\n @param [Time] newer_tag_time Time when the newer tag was created\n @param [String] older_tag_name The name of an older tag; used for URLs.\n @param [String] project_url URL for the current project.\n @return [String] Header text content.", "Sorts issues and PRs into entry sections by labels and lack of labels.\n\n @param [Array] pull_requests\n @param [Array] issues\n @return [Nil]", "Iterates through sections and sorts labeled issues into them based on\n the label mapping. Returns any unmapped or unlabeled issues.\n\n @param [Array] issues Issues or pull requests.\n @return [Array] Issues that were not mapped into any sections.", "Returns a the option name as a symbol and its string value sans newlines.\n\n @param line [String] unparsed line from config file\n @return [Array]", "Class, responsible for whole changelog generation cycle\n @return initialised instance of ChangelogGenerator\n The entry point of this script to generate changelog\n @raise (ChangelogGeneratorError) Is thrown when one of specified tags was not found in list of tags.", "Generate log only between 2 specified tags\n @param [String] older_tag all issues before this tag date will be excluded. May be nil, if it's first tag\n @param [String] newer_tag all issue after this tag will be excluded. May be nil for unreleased section", "Filters issues and pull requests based on, respectively, `actual_date`\n and `merged_at` timestamp fields. `actual_date` is the detected form of\n `closed_at` based on merge event SHA commit times.\n\n @return [Array] filtered issues and pull requests", "The full cycle of generation for whole project\n @return [String] All entries in the changelog", "Serialize the most relevant settings into a Hash\n\n @return [::Hash]\n\n @since 0.1.0\n @api private", "The root of the application\n\n By default it returns the current directory, for this reason, **all the\n commands must be executed from the top level directory of the project**.\n\n If for some reason, that constraint above cannot be satisfied, please\n configure the root directory, so that commands can be executed from\n everywhere.\n\n This is part of a DSL, for this reason when this method is called with\n an argument, it will set the corresponding instance variable. When\n called without, it will return the already set value, or the default.\n\n @overload root(value)\n Sets the given value\n @param value [String,Pathname,#to_pathname] The root directory of the app\n\n @overload root\n Gets the value\n @return [Pathname]\n @raise [Errno::ENOENT] if the path cannot be found\n\n @since 0.1.0\n\n @see http://www.ruby-doc.org/core/Dir.html#method-c-pwd\n\n @example Getting the value\n require 'hanami'\n\n module Bookshelf\n class Application < Hanami::Application\n end\n end\n\n Bookshelf::Application.configuration.root # => #\n\n @example Setting the value\n require 'hanami'\n\n module Bookshelf\n class Application < Hanami::Application\n configure do\n root '/path/to/another/root'\n end\n end\n end", "Application routes.\n\n Specify a set of routes for the application, by passing a block, or a\n relative path where to find the file that describes them.\n\n By default it's `nil`.\n\n This is part of a DSL, for this reason when this method is called with\n an argument, it will set the corresponding instance variable. When\n called without, it will return the already set value, or the default.\n\n @overload routes(blk)\n Specify a set of routes in the given block\n @param blk [Proc] the routes definitions\n\n @overload routes(path)\n Specify a relative path where to find the routes file\n @param path [String] the relative path\n\n @overload routes\n Gets the value\n @return [Hanami::Config::Routes] the set of routes\n\n @since 0.1.0\n\n @see http://rdoc.info/gems/hanami-router/Hanami/Router\n\n @example Getting the value\n require 'hanami'\n\n module Bookshelf\n class Application < Hanami::Application\n end\n end\n\n Bookshelf::Application.configuration.routes\n # => nil\n\n @example Setting the value, by passing a block\n require 'hanami'\n\n module Bookshelf\n class Application < Hanami::Application\n configure do\n routes do\n get '/', to: 'dashboard#index'\n resources :books\n end\n end\n end\n end\n\n Bookshelf::Application.configuration.routes\n # => #, @path=#>\n\n @example Setting the value, by passing a relative path\n require 'hanami'\n\n module Bookshelf\n class Application < Hanami::Application\n configure do\n routes 'config/routes'\n end\n end\n end\n\n Bookshelf::Application.configuration.routes\n # => #>", "The URI port for this application.\n This is used by the router helpers to generate absolute URLs.\n\n By default this value is `2300`.\n\n This is part of a DSL, for this reason when this method is called with\n an argument, it will set the corresponding instance variable. When\n called without, it will return the already set value, or the default.\n\n @overload port(value)\n Sets the given value\n @param value [#to_int] the URI port\n @raise [TypeError] if the given value cannot be coerced to Integer\n\n @overload scheme\n Gets the value\n @return [String]\n\n @since 0.1.0\n\n @see http://en.wikipedia.org/wiki/URI_scheme\n\n @example Getting the value\n require 'hanami'\n\n module Bookshelf\n class Application < Hanami::Application\n end\n end\n\n Bookshelf::Application.configuration.port # => 2300\n\n @example Setting the value\n require 'hanami'\n\n module Bookshelf\n class Application < Hanami::Application\n configure do\n port 8080\n end\n end\n end\n\n Bookshelf::Application.configuration.port # => 8080", "Loads a dotenv file and updates self\n\n @param path [String, Pathname] the path to the dotenv file\n\n @return void\n\n @since 0.9.0\n @api private", "Default values for writing the hanamirc file\n\n @since 0.5.1\n @api private\n\n @see Hanami::Hanamirc#options", "Read hanamirc file and parse it's values\n\n @since 0.8.0\n @api private\n\n @return [Hash] hanamirc parsed values", "Instantiate a middleware stack\n\n @param configuration [Hanami::ApplicationConfiguration] the application's configuration\n\n @return [Hanami::MiddlewareStack] the new stack\n\n @since 0.1.0\n @api private\n\n @see Hanami::ApplicationConfiguration\n Load the middleware stack\n\n @return [Hanami::MiddlewareStack] the loaded middleware stack\n\n @since 0.2.0\n @api private\n\n @see http://rdoc.info/gems/rack/Rack/Builder", "Append a middleware to the stack.\n\n @param middleware [Object] a Rack middleware\n @param args [Array] optional arguments to pass to the Rack middleware\n @param blk [Proc] an optional block to pass to the Rack middleware\n\n @return [Array] the middleware that was added\n\n @since 0.2.0\n\n @see Hanami::MiddlewareStack#prepend\n\n @example\n # apps/web/application.rb\n module Web\n class Application < Hanami::Application\n configure do\n # ...\n use MyRackMiddleware, foo: 'bar'\n end\n end\n end", "Prepend a middleware to the stack.\n\n @param middleware [Object] a Rack middleware\n @param args [Array] optional arguments to pass to the Rack middleware\n @param blk [Proc] an optional block to pass to the Rack middleware\n\n @return [Array] the middleware that was added\n\n @since 0.6.0\n\n @see Hanami::MiddlewareStack#use\n\n @example\n # apps/web/application.rb\n module Web\n class Application < Hanami::Application\n configure do\n # ...\n prepend MyRackMiddleware, foo: 'bar'\n end\n end\n end", "Initialize the factory\n\n @param routes [Hanami::Router] a routes set\n\n @return [Hanami::Routes] the factory\n\n @since 0.1.0\n @api private\n Return a relative path for the given route name\n\n @param name [Symbol] the route name\n @param args [Array,nil] an optional set of arguments that is passed down\n to the wrapped route set.\n\n @return [Hanami::Utils::Escape::SafeString] the corresponding relative URL\n\n @raise Hanami::Routing::InvalidRouteException\n\n @since 0.1.0\n\n @see http://rdoc.info/gems/hanami-router/Hanami/Router#path-instance_method\n\n @example Basic example\n require 'hanami'\n\n module Web\n class Application < Hanami::Application\n configure do\n routes do\n get '/login', to: 'sessions#new', as: :login\n end\n end\n end\n end\n\n Web.routes.path(:login)\n # => '/login'\n\n Web.routes.path(:login, return_to: '/dashboard')\n # => '/login?return_to=%2Fdashboard'\n\n @example Dynamic finders\n require 'hanami'\n\n module Web\n class Application < Hanami::Application\n configure do\n routes do\n get '/login', to: 'sessions#new', as: :login\n end\n end\n end\n end\n\n Web.routes.login_path\n # => '/login'\n\n Web.routes.login_path(return_to: '/dashboard')\n # => '/login?return_to=%2Fdashboard'", "Return an absolute path for the given route name\n\n @param name [Symbol] the route name\n @param args [Array,nil] an optional set of arguments that is passed down\n to the wrapped route set.\n\n @return [Hanami::Utils::Escape::SafeString] the corresponding absolute URL\n\n @raise Hanami::Routing::InvalidRouteException\n\n @since 0.1.0\n\n @see http://rdoc.info/gems/hanami-router/Hanami/Router#url-instance_method\n\n @example Basic example\n require 'hanami'\n\n module Web\n class Application < Hanami::Application\n configure do\n routes do\n scheme 'https'\n host 'bookshelf.org'\n\n get '/login', to: 'sessions#new', as: :login\n end\n end\n end\n end\n\n Web.routes.url(:login)\n # => 'https://bookshelf.org/login'\n\n Web.routes.url(:login, return_to: '/dashboard')\n # => 'https://bookshelf.org/login?return_to=%2Fdashboard'\n\n @example Dynamic finders\n require 'hanami'\n\n module Web\n class Application < Hanami::Application\n configure do\n routes do\n scheme 'https'\n host 'bookshelf.org'\n\n get '/login', to: 'sessions#new', as: :login\n end\n end\n end\n end\n\n Web.routes.login_url\n # => 'https://bookshelf.org/login'\n\n Web.routes.login_url(return_to: '/dashboard')\n # => 'https://bookshelf.org/login?return_to=%2Fdashboard'", "Returns true if the service exists, false otherwise.\n\n @param [String] service_name name of the service", "Start a windows service\n\n @param [String] service_name name of the service to start\n @param optional [Integer] timeout the minumum number of seconds to wait before timing out", "Stop a windows service\n\n @param [String] service_name name of the service to stop\n @param optional [Integer] timeout the minumum number of seconds to wait before timing out", "Resume a paused windows service\n\n @param [String] service_name name of the service to resume\n @param optional [Integer] :timeout the minumum number of seconds to wait before timing out", "Query the state of a service using QueryServiceStatusEx\n\n @param [string] service_name name of the service to query\n @return [string] the status of the service", "Query the configuration of a service using QueryServiceConfigW\n\n @param [String] service_name name of the service to query\n @return [QUERY_SERVICE_CONFIGW.struct] the configuration of the service", "Change the startup mode of a windows service\n\n @param [string] service_name the name of the service to modify\n @param [Int] startup_type a code corresponding to a start type for\n windows service, see the \"Service start type codes\" section in the\n Puppet::Util::Windows::Service file for the list of available codes", "enumerate over all services in all states and return them as a hash\n\n @return [Hash] a hash containing services:\n { 'service name' => {\n 'display_name' => 'display name',\n 'service_status_process' => SERVICE_STATUS_PROCESS struct\n }\n }", "generate all the subdirectories, modules, classes and files", "generate a top index", "generate the all classes index file and the combo index", "returns the initial_page url", "return the relative file name to store this class in,\n which is also its url", "Checks whether all feature predicate methods are available.\n @param obj [Object, Class] the object or class to check if feature predicates are available or not.\n @return [Boolean] Returns whether all of the required methods are available or not in the given object.", "Merges the current set of metadata with another metadata hash. This\n method also handles the validation of module names and versions, in an\n effort to be proactive about module publishing constraints.", "Validates the name and version_requirement for a dependency, then creates\n the Dependency and adds it.\n Returns the Dependency that was added.", "Do basic validation and parsing of the name parameter.", "Do basic parsing of the source parameter. If the source is hosted on\n GitHub, we can predict sensible defaults for both project_page and\n issues_url.", "Validates and parses the dependencies.", "Validates that the given module name is both namespaced and well-formed.", "Validates that the version string can be parsed as per SemVer.", "Validates that the given _value_ is a symbolic name that starts with a letter\n and then contains only letters, digits, or underscore. Will raise an ArgumentError\n if that's not the case.\n\n @param value [Object] The value to be tested", "Validates that the version range can be parsed by Semantic.", "force regular ACLs to be present", "Common helper for set_userflags and unset_userflags.\n\n @api private", "Iterate through the list of records for this service\n and yield each server and port pair. Records are only fetched\n via DNS query the first time and cached for the duration of their\n service's TTL thereafter.\n @param [String] domain the domain to search for\n @param [Symbol] service_name the key of the service we are querying\n @yields [String, Integer] server and port of selected record", "Given a list of records of the same priority, chooses a random one\n from among them, favoring those with higher weights.\n @param [[Resolv::DNS::Resource::IN::SRV]] records a list of records\n of the same priority\n @return [Resolv::DNS::Resource::IN:SRV] the chosen record", "Checks if the cached entry for the given service has expired.\n @param [String] service_name the name of the service to check\n @return [Boolean] true if the entry has expired, false otherwise.\n Always returns true if the record had no TTL.", "Removes all environment variables\n @param mode [Symbol] Which operating system mode to use e.g. :posix or :windows. Use nil to autodetect\n @api private", "Resolve a path for an executable to the absolute path. This tries to behave\n in the same manner as the unix `which` command and uses the `PATH`\n environment variable.\n\n @api public\n @param bin [String] the name of the executable to find.\n @return [String] the absolute path to the found executable.", "Convert a path to a file URI", "Get the path component of a URI", "Executes a block of code, wrapped with some special exception handling. Causes the ruby interpreter to\n exit if the block throws an exception.\n\n @api public\n @param [String] message a message to log if the block fails\n @param [Integer] code the exit code that the ruby interpreter should return if the block fails\n @yield", "Converts 4x supported values to a 3x values.\n\n @param args [Array] Array of values to convert\n @param scope [Puppet::Parser::Scope] The scope to use when converting\n @param undef_value [Object] The value that nil is converted to\n @return [Array] The converted values", "Removes an attribute from the object; useful in testing or in cleanup\n when an error has been encountered\n @todo Don't know what the attr is (name or Property/Parameter?). Guessing it is a String name...\n @todo Is it possible to delete a meta-parameter?\n @todo What does delete mean? Is it deleted from the type or is its value state 'is'/'should' deleted?\n @param attr [String] the attribute to delete from this object. WHAT IS THE TYPE?\n @raise [Puppet::DecError] when an attempt is made to delete an attribute that does not exists.", "Returns true if the instance is a managed instance.\n A 'yes' here means that the instance was created from the language, vs. being created\n in order resolve other questions, such as finding a package in a list.\n @note An object that is managed always stays managed, but an object that is not managed\n may become managed later in its lifecycle.\n @return [Boolean] true if the object is managed", "Retrieves the current value of all contained properties.\n Parameters and meta-parameters are not included in the result.\n @todo As opposed to all non contained properties? How is this different than any of the other\n methods that also \"gets\" properties/parameters/etc. ?\n @return [Puppet::Resource] array of all property values (mix of types)\n @raise [fail???] if there is a provider and it is not suitable for the host this is evaluated for.", "Builds the dependencies associated with this resource.\n\n @return [Array] list of relationships to other resources", "Mark parameters associated with this type as sensitive, based on the associated resource.\n\n Currently, only instances of `Puppet::Property` can be easily marked for sensitive data handling\n and information redaction is limited to redacting events generated while synchronizing\n properties. While support for redaction will be broadened in the future we can't automatically\n deduce how to redact arbitrary parameters, so if a parameter is marked for redaction the best\n we can do is warn that we can't handle treating that parameter as sensitive and move on.\n\n In some unusual cases a given parameter will be marked as sensitive but that sensitive context\n needs to be transferred to another parameter. In this case resource types may need to override\n this method in order to copy the sensitive context from one parameter to another (and in the\n process force the early generation of a parameter that might otherwise be lazily generated.)\n See `Puppet::Type.type(:file)#set_sensitive_parameters` for an example of this.\n\n @note This method visibility is protected since it should only be called by #initialize, but is\n marked as public as subclasses may need to override this method.\n\n @api public\n\n @param sensitive_parameters [Array] A list of parameters to mark as sensitive.\n\n @return [void]", "Finishes any outstanding processing.\n This method should be called as a final step in setup,\n to allow the parameters that have associated auto-require needs to be processed.\n\n @todo what is the expected sequence here - who is responsible for calling this? When?\n Is the returned type correct?\n @return [Array] the validated list/set of attributes", "Create an anonymous environment.\n\n @param module_path [String] A list of module directories separated by the\n PATH_SEPARATOR\n @param manifest [String] The path to the manifest\n @return A new environment with the `name` `:anonymous`\n\n @api private", "Returns a basic environment configuration object tied to the environment's\n implementation values. Will not interpolate.\n\n @!macro loader_get_conf", "Adds a cache entry to the cache", "Clears all environments that have expired, either by exceeding their time to live, or\n through an explicit eviction determined by the cache expiration service.", "Creates a suitable cache entry given the time to live for one environment", "Evicts the entry if it has expired\n Also clears caches in Settings that may prevent the entry from being updated", "Return checksums for object's +Pathname+, generate if it's needed.\n Result is a hash of path strings to checksum strings.", "Create a Route containing information for querying the given API,\n hosted at a server determined either by SRV service or by the\n fallback server on the fallback port.\n @param [String] api the path leading to the root of the API. Must\n contain a trailing slash for proper endpoint path\n construction\n @param [Symbol] server_setting the setting to check for special\n server configuration\n @param [Symbol] port_setting the setting to check for speical\n port configuration\n @param [Symbol] srv_service the name of the service when using SRV\n records\n Select a server and port to create a base URL for the API specified by this\n route. If the connection fails and SRV records are in use, the next suitable\n server will be tried. If SRV records are not in use or no successful connection\n could be made, fall back to the configured server and port for this API, taking\n into account failover settings.\n @parma [Puppet::Network::Resolver] dns_resolver the DNS resolver to use to check\n SRV records\n @yield [URI] supply a base URL to make a request with\n @raise [Puppet::Error] if connection to selected server and port fails, and SRV\n records are not in use", "Execute the application.\n @api public\n @return [void]", "Output basic information about the runtime environment for debugging\n purposes.\n\n @api public\n\n @param extra_info [Hash{String => #to_s}] a flat hash of extra information\n to log. Intended to be passed to super by subclasses.\n @return [void]", "Defines a repeated positional parameter with _type_ and _name_ that may occur 1 to \"infinite\" number of times.\n It may only appear last or just before a block parameter.\n\n @param type [String] The type specification for the parameter.\n @param name [Symbol] The name of the parameter. This is primarily used\n for error message output and does not have to match an implementation\n method parameter.\n @return [Void]\n\n @api public", "Defines one required block parameter that may appear last. If type and name is missing the\n default type is \"Callable\", and the name is \"block\". If only one\n parameter is given, then that is the name and the type is \"Callable\".\n\n @api public", "Defines a local type alias, the given string should be a Puppet Language type alias expression\n in string form without the leading 'type' keyword.\n Calls to local_type must be made before the first parameter definition or an error will\n be raised.\n\n @param assignment_string [String] a string on the form 'AliasType = ExistingType'\n @api public", "Merges the result of yielding the given _lookup_variants_ to a given block.\n\n @param lookup_variants [Array] The variants to pass as second argument to the given block\n @return [Object] the merged value.\n @yield [} ]\n @yieldparam variant [Object] each variant given in the _lookup_variants_ array.\n @yieldreturn [Object] the value to merge with other values\n @throws :no_such_key if the lookup was unsuccessful\n\n Merges the result of yielding the given _lookup_variants_ to a given block.\n\n @param lookup_variants [Array] The variants to pass as second argument to the given block\n @return [Object] the merged value.\n @yield [} ]\n @yieldparam variant [Object] each variant given in the _lookup_variants_ array.\n @yieldreturn [Object] the value to merge with other values\n @throws :no_such_key if the lookup was unsuccessful", "return an uncompressed body if the response has been\n compressed", "Define a new right to which access can be provided.", "Is a given combination of name and ip address allowed? If either input\n is non-nil, then both inputs must be provided. If neither input\n is provided, then the authstore is considered local and defaults to \"true\".", "Returns a Type instance by name.\n This will load the type if not already defined.\n @param [String, Symbol] name of the wanted Type\n @return [Puppet::Type, nil] the type or nil if the type was not defined and could not be loaded", "Lookup a loader by its unique name.\n\n @param [String] loader_name the name of the loader to lookup\n @return [Loader] the found loader\n @raise [Puppet::ParserError] if no loader is found", "Finds the appropriate loader for the given `module_name`, or for the environment in case `module_name`\n is `nil` or empty.\n\n @param module_name [String,nil] the name of the module\n @return [Loader::Loader] the found loader\n @raise [Puppet::ParseError] if no loader can be found\n @api private", "Load the main manifest for the given environment\n\n There are two sources that can be used for the initial parse:\n\n 1. The value of `Puppet[:code]`: Puppet can take a string from\n its settings and parse that as a manifest. This is used by various\n Puppet applications to read in a manifest and pass it to the\n environment as a side effect. This is attempted first.\n 2. The contents of the environment's +manifest+ attribute: Puppet will\n try to load the environment manifest. The manifest must be a file.\n\n @return [Model::Program] The manifest parsed into a model object", "Add 4.x definitions found in the given program to the given loader.", "Add given 4.x definition to the given loader.", "Set the entry 'key=value'. If no entry with the\n given key exists, one is appended to the end of the section", "Format the section as text in the way it should be\n written to file", "Read and parse the on-disk file associated with this object", "Create a new section and store it in the file contents\n\n @api private\n @param name [String] The name of the section to create\n @return [Puppet::Util::IniConfig::Section]", "May be called with 3 arguments for message, file, line, and exception, or\n 4 args including the position on the line.", "Handles the Retry-After header of a HTTPResponse\n\n This method checks the response for a Retry-After header and handles\n it by sleeping for the indicated number of seconds. The response is\n returned unmodified if no Retry-After header is present.\n\n @param response [Net::HTTPResponse] A response received from the\n HTTP client.\n\n @return [nil] Sleeps and returns nil if the response contained a\n Retry-After header that indicated the request should be retried.\n @return [Net::HTTPResponse] Returns the `response` unmodified if\n no Retry-After header was present or the Retry-After header could\n not be parsed as an integer or RFC 2822 date.", "Parse the value of a Retry-After header\n\n Parses a string containing an Integer or RFC 2822 datestamp and returns\n an integer number of seconds before a request can be retried.\n\n @param header_value [String] The value of the Retry-After header.\n\n @return [Integer] Number of seconds to wait before retrying the\n request. Will be equal to 0 for the case of date that has already\n passed.\n @return [nil] Returns `nil` when the `header_value` can't be\n parsed as an Integer or RFC 2822 date.", "Retrieve a set of values from a registry key given their names\n Value names listed but not found in the registry will not be added to the\n resultant Hashtable\n\n @param key [RegistryKey] An open handle to a Registry Key\n @param names [String[]] An array of names of registry values to return if they exist\n @return [Hashtable] A hashtable of all of the found values in the registry key", "Customize this so we can do a bit of validation.", "Convert a record into a line by joining the fields together appropriately.\n This is pulled into a separate method so it can be called by the hooks.", "Assign the topic partitions to the group members.\n\n @param members [Array] member ids\n @param topics [Array] topics\n @return [Hash] a hash mapping member\n ids to assignments.", "Clears buffered messages for the given topic and partition.\n\n @param topic [String] the name of the topic.\n @param partition [Integer] the partition id.\n\n @return [nil]", "Initializes a new Kafka client.\n\n @param seed_brokers [Array, String] the list of brokers used to initialize\n the client. Either an Array of connections, or a comma separated string of connections.\n A connection can either be a string of \"host:port\" or a full URI with a scheme.\n If there's a scheme it's ignored and only host/port are used.\n\n @param client_id [String] the identifier for this application.\n\n @param logger [Logger] the logger that should be used by the client.\n\n @param connect_timeout [Integer, nil] the timeout setting for connecting\n to brokers. See {BrokerPool#initialize}.\n\n @param socket_timeout [Integer, nil] the timeout setting for socket\n connections. See {BrokerPool#initialize}.\n\n @param ssl_ca_cert [String, Array, nil] a PEM encoded CA cert, or an Array of\n PEM encoded CA certs, to use with an SSL connection.\n\n @param ssl_ca_cert_file_path [String, nil] a path on the filesystem to a PEM encoded CA cert\n to use with an SSL connection.\n\n @param ssl_client_cert [String, nil] a PEM encoded client cert to use with an\n SSL connection. Must be used in combination with ssl_client_cert_key.\n\n @param ssl_client_cert_key [String, nil] a PEM encoded client cert key to use with an\n SSL connection. Must be used in combination with ssl_client_cert.\n\n @param ssl_client_cert_key_password [String, nil] the password required to read the\n ssl_client_cert_key. Must be used in combination with ssl_client_cert_key.\n\n @param sasl_gssapi_principal [String, nil] a KRB5 principal\n\n @param sasl_gssapi_keytab [String, nil] a KRB5 keytab filepath\n\n @param sasl_scram_username [String, nil] SCRAM username\n\n @param sasl_scram_password [String, nil] SCRAM password\n\n @param sasl_scram_mechanism [String, nil] Scram mechanism, either \"sha256\" or \"sha512\"\n\n @param sasl_over_ssl [Boolean] whether to enforce SSL with SASL\n\n @param sasl_oauth_token_provider [Object, nil] OAuthBearer Token Provider instance that\n implements method token. See {Sasl::OAuth#initialize}\n\n @return [Client]\n Delivers a single message to the Kafka cluster.\n\n **Note:** Only use this API for low-throughput scenarios. If you want to deliver\n many messages at a high rate, or if you want to configure the way messages are\n sent, use the {#producer} or {#async_producer} APIs instead.\n\n @param value [String, nil] the message value.\n @param key [String, nil] the message key.\n @param headers [Hash] the headers for the message.\n @param topic [String] the topic that the message should be written to.\n @param partition [Integer, nil] the partition that the message should be written\n to, or `nil` if either `partition_key` is passed or the partition should be\n chosen at random.\n @param partition_key [String] a value used to deterministically choose a\n partition to write to.\n @param retries [Integer] the number of times to retry the delivery before giving\n up.\n @return [nil]", "Initializes a new Kafka producer.\n\n @param ack_timeout [Integer] The number of seconds a broker can wait for\n replicas to acknowledge a write before responding with a timeout.\n\n @param required_acks [Integer, Symbol] The number of replicas that must acknowledge\n a write, or `:all` if all in-sync replicas must acknowledge.\n\n @param max_retries [Integer] the number of retries that should be attempted\n before giving up sending messages to the cluster. Does not include the\n original attempt.\n\n @param retry_backoff [Integer] the number of seconds to wait between retries.\n\n @param max_buffer_size [Integer] the number of messages allowed in the buffer\n before new writes will raise {BufferOverflow} exceptions.\n\n @param max_buffer_bytesize [Integer] the maximum size of the buffer in bytes.\n attempting to produce messages when the buffer reaches this size will\n result in {BufferOverflow} being raised.\n\n @param compression_codec [Symbol, nil] the name of the compression codec to\n use, or nil if no compression should be performed. Valid codecs: `:snappy`,\n `:gzip`, `:lz4`, `:zstd`\n\n @param compression_threshold [Integer] the number of messages that needs to\n be in a message set before it should be compressed. Note that message sets\n are per-partition rather than per-topic or per-producer.\n\n @return [Kafka::Producer] the Kafka producer.", "Creates a new AsyncProducer instance.\n\n All parameters allowed by {#producer} can be passed. In addition to this,\n a few extra parameters can be passed when creating an async producer.\n\n @param max_queue_size [Integer] the maximum number of messages allowed in\n the queue.\n @param delivery_threshold [Integer] if greater than zero, the number of\n buffered messages that will automatically trigger a delivery.\n @param delivery_interval [Integer] if greater than zero, the number of\n seconds between automatic message deliveries.\n\n @see AsyncProducer\n @return [AsyncProducer]", "Creates a new Kafka consumer.\n\n @param group_id [String] the id of the group that the consumer should join.\n @param session_timeout [Integer] the number of seconds after which, if a client\n hasn't contacted the Kafka cluster, it will be kicked out of the group.\n @param offset_commit_interval [Integer] the interval between offset commits,\n in seconds.\n @param offset_commit_threshold [Integer] the number of messages that can be\n processed before their offsets are committed. If zero, offset commits are\n not triggered by message processing.\n @param heartbeat_interval [Integer] the interval between heartbeats; must be less\n than the session window.\n @param offset_retention_time [Integer] the time period that committed\n offsets will be retained, in seconds. Defaults to the broker setting.\n @param fetcher_max_queue_size [Integer] max number of items in the fetch queue that\n are stored for further processing. Note, that each item in the queue represents a\n response from a single broker.\n @return [Consumer]", "Fetches a batch of messages from a single partition. Note that it's possible\n to get back empty batches.\n\n The starting point for the fetch can be configured with the `:offset` argument.\n If you pass a number, the fetch will start at that offset. However, there are\n two special Symbol values that can be passed instead:\n\n * `:earliest` \u2014 the first offset in the partition.\n * `:latest` \u2014 the next offset that will be written to, effectively making the\n call block until there is a new message in the partition.\n\n The Kafka protocol specifies the numeric values of these two options: -2 and -1,\n respectively. You can also pass in these numbers directly.\n\n ## Example\n\n When enumerating the messages in a partition, you typically fetch batches\n sequentially.\n\n offset = :earliest\n\n loop do\n messages = kafka.fetch_messages(\n topic: \"my-topic\",\n partition: 42,\n offset: offset,\n )\n\n messages.each do |message|\n puts message.offset, message.key, message.value\n\n # Set the next offset that should be read to be the subsequent\n # offset.\n offset = message.offset + 1\n end\n end\n\n See a working example in `examples/simple-consumer.rb`.\n\n @param topic [String] the topic that messages should be fetched from.\n\n @param partition [Integer] the partition that messages should be fetched from.\n\n @param offset [Integer, Symbol] the offset to start reading from. Default is\n the latest offset.\n\n @param max_wait_time [Integer] the maximum amount of time to wait before\n the server responds, in seconds.\n\n @param min_bytes [Integer] the minimum number of bytes to wait for. If set to\n zero, the broker will respond immediately, but the response may be empty.\n The default is 1 byte, which means that the broker will respond as soon as\n a message is written to the partition.\n\n @param max_bytes [Integer] the maximum number of bytes to include in the\n response message set. Default is 1 MB. You need to set this higher if you\n expect messages to be larger than this.\n\n @return [Array] the messages returned from the broker.", "Enumerate all messages in a topic.\n\n @param topic [String] the topic to consume messages from.\n\n @param start_from_beginning [Boolean] whether to start from the beginning\n of the topic or just subscribe to new messages being produced.\n\n @param max_wait_time [Integer] the maximum amount of time to wait before\n the server responds, in seconds.\n\n @param min_bytes [Integer] the minimum number of bytes to wait for. If set to\n zero, the broker will respond immediately, but the response may be empty.\n The default is 1 byte, which means that the broker will respond as soon as\n a message is written to the partition.\n\n @param max_bytes [Integer] the maximum number of bytes to include in the\n response message set. Default is 1 MB. You need to set this higher if you\n expect messages to be larger than this.\n\n @return [nil]", "Creates a topic in the cluster.\n\n @example Creating a topic with log compaction\n # Enable log compaction:\n config = { \"cleanup.policy\" => \"compact\" }\n\n # Create the topic:\n kafka.create_topic(\"dns-mappings\", config: config)\n\n @param name [String] the name of the topic.\n @param num_partitions [Integer] the number of partitions that should be created\n in the topic.\n @param replication_factor [Integer] the replication factor of the topic.\n @param timeout [Integer] a duration of time to wait for the topic to be\n completely created.\n @param config [Hash] topic configuration entries. See\n [the Kafka documentation](https://kafka.apache.org/documentation/#topicconfigs)\n for more information.\n @raise [Kafka::TopicAlreadyExists] if the topic already exists.\n @return [nil]", "Create partitions for a topic.\n\n @param name [String] the name of the topic.\n @param num_partitions [Integer] the number of desired partitions for\n the topic\n @param timeout [Integer] a duration of time to wait for the new\n partitions to be added.\n @return [nil]", "Retrieve the offset of the last message in each partition of the specified topics.\n\n @param topics [Array] topic names.\n @return [Hash>]\n @example\n last_offsets_for('topic-1', 'topic-2') # =>\n # {\n # 'topic-1' => { 0 => 100, 1 => 100 },\n # 'topic-2' => { 0 => 100, 1 => 100 }\n # }", "Initializes a Cluster with a set of seed brokers.\n\n The cluster will try to fetch cluster metadata from one of the brokers.\n\n @param seed_brokers [Array]\n @param broker_pool [Kafka::BrokerPool]\n @param logger [Logger]\n Adds a list of topics to the target list. Only the topics on this list will\n be queried for metadata.\n\n @param topics [Array]\n @return [nil]", "Finds the broker acting as the coordinator of the given transaction.\n\n @param transactional_id: [String]\n @return [Broker] the broker that's currently coordinator.", "Lists all topics in the cluster.", "Fetches the cluster metadata.\n\n This is used to update the partition leadership information, among other things.\n The methods will go through each node listed in `seed_brokers`, connecting to the\n first one that is available. This node will be queried for the cluster metadata.\n\n @raise [ConnectionError] if none of the nodes in `seed_brokers` are available.\n @return [Protocol::MetadataResponse] the cluster metadata.", "Initializes a new AsyncProducer.\n\n @param sync_producer [Kafka::Producer] the synchronous producer that should\n be used in the background.\n @param max_queue_size [Integer] the maximum number of messages allowed in\n the queue.\n @param delivery_threshold [Integer] if greater than zero, the number of\n buffered messages that will automatically trigger a delivery.\n @param delivery_interval [Integer] if greater than zero, the number of\n seconds between automatic message deliveries.\n\n Produces a message to the specified topic.\n\n @see Kafka::Producer#produce\n @param (see Kafka::Producer#produce)\n @raise [BufferOverflow] if the message queue is full.\n @return [nil]", "Writes bytes to the socket, possible with a timeout.\n\n @param bytes [String] the data that should be written to the socket.\n @raise [Errno::ETIMEDOUT] if the timeout is exceeded.\n @return [Integer] the number of bytes written.", "Subscribes the consumer to a topic.\n\n Typically you either want to start reading messages from the very\n beginning of the topic's partitions or you simply want to wait for new\n messages to be written. In the former case, set `start_from_beginning`\n to true (the default); in the latter, set it to false.\n\n @param topic_or_regex [String, Regexp] subscribe to single topic with a string\n or multiple topics matching a regex.\n @param default_offset [Symbol] whether to start from the beginning or the\n end of the topic's partitions. Deprecated.\n @param start_from_beginning [Boolean] whether to start from the beginning\n of the topic or just subscribe to new messages being produced. This\n only applies when first consuming a topic partition \u2013 once the consumer\n has checkpointed its progress, it will always resume from the last\n checkpoint.\n @param max_bytes_per_partition [Integer] the maximum amount of data fetched\n from a single partition at a time.\n @return [nil]", "Pause processing of a specific topic partition.\n\n When a specific message causes the processor code to fail, it can be a good\n idea to simply pause the partition until the error can be resolved, allowing\n the rest of the partitions to continue being processed.\n\n If the `timeout` argument is passed, the partition will automatically be\n resumed when the timeout expires. If `exponential_backoff` is enabled, each\n subsequent pause will cause the timeout to double until a message from the\n partition has been successfully processed.\n\n @param topic [String]\n @param partition [Integer]\n @param timeout [nil, Integer] the number of seconds to pause the partition for,\n or `nil` if the partition should not be automatically resumed.\n @param max_timeout [nil, Integer] the maximum number of seconds to pause for,\n or `nil` if no maximum should be enforced.\n @param exponential_backoff [Boolean] whether to enable exponential backoff.\n @return [nil]", "Resume processing of a topic partition.\n\n @see #pause\n @param topic [String]\n @param partition [Integer]\n @return [nil]", "Whether the topic partition is currently paused.\n\n @see #pause\n @param topic [String]\n @param partition [Integer]\n @return [Boolean] true if the partition is paused, false otherwise.", "Move the consumer's position in the partition back to the configured default\n offset, either the first or latest in the partition.\n\n @param topic [String] the name of the topic.\n @param partition [Integer] the partition number.\n @return [nil]", "Move the consumer's position in the partition to the specified offset.\n\n @param topic [String] the name of the topic.\n @param partition [Integer] the partition number.\n @param offset [Integer] the offset that the consumer position should be moved to.\n @return [nil]", "Return the next offset that should be fetched for the specified partition.\n\n @param topic [String] the name of the topic.\n @param partition [Integer] the partition number.\n @return [Integer] the next offset that should be fetched.", "Commit offsets of messages that have been marked as processed.\n\n If `recommit` is set to true, we will also commit the existing positions\n even if no messages have been processed on a partition. This is done\n in order to avoid the offset information expiring in cases where messages\n are very rare -- it's essentially a keep-alive.\n\n @param recommit [Boolean] whether to recommit offsets that have already been\n committed.\n @return [nil]", "Clear stored offset information for all partitions except those specified\n in `excluded`.\n\n offset_manager.clear_offsets_excluding(\"my-topic\" => [1, 2, 3])\n\n @return [nil]", "Sends a request over the connection.\n\n @param request [#encode, #response_class] the request that should be\n encoded and written.\n\n @return [Object] the response.", "Writes a request over the connection.\n\n @param request [#encode] the request that should be encoded and written.\n\n @return [nil]", "Reads a response from the connection.\n\n @param response_class [#decode] an object that can decode the response from\n a given Decoder.\n\n @return [nil]", "Sends all buffered messages to the Kafka brokers.\n\n Depending on the value of `required_acks` used when initializing the producer,\n this call may block until the specified number of replicas have acknowledged\n the writes. The `ack_timeout` setting places an upper bound on the amount of\n time the call will block before failing.\n\n @raise [DeliveryFailed] if not all messages could be successfully sent.\n @return [nil]", "Sends batch last offset to the consumer group coordinator, and also marks\n this offset as part of the current transaction. This offset will be considered\n committed only if the transaction is committed successfully.\n\n This method should be used when you need to batch consumed and produced messages\n together, typically in a consume-transform-produce pattern. Thus, the specified\n group_id should be the same as config parameter group_id of the used\n consumer.\n\n @return [nil]", "Syntactic sugar to enable easier transaction usage. Do the following steps\n\n - Start the transaction (with Producer#begin_transaction)\n - Yield the given block\n - Commit the transaction (with Producer#commit_transaction)\n\n If the block raises exception, the transaction is automatically aborted\n *before* bubble up the exception.\n\n If the block raises Kafka::Producer::AbortTransaction indicator exception,\n it aborts the transaction silently, without throwing up that exception.\n\n @return [nil]", "Open new window.\n Current window doesn't change as the result of this call.\n It should be switched to explicitly.\n\n @return [Capybara::Window] window that has been opened", "Registers the constants to be auto loaded.\n\n @param prefix [String] The require prefix. If the path is inside Faraday,\n then it will be prefixed with the root path of this loaded\n Faraday version.\n @param options [{ Symbol => String }] library names.\n\n @example\n\n Faraday.autoload_all 'faraday/foo',\n Bar: 'bar'\n\n # requires faraday/foo/bar to load Faraday::Bar.\n Faraday::Bar\n\n @return [void]", "Filters the module's contents with those that have been already\n autoloaded.\n\n @return [Array]", "parse a multipart MIME message, returning a hash of any multipart errors", "Executes a block which should try to require and reference dependent\n libraries", "Check if the adapter is parallel-capable.\n\n @yield if the adapter isn't parallel-capable, or if no adapter is set yet.\n\n @return [Object, nil] a parallel manager or nil if yielded\n @api private", "Parses the given URL with URI and stores the individual\n components in this connection. These components serve as defaults for\n requests made by this connection.\n\n @param url [String, URI]\n @param encoder [Object]\n\n @example\n\n conn = Faraday::Connection.new { ... }\n conn.url_prefix = \"https://sushi.com/api\"\n conn.scheme # => https\n conn.path_prefix # => \"/api\"\n\n conn.get(\"nigiri?page=2\") # accesses https://sushi.com/api/nigiri", "Takes a relative url for a request and combines it with the defaults\n set on the connection instance.\n\n @param url [String]\n @param extra_params [Hash]\n\n @example\n conn = Faraday::Connection.new { ... }\n conn.url_prefix = \"https://sushi.com/api?token=abc\"\n conn.scheme # => https\n conn.path_prefix # => \"/api\"\n\n conn.build_url(\"nigiri?page=2\")\n # => https://sushi.com/api/nigiri?token=abc&page=2\n\n conn.build_url(\"nigiri\", page: 2)\n # => https://sushi.com/api/nigiri?token=abc&page=2", "Creates and configures the request object.\n\n @param method [Symbol]\n\n @yield [Faraday::Request] if block given\n @return [Faraday::Request]", "Build an absolute URL based on url_prefix.\n\n @param url [String, URI]\n @param params [Faraday::Utils::ParamsHash] A Faraday::Utils::ParamsHash to\n replace the query values\n of the resulting url (default: nil).\n\n @return [URI]", "Receives a String or URI and returns just\n the path with the query string sorted.", "Recursive hash update", "Update path and params.\n\n @param path [URI, String]\n @param params [Hash, nil]\n @return [void]", "Marshal serialization support.\n\n @return [Hash] the hash ready to be serialized in Marshal.", "Marshal serialization support.\n Restores the instance variables according to the +serialised+.\n @param serialised [Hash] the serialised object.", "Returns the policy of a specified bucket.\n\n @option params [required, String] :bucket\n\n @return [Types::GetBucketPolicyOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:\n\n * {Types::GetBucketPolicyOutput#policy #policy} => IO\n\n\n @example Example: To get bucket policy\n\n # The following example returns bucket policy associated with a bucket.\n\n resp = client.get_bucket_policy({\n bucket: \"examplebucket\",\n })\n\n resp.to_h outputs the following:\n {\n policy: \"{\\\"Version\\\":\\\"2008-10-17\\\",\\\"Id\\\":\\\"LogPolicy\\\",\\\"Statement\\\":[{\\\"Sid\\\":\\\"Enables the log delivery group to publish logs to your bucket \\\",\\\"Effect\\\":\\\"Allow\\\",\\\"Principal\\\":{\\\"AWS\\\":\\\"111122223333\\\"},\\\"Action\\\":[\\\"s3:GetBucketAcl\\\",\\\"s3:GetObjectAcl\\\",\\\"s3:PutObject\\\"],\\\"Resource\\\":[\\\"arn:aws:s3:::policytest1/*\\\",\\\"arn:aws:s3:::policytest1\\\"]}]}\",\n }\n\n @example Request syntax with placeholder values\n\n resp = client.get_bucket_policy({\n bucket: \"BucketName\", # required\n })\n\n @example Response structure\n\n resp.policy #=> String\n\n @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketPolicy AWS API Documentation\n\n @overload get_bucket_policy(params = {})\n @param [Hash] params ({})", "Retrieves objects from Amazon S3.\n\n @option params [String, IO] :response_target\n Where to write response data, file path, or IO object.\n\n @option params [required, String] :bucket\n\n @option params [String] :if_match\n Return the object only if its entity tag (ETag) is the same as the one\n specified, otherwise return a 412 (precondition failed).\n\n @option params [Time,DateTime,Date,Integer,String] :if_modified_since\n Return the object only if it has been modified since the specified\n time, otherwise return a 304 (not modified).\n\n @option params [String] :if_none_match\n Return the object only if its entity tag (ETag) is different from the\n one specified, otherwise return a 304 (not modified).\n\n @option params [Time,DateTime,Date,Integer,String] :if_unmodified_since\n Return the object only if it has not been modified since the specified\n time, otherwise return a 412 (precondition failed).\n\n @option params [required, String] :key\n\n @option params [String] :range\n Downloads the specified range bytes of an object. For more information\n about the HTTP Range header, go to\n http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35.\n\n @option params [String] :response_cache_control\n Sets the Cache-Control header of the response.\n\n @option params [String] :response_content_disposition\n Sets the Content-Disposition header of the response\n\n @option params [String] :response_content_encoding\n Sets the Content-Encoding header of the response.\n\n @option params [String] :response_content_language\n Sets the Content-Language header of the response.\n\n @option params [String] :response_content_type\n Sets the Content-Type header of the response.\n\n @option params [Time,DateTime,Date,Integer,String] :response_expires\n Sets the Expires header of the response.\n\n @option params [String] :version_id\n VersionId used to reference a specific version of the object.\n\n @option params [String] :sse_customer_algorithm\n Specifies the algorithm to use to when encrypting the object (e.g.,\n AES256).\n\n @option params [String] :sse_customer_key\n Specifies the customer-provided encryption key for Amazon S3 to use in\n encrypting data. This value is used to store the object and then it is\n discarded; Amazon does not store the encryption key. The key must be\n appropriate for use with the algorithm specified in the\n x-amz-server-side\u200b-encryption\u200b-customer-algorithm header.\n\n @option params [String] :sse_customer_key_md5\n Specifies the 128-bit MD5 digest of the encryption key according to\n RFC 1321. Amazon S3 uses this header for a message integrity check to\n ensure the encryption key was transmitted without error.\n\n @option params [String] :request_payer\n Confirms that the requester knows that she or he will be charged for\n the request. Bucket owners need not specify this parameter in their\n requests. Documentation on downloading objects from requester pays\n buckets can be found at\n http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html\n\n @option params [Integer] :part_number\n Part number of the object being read. This is a positive integer\n between 1 and 10,000. Effectively performs a 'ranged' GET request\n for the part specified. Useful for downloading just a part of an\n object.\n\n @return [Types::GetObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:\n\n * {Types::GetObjectOutput#body #body} => IO\n * {Types::GetObjectOutput#delete_marker #delete_marker} => Boolean\n * {Types::GetObjectOutput#accept_ranges #accept_ranges} => String\n * {Types::GetObjectOutput#expiration #expiration} => String\n * {Types::GetObjectOutput#restore #restore} => String\n * {Types::GetObjectOutput#last_modified #last_modified} => Time\n * {Types::GetObjectOutput#content_length #content_length} => Integer\n * {Types::GetObjectOutput#etag #etag} => String\n * {Types::GetObjectOutput#missing_meta #missing_meta} => Integer\n * {Types::GetObjectOutput#version_id #version_id} => String\n * {Types::GetObjectOutput#cache_control #cache_control} => String\n * {Types::GetObjectOutput#content_disposition #content_disposition} => String\n * {Types::GetObjectOutput#content_encoding #content_encoding} => String\n * {Types::GetObjectOutput#content_language #content_language} => String\n * {Types::GetObjectOutput#content_range #content_range} => String\n * {Types::GetObjectOutput#content_type #content_type} => String\n * {Types::GetObjectOutput#expires #expires} => Time\n * {Types::GetObjectOutput#expires_string #expires_string} => String\n * {Types::GetObjectOutput#website_redirect_location #website_redirect_location} => String\n * {Types::GetObjectOutput#server_side_encryption #server_side_encryption} => String\n * {Types::GetObjectOutput#metadata #metadata} => Hash<String,String>\n * {Types::GetObjectOutput#sse_customer_algorithm #sse_customer_algorithm} => String\n * {Types::GetObjectOutput#sse_customer_key_md5 #sse_customer_key_md5} => String\n * {Types::GetObjectOutput#ssekms_key_id #ssekms_key_id} => String\n * {Types::GetObjectOutput#storage_class #storage_class} => String\n * {Types::GetObjectOutput#request_charged #request_charged} => String\n * {Types::GetObjectOutput#replication_status #replication_status} => String\n * {Types::GetObjectOutput#parts_count #parts_count} => Integer\n * {Types::GetObjectOutput#tag_count #tag_count} => Integer\n * {Types::GetObjectOutput#object_lock_mode #object_lock_mode} => String\n * {Types::GetObjectOutput#object_lock_retain_until_date #object_lock_retain_until_date} => Time\n * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String\n\n\n @example Example: To retrieve an object\n\n # The following example retrieves an object for an S3 bucket.\n\n resp = client.get_object({\n bucket: \"examplebucket\",\n key: \"HappyFace.jpg\",\n })\n\n resp.to_h outputs the following:\n {\n accept_ranges: \"bytes\",\n content_length: 3191,\n content_type: \"image/jpeg\",\n etag: \"\\\"6805f2cfc46c0f04559748bb039d69ae\\\"\",\n last_modified: Time.parse(\"Thu, 15 Dec 2016 01:19:41 GMT\"),\n metadata: {\n },\n tag_count: 2,\n version_id: \"null\",\n }\n\n @example Example: To retrieve a byte range of an object\n\n # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a\n # specific byte range.\n\n resp = client.get_object({\n bucket: \"examplebucket\",\n key: \"SampleFile.txt\",\n range: \"bytes=0-9\",\n })\n\n resp.to_h outputs the following:\n {\n accept_ranges: \"bytes\",\n content_length: 10,\n content_range: \"bytes 0-9/43\",\n content_type: \"text/plain\",\n etag: \"\\\"0d94420ffd0bc68cd3d152506b97a9cc\\\"\",\n last_modified: Time.parse(\"Thu, 09 Oct 2014 22:57:28 GMT\"),\n metadata: {\n },\n version_id: \"null\",\n }\n\n @example Download an object to disk\n # stream object directly to disk\n resp = s3.get_object(\n response_target: '/path/to/file',\n bucket: 'bucket-name',\n key: 'object-key')\n\n # you can still access other response data\n resp.metadata #=> { ... }\n resp.etag #=> \"...\"\n\n @example Download object into memory\n # omit :response_target to download to a StringIO in memory\n resp = s3.get_object(bucket: 'bucket-name', key: 'object-key')\n\n # call #read or #string on the response body\n resp.body.read\n #=> '...'\n\n @example Streaming data to a block\n # WARNING: yielding data to a block disables retries of networking errors\n File.open('/path/to/file', 'wb') do |file|\n s3.get_object(bucket: 'bucket-name', key: 'object-key') do |chunk|\n file.write(chunk)\n end\n end\n\n @example Request syntax with placeholder values\n\n resp = client.get_object({\n bucket: \"BucketName\", # required\n if_match: \"IfMatch\",\n if_modified_since: Time.now,\n if_none_match: \"IfNoneMatch\",\n if_unmodified_since: Time.now,\n key: \"ObjectKey\", # required\n range: \"Range\",\n response_cache_control: \"ResponseCacheControl\",\n response_content_disposition: \"ResponseContentDisposition\",\n response_content_encoding: \"ResponseContentEncoding\",\n response_content_language: \"ResponseContentLanguage\",\n response_content_type: \"ResponseContentType\",\n response_expires: Time.now,\n version_id: \"ObjectVersionId\",\n sse_customer_algorithm: \"SSECustomerAlgorithm\",\n sse_customer_key: \"SSECustomerKey\",\n sse_customer_key_md5: \"SSECustomerKeyMD5\",\n request_payer: \"requester\", # accepts requester\n part_number: 1,\n })\n\n @example Response structure\n\n resp.body #=> IO\n resp.delete_marker #=> Boolean\n resp.accept_ranges #=> String\n resp.expiration #=> String\n resp.restore #=> String\n resp.last_modified #=> Time\n resp.content_length #=> Integer\n resp.etag #=> String\n resp.missing_meta #=> Integer\n resp.version_id #=> String\n resp.cache_control #=> String\n resp.content_disposition #=> String\n resp.content_encoding #=> String\n resp.content_language #=> String\n resp.content_range #=> String\n resp.content_type #=> String\n resp.expires #=> Time\n resp.expires_string #=> String\n resp.website_redirect_location #=> String\n resp.server_side_encryption #=> String, one of \"AES256\", \"aws:kms\"\n resp.metadata #=> Hash\n resp.metadata[\"MetadataKey\"] #=> String\n resp.sse_customer_algorithm #=> String\n resp.sse_customer_key_md5 #=> String\n resp.ssekms_key_id #=> String\n resp.storage_class #=> String, one of \"STANDARD\", \"REDUCED_REDUNDANCY\", \"STANDARD_IA\", \"ONEZONE_IA\", \"INTELLIGENT_TIERING\", \"GLACIER\", \"DEEP_ARCHIVE\"\n resp.request_charged #=> String, one of \"requester\"\n resp.replication_status #=> String, one of \"COMPLETE\", \"PENDING\", \"FAILED\", \"REPLICA\"\n resp.parts_count #=> Integer\n resp.tag_count #=> Integer\n resp.object_lock_mode #=> String, one of \"GOVERNANCE\", \"COMPLIANCE\"\n resp.object_lock_retain_until_date #=> Time\n resp.object_lock_legal_hold_status #=> String, one of \"ON\", \"OFF\"\n\n @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObject AWS API Documentation\n\n @overload get_object(params = {})\n @param [Hash] params ({})", "Return torrent files from a bucket.\n\n @option params [String, IO] :response_target\n Where to write response data, file path, or IO object.\n\n @option params [required, String] :bucket\n\n @option params [required, String] :key\n\n @option params [String] :request_payer\n Confirms that the requester knows that she or he will be charged for\n the request. Bucket owners need not specify this parameter in their\n requests. Documentation on downloading objects from requester pays\n buckets can be found at\n http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html\n\n @return [Types::GetObjectTorrentOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:\n\n * {Types::GetObjectTorrentOutput#body #body} => IO\n * {Types::GetObjectTorrentOutput#request_charged #request_charged} => String\n\n\n @example Example: To retrieve torrent files for an object\n\n # The following example retrieves torrent files of an object.\n\n resp = client.get_object_torrent({\n bucket: \"examplebucket\",\n key: \"HappyFace.jpg\",\n })\n\n resp.to_h outputs the following:\n {\n }\n\n @example Request syntax with placeholder values\n\n resp = client.get_object_torrent({\n bucket: \"BucketName\", # required\n key: \"ObjectKey\", # required\n request_payer: \"requester\", # accepts requester\n })\n\n @example Response structure\n\n resp.body #=> IO\n resp.request_charged #=> String, one of \"requester\"\n\n @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectTorrent AWS API Documentation\n\n @overload get_object_torrent(params = {})\n @param [Hash] params ({})", "Polls an API operation until a resource enters a desired state.\n\n ## Basic Usage\n\n A waiter will call an API operation until:\n\n * It is successful\n * It enters a terminal state\n * It makes the maximum number of attempts\n\n In between attempts, the waiter will sleep.\n\n # polls in a loop, sleeping between attempts\n client.wait_until(waiter_name, params)\n\n ## Configuration\n\n You can configure the maximum number of polling attempts, and the\n delay (in seconds) between each polling attempt. You can pass\n configuration as the final arguments hash.\n\n # poll for ~25 seconds\n client.wait_until(waiter_name, params, {\n max_attempts: 5,\n delay: 5,\n })\n\n ## Callbacks\n\n You can be notified before each polling attempt and before each\n delay. If you throw `:success` or `:failure` from these callbacks,\n it will terminate the waiter.\n\n started_at = Time.now\n client.wait_until(waiter_name, params, {\n\n # disable max attempts\n max_attempts: nil,\n\n # poll for 1 hour, instead of a number of attempts\n before_wait: -> (attempts, response) do\n throw :failure if Time.now - started_at > 3600\n end\n })\n\n ## Handling Errors\n\n When a waiter is unsuccessful, it will raise an error.\n All of the failure errors extend from\n {Aws::Waiters::Errors::WaiterFailed}.\n\n begin\n client.wait_until(...)\n rescue Aws::Waiters::Errors::WaiterFailed\n # resource did not enter the desired state in time\n end\n\n ## Valid Waiters\n\n The following table lists the valid waiter names, the operations they call,\n and the default `:delay` and `:max_attempts` values.\n\n | waiter_name | params | :delay | :max_attempts |\n | ----------------- | -------------- | -------- | ------------- |\n | bucket_exists | {#head_bucket} | 5 | 20 |\n | bucket_not_exists | {#head_bucket} | 5 | 20 |\n | object_exists | {#head_object} | 5 | 20 |\n | object_not_exists | {#head_object} | 5 | 20 |\n\n @raise [Errors::FailureStateError] Raised when the waiter terminates\n because the waiter has entered a state that it will not transition\n out of, preventing success.\n\n @raise [Errors::TooManyAttemptsError] Raised when the configured\n maximum number of attempts have been made, and the waiter is not\n yet successful.\n\n @raise [Errors::UnexpectedError] Raised when an error is encounted\n while polling for a resource that is not expected.\n\n @raise [Errors::NoSuchWaiterError] Raised when you request to wait\n for an unknown state.\n\n @return [Boolean] Returns `true` if the waiter was successful.\n @param [Symbol] waiter_name\n @param [Hash] params ({})\n @param [Hash] options ({})\n @option options [Integer] :max_attempts\n @option options [Integer] :delay\n @option options [Proc] :before_attempt\n @option options [Proc] :before_wait", "Constructs a new SharedConfig provider object. This will load the shared\n credentials file, and optionally the shared configuration file, as ini\n files which support profiles.\n\n By default, the shared credential file (the default path for which is\n `~/.aws/credentials`) and the shared config file (the default path for\n which is `~/.aws/config`) are loaded. However, if you set the\n `ENV['AWS_SDK_CONFIG_OPT_OUT']` environment variable, only the shared\n credential file will be loaded. You can specify the shared credential\n file path with the `ENV['AWS_SHARED_CREDENTIALS_FILE']` environment\n variable or with the `:credentials_path` option. Similarly, you can\n specify the shared config file path with the `ENV['AWS_CONFIG_FILE']`\n environment variable or with the `:config_path` option.\n\n The default profile name is 'default'. You can specify the profile name\n with the `ENV['AWS_PROFILE']` environment variable or with the\n `:profile_name` option.\n\n @param [Hash] options\n @option options [String] :credentials_path Path to the shared credentials\n file. If not specified, will check `ENV['AWS_SHARED_CREDENTIALS_FILE']`\n before using the default value of \"#{Dir.home}/.aws/credentials\".\n @option options [String] :config_path Path to the shared config file.\n If not specified, will check `ENV['AWS_CONFIG_FILE']` before using the\n default value of \"#{Dir.home}/.aws/config\".\n @option options [String] :profile_name The credential/config profile name\n to use. If not specified, will check `ENV['AWS_PROFILE']` before using\n the fixed default value of 'default'.\n @option options [Boolean] :config_enabled If true, loads the shared config\n file and enables new config values outside of the old shared credential\n spec.\n @api private", "Attempts to assume a role from shared config or shared credentials file.\n Will always attempt first to assume a role from the shared credentials\n file, if present.", "Deeply converts the Structure into a hash. Structure members that\n are `nil` are omitted from the resultant hash.\n\n You can call #orig_to_h to get vanilla #to_h behavior as defined\n in stdlib Struct.\n\n @return [Hash]", "Allows you to access all of the requests that the stubbed client has made\n\n @params [Boolean] exclude_presign Setting to true for filtering out not sent requests from\n generating presigned urls. Default to false.\n @return [Array] Returns an array of the api requests made, each request object contains the\n :operation_name, :params, and :context of the request.\n @raise [NotImplementedError] Raises `NotImplementedError` when the client is not stubbed", "Generates and returns stubbed response data from the named operation.\n\n s3 = Aws::S3::Client.new\n s3.stub_data(:list_buckets)\n #=> #>\n\n In addition to generating default stubs, you can provide data to\n apply to the response stub.\n\n s3.stub_data(:list_buckets, buckets:[{name:'aws-sdk'}])\n #=> #],\n owner=#>\n\n @param [Symbol] operation_name\n @param [Hash] data\n @return [Structure] Returns a stubbed response data structure. The\n actual class returned will depend on the given `operation_name`.", "Yields the current and each following response to the given block.\n @yieldparam [Response] response\n @return [Enumerable,nil] Returns a new Enumerable if no block is given.", "This operation downloads the output of the job you initiated using\n InitiateJob. Depending on the job type you specified when you\n initiated the job, the output will be either the content of an archive\n or a vault inventory.\n\n You can download all the job output or download a portion of the\n output by specifying a byte range. In the case of an archive retrieval\n job, depending on the byte range you specify, Amazon Glacier returns\n the checksum for the portion of the data. You can compute the checksum\n on the client and verify that the values match to ensure the portion\n you downloaded is the correct data.\n\n A job ID will not expire for at least 24 hours after Amazon Glacier\n completes the job. That a byte range. For both archive and inventory\n retrieval jobs, you should verify the downloaded size against the size\n returned in the headers from the **Get Job Output** response.\n\n For archive retrieval jobs, you should also verify that the size is\n what you expected. If you download a portion of the output, the\n expected size is based on the range of bytes you specified. For\n example, if you specify a range of `bytes=0-1048575`, you should\n verify your download size is 1,048,576 bytes. If you download an\n entire archive, the expected size is the size of the archive when you\n uploaded it to Amazon Glacier The expected size is also returned in\n the headers from the **Get Job Output** response.\n\n In the case of an archive retrieval job, depending on the byte range\n you specify, Amazon Glacier returns the checksum for the portion of\n the data. To ensure the portion you downloaded is the correct data,\n compute the checksum on the client, verify that the values match, and\n verify that the size is what you expected.\n\n A job ID does not expire for at least 24 hours after Amazon Glacier\n completes the job. That is, you can download the job output within the\n 24 hours period after Amazon Glacier completes the job.\n\n An AWS account has full permission to perform all operations\n (actions). However, AWS Identity and Access Management (IAM) users\n don't have any permissions by default. You must grant them explicit\n permission to perform specific actions. For more information, see\n [Access Control Using AWS Identity and Access Management (IAM)][1].\n\n For conceptual information and the underlying REST API, see\n [Downloading a Vault Inventory][2], [Downloading an Archive][3], and\n [Get Job Output ][4]\n\n\n\n [1]: http://docs.aws.amazon.com/amazonglacier/latest/dev/using-iam-with-amazon-glacier.html\n [2]: http://docs.aws.amazon.com/amazonglacier/latest/dev/vault-inventory.html\n [3]: http://docs.aws.amazon.com/amazonglacier/latest/dev/downloading-an-archive.html\n [4]: http://docs.aws.amazon.com/amazonglacier/latest/dev/api-job-output-get.html\n\n @option params [required, String] :account_id\n The `AccountId` value is the AWS account ID of the account that owns\n the vault. You can either specify an AWS account ID or optionally a\n single '`-`' (hyphen), in which case Amazon Glacier uses the AWS\n account ID associated with the credentials used to sign the request.\n If you use an account ID, do not include any hyphens ('-') in the\n ID.\n\n @option params [required, String] :vault_name\n The name of the vault.\n\n @option params [required, String] :job_id\n The job ID whose data is downloaded.\n\n @option params [String] :range\n The range of bytes to retrieve from the output. For example, if you\n want to download the first 1,048,576 bytes, specify the range as\n `bytes=0-1048575`. By default, this operation downloads the entire\n output.\n\n If the job output is large, then you can use a range to retrieve a\n portion of the output. This allows you to download the entire output\n in smaller chunks of bytes. For example, suppose you have 1 GB of job\n output you want to download and you decide to download 128 MB chunks\n of data at a time, which is a total of eight Get Job Output requests.\n You use the following process to download the job output:\n\n 1. Download a 128 MB chunk of output by specifying the appropriate\n byte range. Verify that all 128 MB of data was received.\n\n 2. Along with the data, the response includes a SHA256 tree hash of\n the payload. You compute the checksum of the payload on the client\n and compare it with the checksum you received in the response to\n ensure you received all the expected data.\n\n 3. Repeat steps 1 and 2 for all the eight 128 MB chunks of output\n data, each time specifying the appropriate byte range.\n\n 4. After downloading all the parts of the job output, you have a list\n of eight checksum values. Compute the tree hash of these values to\n find the checksum of the entire output. Using the DescribeJob API,\n obtain job information of the job that provided you the output.\n The response includes the checksum of the entire archive stored in\n Amazon Glacier. You compare this value with the checksum you\n computed to ensure you have downloaded the entire archive content\n with no errors.\n\n @return [Types::GetJobOutputOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:\n\n * {Types::GetJobOutputOutput#body #body} => IO\n * {Types::GetJobOutputOutput#checksum #checksum} => String\n * {Types::GetJobOutputOutput#status #status} => Integer\n * {Types::GetJobOutputOutput#content_range #content_range} => String\n * {Types::GetJobOutputOutput#accept_ranges #accept_ranges} => String\n * {Types::GetJobOutputOutput#content_type #content_type} => String\n * {Types::GetJobOutputOutput#archive_description #archive_description} => String\n\n\n @example Example: To get the output of a previously initiated job\n\n # The example downloads the output of a previously initiated inventory retrieval job that is identified by the job ID.\n\n resp = client.get_job_output({\n account_id: \"-\",\n job_id: \"zbxcm3Z_3z5UkoroF7SuZKrxgGoDc3RloGduS7Eg-RO47Yc6FxsdGBgf_Q2DK5Ejh18CnTS5XW4_XqlNHS61dsO4CnMW\",\n range: \"\",\n vault_name: \"my-vaul\",\n })\n\n resp.to_h outputs the following:\n {\n accept_ranges: \"bytes\",\n body: \"inventory-data\",\n content_type: \"application/json\",\n status: 200,\n }\n\n @example Request syntax with placeholder values\n\n resp = client.get_job_output({\n account_id: \"string\", # required\n vault_name: \"string\", # required\n job_id: \"string\", # required\n range: \"string\",\n })\n\n @example Response structure\n\n resp.body #=> IO\n resp.checksum #=> String\n resp.status #=> Integer\n resp.content_range #=> String\n resp.accept_ranges #=> String\n resp.content_type #=> String\n resp.archive_description #=> String\n\n @overload get_job_output(params = {})\n @param [Hash] params ({})", "checking whether an unexpired endpoint key exists in cache\n @param [String] key\n @return [Boolean]", "extract the key to be used in the cache from request context\n @param [RequestContext] ctx\n @return [String]", "Create a ruby hash from a string passed by the jekyll tag", "Ensure that your plugin conforms to good hook naming conventions.\n\n Resque::Plugin.lint(MyResquePlugin)", "DEPRECATED. Processes a single job. If none is given, it will\n try to produce one. Usually run in the child.", "Reports the exception and marks the job as failed", "Processes a given job in the child.", "Attempts to grab a job off one of the provided queues. Returns\n nil if no job can be found.", "Reconnect to Redis to avoid sharing a connection with the parent,\n retry up to 3 times with increasing delay before giving up.", "Kill the child and shutdown immediately.\n If not forking, abort this process.", "Runs a named hook, passing along any arguments.", "Unregisters ourself as a worker. Useful when shutting down.", "Given a job, tells Redis we're working on it. Useful for seeing\n what workers are doing and when.", "Returns an Array of string pids of all the other workers on this\n machine. Useful when pruning dead workers on startup.", "Given an exception object, hands off the needed parameters to\n the Failure module.", "Create a new endpoint.\n @param new_settings [InheritableSetting] settings to determine the params,\n validations, and other properties from.\n @param options [Hash] attributes of this endpoint\n @option options path [String or Array] the path to this endpoint, within\n the current scope.\n @option options method [String or Array] which HTTP method(s) can be used\n to reach this endpoint.\n @option options route_options [Hash]\n @note This happens at the time of API definition, so in this context the\n endpoint does not know if it will be mounted under a different endpoint.\n @yield a block defining what your API should do when this endpoint is hit\n Update our settings from a given set of stackable parameters. Used when\n the endpoint's API is mounted under another one.", "Prior to version 4.1 of rails double quotes were inadventently removed in json_escape.\n This adds the correct json_escape functionality to rails versions < 4.1", "Register a resource into this namespace. The preffered method to access this is to\n use the global registration ActiveAdmin.register which delegates to the proper\n namespace instance.", "Add a callback to be ran when we build the menu\n\n @param [Symbol] name The name of the menu. Default: :default\n @yield [ActiveAdmin::Menu] The block to be ran when the menu is built\n\n @return [void]", "The default logout menu item\n\n @param [ActiveAdmin::MenuItem] menu The menu to add the logout link to\n @param [Fixnum] priority The numeric priority for the order in which it appears\n @param [Hash] html_options An options hash to pass along to link_to", "The default user session menu item\n\n @param [ActiveAdmin::MenuItem] menu The menu to add the logout link to\n @param [Fixnum] priority The numeric priority for the order in which it appears\n @param [Hash] html_options An options hash to pass along to link_to", "Page content.\n\n The block should define the view using Arbre.\n\n Example:\n\n ActiveAdmin.register \"My Page\" do\n content do\n para \"Sweet!\"\n end\n end", "Finds a resource based on the resource name, resource class, or base class.", "Registers a brand new configuration for the given resource.", "Creates a namespace for the given name\n\n Yields the namespace if a block is given\n\n @return [Namespace] the new or existing namespace", "Register a page\n\n @param name [String] The page name\n @option [Hash] Accepts option :namespace.\n @&block The registration block.", "Loads all ruby files that are within the load_paths setting.\n To reload everything simply call `ActiveAdmin.unload!`", "Creates all the necessary routes for the ActiveAdmin configurations\n\n Use this within the routes.rb file:\n\n Application.routes.draw do |map|\n ActiveAdmin.routes(self)\n end\n\n @param rails_router [ActionDispatch::Routing::Mapper]", "Hook into the Rails code reloading mechanism so that things are reloaded\n properly in development mode.\n\n If any of the app files (e.g. models) has changed, we need to reload all\n the admin files. If the admin files themselves has changed, we need to\n regenerate the routes as well.", "remove options that should not render as attributes", "Renders the Formtastic inputs then appends ActiveAdmin delete and sort actions.", "Capture the ADD JS", "Defines the routes for each resource", "Defines member and collection actions", "Simple callback system. Implements before and after callbacks for\n use within the controllers.\n\n We didn't use the ActiveSupport callbacks because they do not support\n passing in any arbitrary object into the callback method (which we\n need to do)", "Keys included in the `permitted_params` setting are automatically whitelisted.\n\n Either\n\n permit_params :title, :author, :body, tags: []\n\n Or\n\n permit_params do\n defaults = [:title, :body]\n if current_user.admin?\n defaults + [:author]\n else\n defaults\n end\n end", "Configure the index page for the resource", "Configure the show page for the resource", "Configure the CSV format\n\n For example:\n\n csv do\n column :name\n column(\"Author\") { |post| post.author.full_name }\n end\n\n csv col_sep: \";\", force_quotes: true do\n column :name\n end", "Member Actions give you the functionality of defining both the\n action and the route directly from your ActiveAdmin registration\n block.\n\n For example:\n\n ActiveAdmin.register Post do\n member_action :comments do\n @post = Post.find(params[:id])\n @comments = @post.comments\n end\n end\n\n Will create a new controller action comments and will hook it up to\n the named route (comments_admin_post_path) /admin/posts/:id/comments\n\n You can treat everything within the block as a standard Rails controller\n action.", "compute the price range", "Loads a configuration, ensuring it extends the default configuration.", "Filter out directories. This could happen when changing a symlink to a\n directory as part of an amendment, since the symlink will still appear as\n a file, but the actual working tree will have a directory.", "Check the yard coverage\n\n Return a :pass if the coverage is enough, :warn if it couldn't be read,\n otherwise, it has been read successfully.", "Create the error messages", "Get a list of files that were added, copied, or modified in the merge\n commit. Renames and deletions are ignored, since there should be nothing\n to check.", "Get a list of files that have been added or modified as part of a\n rewritten commit. Renames and deletions are ignored, since there should be\n nothing to check.", "Returns status and output for messages assuming no special treatment of\n messages occurring on unmodified lines.", "Runs the hook and transforms the status returned based on the hook's\n configuration.\n\n Poorly named because we already have a bunch of hooks in the wild that\n implement `#run`, and we needed a wrapper step to transform the status\n based on any custom configuration.", "If the hook defines required library paths that it wants to load, attempt\n to load them.", "Stash unstaged contents of files so hooks don't see changes that aren't\n about to be committed.", "Restore unstaged changes and reset file modification times so it appears\n as if nothing ever changed.\n\n We want to restore the modification times for each of the files after\n every step to ensure as little time as possible has passed while the\n modification time on the file was newer. This helps us play more nicely\n with file watchers.", "Get a list of added, copied, or modified files that have been staged.\n Renames and deletions are ignored, since there should be nothing to check.", "Clears the working tree so that the stash can be applied.", "Applies the stash to the working tree to restore the user's state.", "Stores the modification times for all modified files to make it appear like\n they never changed.\n\n This prevents (some) editors from complaining about files changing when we\n stash changes before running the hooks.", "Restores the file modification times for all modified files to make it\n appear like they never changed.", "Validates hash for any invalid options, normalizing where possible.\n\n @param config [Overcommit::Configuration]\n @param hash [Hash] hash representation of YAML config\n @param options[Hash]\n @option default [Boolean] whether hash represents the default built-in config\n @option logger [Overcommit::Logger] logger to output warnings to\n @return [Hash] validated hash (potentially modified)", "Normalizes `nil` values to empty hashes.\n\n This is useful for when we want to merge two configuration hashes\n together, since it's easier to merge two hashes than to have to check if\n one of the values is nil.", "Prints an error message and raises an exception if a hook has an\n invalid name, since this can result in strange errors elsewhere.", "Prints a warning if there are any hooks listed in the configuration\n without `enabled` explicitly set.", "Prints a warning if any hook has a number of processors larger than the\n global `concurrency` setting.", "Returns configuration for all built-in hooks in each hook type.\n\n @return [Hash]", "Returns configuration for all plugin hooks in each hook type.\n\n @return [Hash]", "Returns the built-in hooks that have been enabled for a hook type.", "Returns the ad hoc hooks that have been enabled for a hook type.", "Returns a non-modifiable configuration for a hook.", "Applies additional configuration settings based on the provided\n environment variables.", "Returns the stored signature of this repo's Overcommit configuration.\n\n This is intended to be compared against the current signature of this\n configuration object.\n\n @return [String]", "Returns the names of all files that are tracked by git.\n\n @return [Array] list of absolute file paths", "Restore any relevant files that were present when repo was in the middle\n of a merge.", "Restore any relevant files that were present when repo was in the middle\n of a cherry-pick.", "Update the current stored signature for this hook.", "Calculates a hash of a hook using a combination of its configuration and\n file contents.\n\n This way, if either the plugin code changes or its configuration changes,\n the hash will change and we can alert the user to this change.", "Executed at the end of an individual hook run.", "Process one logical line of makefile data.", "Invoke the task if it is needed. Prerequisites are invoked first.", "Transform the list of comments as specified by the block and\n join with the separator.", "Merge the given options with the default values.", "Check that the options do not contain options not listed in\n +optdecl+. An ArgumentError exception is thrown if non-declared\n options are found.", "Trim +n+ innermost scope levels from the scope. In no case will\n this trim beyond the toplevel scope.", "Initialize the command line parameters and app name.", "True if one of the files in RAKEFILES is in the current directory.\n If a match is found, it is copied into @rakefile.", "Return a new FileList with the results of running +sub+ against each\n element of the original list.\n\n Example:\n FileList['a.c', 'b.c'].sub(/\\.c$/, '.o') => ['a.o', 'b.o']", "Return a new FileList with the results of running +gsub+ against each\n element of the original list.\n\n Example:\n FileList['lib/test/file', 'x/y'].gsub(/\\//, \"\\\\\")\n => ['lib\\\\test\\\\file', 'x\\\\y']", "Same as +sub+ except that the original file list is modified.", "Same as +gsub+ except that the original file list is modified.", "Create the tasks defined by this task library.", "Waits until the queue of futures is empty and all threads have exited.", "processes one item on the queue. Returns true if there was an\n item to process, false if there was no item", "Resolve task arguments for a task or rule when there are no\n dependencies declared.\n\n The patterns recognized by this argument resolving function are:\n\n task :t\n task :t, [:a]", "If a rule can be found that matches the task name, enhance the\n task with the prerequisites and actions from the rule. Set the\n source attribute of the task appropriately for the rule. Return\n the enhanced task or nil of no rule was found.", "Find the location that called into the dsl layer.", "Attempt to create a rule given the list of prerequisites.", "Are there any prerequisites with a later time than the given time stamp?", "Create a new argument scope using the prerequisite argument\n names.", "If no one else is working this promise, go ahead and do the chore.", "Loops until the block returns a true value", "Purge cached DNS records", "vm always returns a vm", "Processes VM data from BOSH Director,\n extracts relevant agent data, wraps it into Agent object\n and adds it to a list of managed agents.", "subscribe to an inbox, if not already subscribed", "This call only makes sense if all dependencies have already been compiled,\n otherwise it raises an exception\n @return [Hash] Hash representation of all package dependencies. Agent uses\n that to download package dependencies before compiling the package on a\n compilation VM.", "Returns formatted exception information\n @param [Hash|#to_s] exception Serialized exception\n @return [String]", "the blob is removed from the blobstore once we have fetched it,\n but if there is a crash before it is injected into the response\n and then logged, there is a chance that we lose it", "Downloads a remote file\n @param [String] resource Resource name to be logged\n @param [String] remote_file Remote file to download\n @param [String] local_file Local file to store the downloaded file\n @raise [Bosh::Director::ResourceNotFound] If remote file is not found\n @raise [Bosh::Director::ResourceError] If there's a network problem", "Updates instance settings\n @param [String] instance_id instance id (instance record\n will be created in DB if it doesn't already exist)\n @param [String] settings New settings for the instance", "Reads instance settings\n @param [String] instance_id instance id\n @param [optional, String] remote_ip If this IP is provided,\n check will be performed to see if it instance id\n actually has this IP address according to the IaaS.", "Used by provider, not using alias because want to update existing provider intent when alias changes", "A consumer which is within the same deployment", "Do not add retries_left default value", "Creates new lock with the given name.\n\n @param name lock name\n @option opts [Number] timeout how long to wait before giving up\n @option opts [Number] expiration how long to wait before expiring an old\n lock\n Acquire a lock.\n\n @yield [void] optional block to do work before automatically releasing\n the lock.\n @return [void]", "Release a lock that was not auto released by the lock method.\n\n @return [void]", "returns a list of orphaned networks", "Instantiates and performs director job.\n @param [Array] args Opaque list of job arguments that will be used to\n instantiate the new job object.\n @return [void]", "Spawns a thread that periodically updates task checkpoint time.\n There is no need to kill this thread as job execution lifetime is the\n same as worker process lifetime.\n @return [Thread] Checkpoint thread", "Truncates string to fit task result length\n @param [String] string The original string\n @param [Integer] len Desired string length\n @return [String] Truncated string", "Marks task completion\n @param [Symbol] state Task completion state\n @param [#to_s] result", "Logs the exception in the event log\n @param [Exception] exception", "The rquirements hash passed in by the caller will be populated with CompiledPackageRequirement objects", "Binds template models for each release spec in the deployment plan\n @return [void]", "Ensures the given value is properly double quoted.\n This also ensures we don't have conflicts with reversed keywords.\n\n IE: `user` is a reserved keyword in PG. But `\"user\"` is allowed and works the same\n when used as an column/tbl alias.", "Ensures the key is properly single quoted and treated as a actual PG key reference.", "Converts a potential subquery into a compatible Arel SQL node.\n\n Note:\n We convert relations to SQL to maintain compatibility with Rails 5.[0/1].\n Only Rails 5.2+ maintains bound attributes in Arel, so its better to be safe then sorry.\n When we drop support for Rails 5.[0/1], we then can then drop the '.to_sql' conversation", "Finds Records that contains a nested set elements\n\n Array Column Type:\n User.where.contains(tags: [1, 3])\n # SELECT user.* FROM user WHERE user.tags @> {1,3}\n\n HStore Column Type:\n User.where.contains(data: { nickname: 'chainer' })\n # SELECT user.* FROM user WHERE user.data @> 'nickname' => 'chainer'\n\n JSONB Column Type:\n User.where.contains(data: { nickname: 'chainer' })\n # SELECT user.* FROM user WHERE user.data @> {'nickname': 'chainer'}\n\n This can also be used along side joined tables\n\n JSONB Column Type Example:\n Tag.joins(:user).where.contains(user: { data: { nickname: 'chainer' } })\n # SELECT tags.* FROM tags INNER JOIN user on user.id = tags.user_id WHERE user.data @> { nickname: 'chainer' }", "Absolute URL to the API representation of this resource", "Returns a hash suitable for use as an API response.\n\n For Documents and Pages:\n\n 1. Adds the file's raw content to the `raw_content` field\n 2. Adds the file's raw YAML front matter to the `front_matter` field\n\n For Static Files it addes the Base64 `encoded_content` field\n\n Options:\n\n include_content - if true, includes the content in the respond, false by default\n to support mapping on indexes where we only want metadata\n\n\n Returns a hash (which can then be to_json'd)", "Returns a hash of content fields for inclusion in the API output", "Returns the path to the requested file's containing directory", "Write a file to disk with the given content", "Delete the file at the given path", "verbose 'null' values in front matter", "Return whether this rule set occupies a single line.\n\n Note that this allows:\n a,\n b,\n i { margin: 0; padding: 0; }\n\n and:\n\n p { margin: 0; padding: 0; }\n\n In other words, the line of the opening curly brace is the line that the\n rule set is considered to occupy.", "Compare each property against the next property to see if they are on\n the same line.\n\n @param properties [Array]", "Executed before a node has been visited.\n\n @param node [Sass::Tree::Node]", "Gets the child of the node that resides on the lowest line in the file.\n\n This is necessary due to the fact that our monkey patching of the parse\n tree's {#children} method does not return nodes sorted by their line\n number.\n\n Returns `nil` if node has no children or no children with associated line\n numbers.\n\n @param node [Sass::Tree::Node, Sass::Script::Tree::Node]\n @return [Sass::Tree::Node, Sass::Script::Tree::Node]", "Checks if a simple sequence contains a\n simple selector of a certain class.\n\n @param seq [Sass::Selector::SimpleSequence]\n @param selector_class [Sass::Selector::Simple]\n @returns [Boolean]", "Find the maximum depth of all sequences in a comma sequence.", "Allow rulesets to be indented any amount when the indent is zero, as long\n as it's a multiple of the indent width", "Returns whether node is indented exactly one indent width greater than its\n parent.\n\n @param node [Sass::Tree::Node]\n @return [true,false]", "An expression enclosed in parens will include or not include each paren, depending\n on whitespace. Here we feel out for enclosing parens, and return them as the new\n source for the node.", "In cases where the previous node is not a block declaration, we won't\n have run any checks against it, so we need to check here if the previous\n line is an empty line", "Offset of value for property", "Friendly description that shows the full command that will be executed.", "Create a CLI that outputs to the specified logger.\n\n @param logger [SCSSLint::Logger]", "Return the path of the configuration file that should be loaded.\n\n @param options [Hash]\n @return [String]", "The Sass parser sometimes doesn't assign line numbers in cases where it\n should. This is a helper to easily correct that.", "Create a linter.\n Run this linter against a parsed document with the given configuration,\n returning the lints that were found.\n\n @param engine [Engine]\n @param config [Config]\n @return [Array]", "Helper for creating lint from a parse tree node\n\n @param node_or_line_or_location [Sass::Script::Tree::Node, Fixnum,\n SCSSLint::Location, Sass::Source::Position]\n @param message [String]", "Extracts the original source code given a range.\n\n @param source_range [Sass::Source::Range]\n @return [String] the original source code", "Returns whether a given node spans only a single line.\n\n @param node [Sass::Tree::Node]\n @return [true,false] whether the node spans a single line", "Modified so we can also visit selectors in linters\n\n @param node [Sass::Tree::Node, Sass::Script::Tree::Node,\n Sass::Script::Value::Base]", "Redefine so we can set the `node_parent` of each node\n\n @param parent [Sass::Tree::Node, Sass::Script::Tree::Node,\n Sass::Script::Value::Base]", "Since keyword arguments are not guaranteed to be in order, use the source\n range to order arguments so we check them in the order they were declared.", "Find the comma following this argument.\n\n The Sass parser is unpredictable in where it marks the end of the\n source range. Thus we need to start at the indicated range, and check\n left and right of that range, gradually moving further outward until\n we find the comma.", "For stubbing in tests.", "Returns a key identifying the bucket this property and value correspond to\n for purposes of uniqueness.", "Check if, starting from the end of a string\n and moving backwards, towards the beginning,\n we find a new line before any non-whitespace characters", "Checks if an individual sequence is split over multiple lines", "Checks if a property value's units are allowed.\n\n @param node [Sass::Tree::Node]\n @param property [String]\n @param units [String]", "Find the child that is out of place", "Return nth-ancestor of a node, where 1 is the parent, 2 is grandparent,\n etc.\n\n @param node [Sass::Tree::Node, Sass::Script::Tree::Node]\n @param level [Integer]\n @return [Sass::Tree::Node, Sass::Script::Tree::Node, nil]", "Return whether to ignore a property in the sort order.\n\n This includes:\n - properties containing interpolation\n - properties not explicitly defined in the sort order (if ignore_unspecified is set)", "Matches the block or conditions hash", "Check if the user has permission to perform a given action on an object.\n\n can? :destroy, @project\n\n You can also pass the class instead of an instance (if you don't have one handy).\n\n can? :create, Project\n\n Nested resources can be passed through a hash, this way conditions which are\n dependent upon the association will work when using a class.\n\n can? :create, @category => Project\n\n You can also pass multiple objects to check. You only need to pass a hash\n following the pattern { :any => [many subjects] }. The behaviour is check if\n there is a permission on any of the given objects.\n\n can? :create, {:any => [Project, Rule]}\n\n\n Any additional arguments will be passed into the \"can\" block definition. This\n can be used to pass more information about the user's request for example.\n\n can? :create, Project, request.remote_ip\n\n can :create, Project do |project, remote_ip|\n # ...\n end\n\n Not only can you use the can? method in the controller and view (see ControllerAdditions),\n but you can also call it directly on an ability instance.\n\n ability.can? :destroy, @project\n\n This makes testing a user's abilities very easy.\n\n def test \"user can only destroy projects which he owns\"\n user = User.new\n ability = Ability.new(user)\n assert ability.can?(:destroy, Project.new(:user => user))\n assert ability.cannot?(:destroy, Project.new)\n end\n\n Also see the RSpec Matchers to aid in testing.", "Defines which abilities are allowed using two arguments. The first one is the action\n you're setting the permission for, the second one is the class of object you're setting it on.\n\n can :update, Article\n\n You can pass an array for either of these parameters to match any one.\n Here the user has the ability to update or destroy both articles and comments.\n\n can [:update, :destroy], [Article, Comment]\n\n You can pass :all to match any object and :manage to match any action. Here are some examples.\n\n can :manage, :all\n can :update, :all\n can :manage, Project\n\n You can pass a hash of conditions as the third argument. Here the user can only see active projects which he owns.\n\n can :read, Project, :active => true, :user_id => user.id\n\n See ActiveRecordAdditions#accessible_by for how to use this in database queries. These conditions\n are also used for initial attributes when building a record in ControllerAdditions#load_resource.\n\n If the conditions hash does not give you enough control over defining abilities, you can use a block\n along with any Ruby code you want.\n\n can :update, Project do |project|\n project.groups.include?(user.group)\n end\n\n If the block returns true then the user has that :update ability for that project, otherwise he\n will be denied access. The downside to using a block is that it cannot be used to generate\n conditions for database queries.\n\n You can pass custom objects into this \"can\" method, this is usually done with a symbol\n and is useful if a class isn't available to define permissions on.\n\n can :read, :stats\n can? :read, :stats # => true\n\n IMPORTANT: Neither a hash of conditions nor a block will be used when checking permission on a class.\n\n can :update, Project, :priority => 3\n can? :update, Project # => true\n\n If you pass no arguments to +can+, the action, class, and object will be passed to the block and the\n block will always be executed. This allows you to override the full behavior if the permissions are\n defined in an external source such as the database.\n\n can do |action, object_class, object|\n # check the database and return true/false\n end", "Defines an ability which cannot be done. Accepts the same arguments as \"can\".\n\n can :read, :all\n cannot :read, Comment\n\n A block can be passed just like \"can\", however if the logic is complex it is recommended\n to use the \"can\" method.\n\n cannot :read, Product do |product|\n product.invisible?\n end", "User shouldn't specify targets with names of real actions or it will cause Seg fault", "Adds a new Archive to a Backup Model.\n\n Backup::Model.new(:my_backup, 'My Backup') do\n archive :my_archive do |archive|\n archive.add 'path/to/archive'\n archive.add '/another/path/to/archive'\n archive.exclude 'path/to/exclude'\n archive.exclude '/another/path/to/exclude'\n end\n end\n\n All paths added using `add` or `exclude` will be expanded to their\n full paths from the root of the filesystem. Files will be added to\n the tar archive using these full paths, and their leading `/` will\n be preserved (using tar's `-P` option).\n\n /path/to/pwd/path/to/archive/...\n /another/path/to/archive/...\n\n When a `root` path is given, paths to add/exclude are taken as\n relative to the `root` path, unless given as absolute paths.\n\n Backup::Model.new(:my_backup, 'My Backup') do\n archive :my_archive do |archive|\n archive.root '~/my_data'\n archive.add 'path/to/archive'\n archive.add '/another/path/to/archive'\n archive.exclude 'path/to/exclude'\n archive.exclude '/another/path/to/exclude'\n end\n end\n\n This directs `tar` to change directories to the `root` path to create\n the archive. Unless paths were given as absolute, the paths within the\n archive will be relative to the `root` path.\n\n path/to/archive/...\n /another/path/to/archive/...\n\n For absolute paths added to this archive, the leading `/` will be\n preserved. Take note that when archives are extracted, leading `/` are\n stripped by default, so care must be taken when extracting archives with\n mixed relative/absolute paths.", "Adds an Database. Multiple Databases may be added to the model.", "Adds an Storage. Multiple Storages may be added to the model.", "Adds an Syncer. Multiple Syncers may be added to the model.", "Adds a Splitter to split the final backup package into multiple files.\n\n +chunk_size+ is specified in MiB and must be given as an Integer.\n +suffix_length+ controls the number of characters used in the suffix\n (and the maximum number of chunks possible).\n ie. 1 (-a, -b), 2 (-aa, -ab), 3 (-aaa, -aab)", "Performs the backup process\n\n Once complete, #exit_status will indicate the result of this process.\n\n If any errors occur during the backup process, all temporary files will\n be left in place. If the error occurs before Packaging, then the\n temporary folder (tmp_path/trigger) will remain and may contain all or\n some of the configured Archives and/or Database dumps. If the error\n occurs after Packaging, but before the Storages complete, then the final\n packaged files (located in the root of tmp_path) will remain.\n\n *** Important ***\n If an error occurs and any of the above mentioned temporary files remain,\n those files *** will be removed *** before the next scheduled backup for\n the same trigger.", "Returns an array of procedures that will be performed if any\n Archives or Databases are configured for the model.", "Attempts to use all configured Storages, even if some of them result in exceptions.\n Returns true or raises first encountered exception.", "Logs messages when the model starts and finishes.\n\n #exception will be set here if #exit_status is > 1,\n since log(:finished) is called before the +after+ hook.", "Finds the resulting files from the packaging procedure\n and stores an Array of suffixes used in @package.chunk_suffixes.\n If the @chunk_size was never reached and only one file\n was written, that file will be suffixed with '-aa' (or -a; -aaa; etc\n depending upon suffix_length). In which case, it will simply\n remove the suffix from the filename.", "includes required submodules into the model class,\n which usually is called User.", "add virtual password accessor and ORM callbacks.", "Comparation with other query or collection\n If other is collection - search request is executed and\n result is used for comparation\n\n @example\n UsersIndex.filter(term: {name: 'Johny'}) == UsersIndex.filter(term: {name: 'Johny'}) # => true\n UsersIndex.filter(term: {name: 'Johny'}) == UsersIndex.filter(term: {name: 'Johny'}).to_a # => true\n UsersIndex.filter(term: {name: 'Johny'}) == UsersIndex.filter(term: {name: 'Winnie'}) # => false\n\n Adds `explain` parameter to search request.\n\n @example\n UsersIndex.filter(term: {name: 'Johny'}).explain\n UsersIndex.filter(term: {name: 'Johny'}).explain(true)\n UsersIndex.filter(term: {name: 'Johny'}).explain(false)\n\n Calling explain without any arguments sets explanation flag to true.\n With `explain: true`, every result object has `_explanation`\n method\n\n @example\n UsersIndex::User.filter(term: {name: 'Johny'}).explain.first._explanation # => {...}", "Sets elasticsearch `size` search request param\n Default value is set in the elasticsearch and is 10.\n\n @example\n UsersIndex.filter{ name == 'Johny' }.limit(100)\n # => {body: {\n query: {...},\n size: 100\n }}", "Sets elasticsearch `from` search request param\n\n @example\n UsersIndex.filter{ name == 'Johny' }.offset(300)\n # => {body: {\n query: {...},\n from: 300\n }}", "Adds facets section to the search request.\n All the chained facets a merged and added to the\n search request\n\n @example\n UsersIndex.facets(tags: {terms: {field: 'tags'}}).facets(ages: {terms: {field: 'age'}})\n # => {body: {\n query: {...},\n facets: {tags: {terms: {field: 'tags'}}, ages: {terms: {field: 'age'}}}\n }}\n\n If called parameterless - returns result facets from ES performing request.\n Returns empty hash if no facets was requested or resulted.", "Adds a script function to score the search request. All scores are\n added to the search request and combinded according to\n `boost_mode` and `score_mode`\n\n @example\n UsersIndex.script_score(\"doc['boost'].value\", params: { modifier: 2 })\n # => {body:\n query: {\n function_score: {\n query: { ...},\n functions: [{\n script_score: {\n script: \"doc['boost'].value * modifier\",\n params: { modifier: 2 }\n }\n }\n }]\n } } }", "Adds a boost factor to the search request. All scores are\n added to the search request and combinded according to\n `boost_mode` and `score_mode`\n\n This probably only makes sense if you specify a filter\n for the boost factor as well\n\n @example\n UsersIndex.boost_factor(23, filter: { term: { foo: :bar} })\n # => {body:\n query: {\n function_score: {\n query: { ...},\n functions: [{\n boost_factor: 23,\n filter: { term: { foo: :bar } }\n }]\n } } }", "Adds a random score to the search request. All scores are\n added to the search request and combinded according to\n `boost_mode` and `score_mode`\n\n This probably only makes sense if you specify a filter\n for the random score as well.\n\n If you do not pass in a seed value, Time.now will be used\n\n @example\n UsersIndex.random_score(23, filter: { foo: :bar})\n # => {body:\n query: {\n function_score: {\n query: { ...},\n functions: [{\n random_score: { seed: 23 },\n filter: { foo: :bar }\n }]\n } } }", "Add a field value scoring to the search. All scores are\n added to the search request and combinded according to\n `boost_mode` and `score_mode`\n\n This function is only available in Elasticsearch 1.2 and\n greater\n\n @example\n UsersIndex.field_value_factor(\n {\n field: :boost,\n factor: 1.2,\n modifier: :sqrt\n }, filter: { foo: :bar})\n # => {body:\n query: {\n function_score: {\n query: { ...},\n functions: [{\n field_value_factor: {\n field: :boost,\n factor: 1.2,\n modifier: :sqrt\n },\n filter: { foo: :bar }\n }]\n } } }", "Add a decay scoring to the search. All scores are\n added to the search request and combinded according to\n `boost_mode` and `score_mode`\n\n The parameters have default values, but those may not\n be very useful for most applications.\n\n @example\n UsersIndex.decay(\n :gauss,\n :field,\n origin: '11, 12',\n scale: '2km',\n offset: '5km',\n decay: 0.4,\n filter: { foo: :bar})\n # => {body:\n query: {\n gauss: {\n query: { ...},\n functions: [{\n gauss: {\n field: {\n origin: '11, 12',\n scale: '2km',\n offset: '5km',\n decay: 0.4\n }\n },\n filter: { foo: :bar }\n }]\n } } }", "Sets elasticsearch `aggregations` search request param\n\n @example\n UsersIndex.filter{ name == 'Johny' }.aggregations(category_id: {terms: {field: 'category_ids'}})\n # => {body: {\n query: {...},\n aggregations: {\n terms: {\n field: 'category_ids'\n }\n }\n }}", "In this simplest of implementations each named aggregation must be uniquely named", "Deletes all documents matching a query.\n\n @example\n UsersIndex.delete_all\n UsersIndex.filter{ age <= 42 }.delete_all\n UsersIndex::User.delete_all\n UsersIndex::User.filter{ age <= 42 }.delete_all", "Find all documents matching a query.\n\n @example\n UsersIndex.find(42)\n UsersIndex.filter{ age <= 42 }.find(42)\n UsersIndex::User.find(42)\n UsersIndex::User.filter{ age <= 42 }.find(42)\n\n In all the previous examples find will return a single object.\n To get a collection - pass an array of ids.\n\n @example\n UsersIndex::User.find(42, 7, 3) # array of objects with ids in [42, 7, 3]\n UsersIndex::User.find([8, 13]) # array of objects with ids in [8, 13]\n UsersIndex::User.find([42]) # array of the object with id == 42", "A helper to build a bolt command used in acceptance testing\n @param [Beaker::Host] host the host to execute the command on\n @param [String] command the command to execute on the bolt SUT\n @param [Hash] flags the command flags to append to the command\n @option flags [String] '--nodes' the nodes to run on\n @option flags [String] '--user' the user to run the command as\n @option flags [String] '--password' the password for the user\n @option flags [nil] '--no-host-key-check' specify nil to use\n @option flags [nil] '--no-ssl' specify nil to use\n @param [Hash] opts the options hash for this method", "Count the number of top-level statements in the AST.", "Create a cache dir if necessary and update it's last write time. Returns the dir.\n Acquires @cache_dir_mutex to ensure we don't try to purge the directory at the same time.\n Uses the directory mtime because it's simpler to ensure the directory exists and update\n mtime in a single place than with a file in a directory that may not exist.", "If the file doesn't exist or is invalid redownload it\n This downloads, validates and moves into place", "This handles running the job, catching errors, and turning the result\n into a result set", "Starts executing the given block on a list of nodes in parallel, one thread per \"batch\".\n\n This is the main driver of execution on a list of targets. It first\n groups targets by transport, then divides each group into batches as\n defined by the transport. Yields each batch, along with the corresponding\n transport, to the block in turn and returns an array of result promises.", "Parses a snippet of Puppet manifest code and returns the AST represented\n in JSON.", "This converts a plan signature object into a format used by the outputter.\n Must be called from within bolt compiler to pickup type aliases used in the plan signature.", "Returns a mapping of all modules available to the Bolt compiler\n\n @return [Hash{String => Array String,nil}>}]\n A hash that associates each directory on the module path with an array\n containing a hash of information for each module in that directory.\n The information hash provides the name, version, and a string\n indicating whether the module belongs to an internal module group.", "URI can be passes as nil", "Override in your tests", "Convert an r10k log level to a bolt log level. These correspond 1-to-1\n except that r10k has debug, debug1, and debug2. The log event has the log\n level as an integer that we need to look up.", "Pass a target to get_targets for a public version of this\n Should this reconfigure configured targets?", "Prints all information associated to the breakpoint", "Main byebug's REPL", "Run permanent commands.", "Executes the received input\n\n Instantiates a command matching the input and runs it. If a matching\n command is not found, it evaluates the unknown input.", "Restores history from disk.", "Saves history to disk.", "Prints the requested numbers of history entries.", "Whether a specific command should not be stored in history.\n\n For now, empty lines and consecutive duplicates.", "Delegates to subcommands or prints help if no subcommand specified.", "Gets local variables for the frame.", "Builds a string containing all available args in the frame number, in a\n verbose or non verbose way according to the value of the +callstyle+\n setting", "Context's stack size", "Line range to be printed by `list`.\n\n If is set, range is parsed from it.\n\n Otherwise it's automatically chosen.", "Set line range to be printed by list\n\n @return first line number to list\n @return last line number to list", "Show a range of lines in the current file.\n\n @param min [Integer] Lower bound\n @param max [Integer] Upper bound", "Starts byebug to debug a program.", "Processes options passed from the command line.", "Reads a new line from the interface's input stream, parses it into\n commands and saves it to history.\n\n @return [String] Representing something to be run by the debugger.", "Raw content of license file, including YAML front matter", "Given another license or project file, calculates the similarity\n as a percentage of words in common", "Content with the title and version removed\n The first time should normally be the attribution line\n Used to dry up `content_normalized` but we need the case sensitive\n content with attribution first to detect attribuion in LicenseFile", "this is where users arrive after visiting the password reset confirmation link", "this action is responsible for generating unlock tokens and\n sending emails", "intermediary route for successful omniauth authentication. omniauth does\n not support multiple models, so we must resort to this terrible hack.", "this will be determined differently depending on the action that calls\n it. redirect_callbacks is called upon returning from successful omniauth\n authentication, and the target params live in an omniauth-specific\n request.env variable. this variable is then persisted thru the redirect\n using our own dta.omniauth.params session var. the omniauth_success\n method will access that session var and then destroy it immediately\n after use. In the failure case, finally, the omniauth params\n are added as query params in our monkey patch to OmniAuth in engine.rb", "break out provider attribute assignment for easy method extension", "derive allowed params from the standard devise parameter sanitizer", "This is a little hacky, because Bitbucket doesn't provide us a PR id", "The paths are relative to dir.", "Could we determine that the CI source is inside a PR?", "Prints a summary of the errors and warnings.", "Rules that apply to a class", "Rules that apply to individual methods, and attributes", "Generates a link to see an example of said rule", "Takes an array of files, gems or nothing, then resolves them into\n paths that should be sent into the documentation parser\n When given existing paths, map to absolute & existing paths\n When given a list of gems, resolve for list of gems\n When empty, imply you want to test the current lib folder as a plugin", "Determine if there's a PR attached to this commit,\n and return the url if so", "Ask the API if the commit is inside a PR", "Make the API call, and parse the JSON", "Raises an error when the given block does not register a plugin.", "Iterates through the DSL's attributes, and table's the output", "The message of the exception reports the content of podspec for the\n line that generated the original exception.\n\n @example Output\n\n Invalid podspec at `RestKit.podspec` - undefined method\n `exclude_header_search_paths=' for #\n\n from spec-repos/master/RestKit/0.9.3/RestKit.podspec:36\n -------------------------------------------\n # because it would break: #import \n > ns.exclude_header_search_paths = 'Code/RestKit.h'\n end\n -------------------------------------------\n\n @return [String] the message of the exception.", "start all the watchers and enable haproxy configuration", "if we don't have a visit, let's try to create one first", "can't use keyword arguments here", "replace % \\ to \\% \\\\", "This method is both a getter and a setter", "added for rails < 3.0.3 compatibility", "this is the entry point for all state and event definitions", "a neutered version of fire - it doesn't actually fire the event, it just\n executes the transition guards to determine if a transition is even\n an option given current conditions.", "Load the Encryption Configuration from a YAML file.\n\n See: `.load!` for parameters.\n Returns [Hash] the configuration for the supplied environment.", "Encrypt data before writing to the supplied stream\n Close the IO Stream.\n\n Notes:\n * Flushes any unwritten data.\n * Once an EncryptionWriter has been closed a new instance must be\n created before writing again.\n * Closes the passed in io stream or file.\n * `close` must be called _before_ the supplied stream is closed.\n\n It is recommended to call Symmetric::EncryptedStream.open\n rather than creating an instance of Symmetric::Writer directly to\n ensure that the encrypted stream is closed before the stream itself is closed.", "Encrypt and then encode a string\n\n Returns data encrypted and then encoded according to the encoding setting\n of this cipher\n Returns nil if str is nil\n Returns \"\" str is empty\n\n Parameters\n\n str [String]\n String to be encrypted. If str is not a string, #to_s will be called on it\n to convert it to a string\n\n random_iv [true|false]\n Whether the encypted value should use a random IV every time the\n field is encrypted.\n Notes:\n * Setting random_iv to true will result in a different encrypted output for\n the same input string.\n * It is recommended to set this to true, except if it will be used as a lookup key.\n * Only set to true if the field will never be used as a lookup key, since\n the encrypted value needs to be same every time in this case.\n * When random_iv is true it adds the random IV string to the header.\n Default: false\n Highly Recommended where feasible: true\n\n compress [true|false]\n Whether to compress str before encryption.\n Default: false\n Notes:\n * Should only be used for large strings since compression overhead and\n the overhead of adding the encryption header may exceed any benefits of\n compression", "Decode and Decrypt string\n Returns a decrypted string after decoding it first according to the\n encoding setting of this cipher\n Returns nil if encrypted_string is nil\n Returns '' if encrypted_string == ''\n\n Parameters\n encrypted_string [String]\n Binary encrypted string to decrypt\n\n Reads the header if present for key, iv, cipher_name and compression\n\n encrypted_string must be in raw binary form when calling this method\n\n Creates a new OpenSSL::Cipher with every call so that this call\n is thread-safe and can be called concurrently by multiple threads with\n the same instance of Cipher", "Advanced use only\n\n Returns a Binary encrypted string without applying Base64, or any other encoding.\n\n str [String]\n String to be encrypted. If str is not a string, #to_s will be called on it\n to convert it to a string\n\n random_iv [true|false]\n Whether the encypted value should use a random IV every time the\n field is encrypted.\n Notes:\n * Setting random_iv to true will result in a different encrypted output for\n the same input string.\n * It is recommended to set this to true, except if it will be used as a lookup key.\n * Only set to true if the field will never be used as a lookup key, since\n the encrypted value needs to be same every time in this case.\n * When random_iv is true it adds the random IV string to the header.\n Default: false\n Highly Recommended where feasible: true\n\n compress [true|false]\n Whether to compress str before encryption.\n Default: false\n Notes:\n * Should only be used for large strings since compression overhead and\n the overhead of adding the encryption header may exceed any benefits of\n compression\n\n header [true|false]\n Whether to add a header to the encrypted string.\n Default: `always_add_header`\n\n See #encrypt to encrypt and encode the result as a string.", "Extracts a string from the supplied buffer.\n The buffer starts with a 2 byte length indicator in little endian format.\n\n Parameters\n buffer [String]\n offset [Integer]\n Start position within the buffer.\n\n Returns [string, offset]\n string [String]\n The string copied from the buffer.\n offset [Integer]\n The new offset within the buffer.", "Reads a single decrypted line from the file up to and including the optional sep_string.\n A sep_string of nil reads the entire contents of the file\n Returns nil on eof\n The stream must be opened for reading or an IOError will be raised.", "Read the header from the file if present", "Yields each item", "Return an instance of what the object looked like at this revision. If\n the object has been destroyed, this will be a new record.", "Returns a hash of the changed attributes with the new values", "Returns a hash of the changed attributes with the old values", "Allows user to undo changes", "Allows user to be set to either a string or an ActiveRecord object\n @private", "Renders an existing named table or builds and renders a custom table if a block is provided.\n\n name - The (optional) name of the table to render (as a Symbol), or the actual Trestle::Table instance itself.\n options - Hash of options that will be passed to the table builder (default: {}):\n :collection - The collection that should be rendered within the table. It should be an\n Array-like object, but will most likely be an ActiveRecord scope. It can\n also be a callable object (i.e. a Proc) in which case the result of calling\n the block will be used as the collection.\n See Trestle::Table::Builder for additional options.\n block - An optional block that is passed to Trestle::Table::Builder to define a custom table.\n One of either the name or block must be provided, but not both.\n\n Examples\n\n <%= table collection: -> { Account.all }, admin: :accounts do %>\n <% column(:name) %>\n <% column(:balance) { |account| account.balance.format } %>\n <% column(:created_at, align: :center)\n <% end %>\n\n <%= table :accounts %>\n\n Returns the HTML representation of the table as a HTML-safe String.", "Custom version of Kaminari's page_entries_info helper to use a\n Trestle-scoped I18n key and add a delimiter to the total count.", "Register an extension hook", "Rolls the stack back to this deploy", "Go from a full Swift version like 4.2.1 to\n something valid for SWIFT_VERSION.", "Gets the related Resource Id Tree for a relationship, and creates it first if it does not exist\n\n @param relationship [JSONAPI::Relationship]\n\n @return [JSONAPI::RelatedResourceIdTree] the new or existing resource id tree for the requested relationship", "Adds a Resource Fragment to the Resources hash\n\n @param fragment [JSONAPI::ResourceFragment]\n @param include_related [Hash]\n\n @return [null]", "Adds a Resource Fragment to the fragments hash\n\n @param fragment [JSONAPI::ResourceFragment]\n @param include_related [Hash]\n\n @return [null]", "Create a new object for connecting to the Stackdriver Error Reporting\n service. Each call creates a new connection.\n\n For more information on connecting to Google Cloud see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scope is:\n\n * `https://www.googleapis.com/auth/cloud-platform`\n\n @param [Integer] timeout Default timeout to use in requests. Optional.\n @param [Hash] client_config A hash of values to override the default\n behavior of the API client. Optional.\n\n @return [Google::Cloud::ErrorReporting::Project]\n\n @example\n require \"google/cloud/error_reporting\"\n\n gcloud = Google::Cloud.new \"GCP_Project_ID\",\n \"/path/to/gcp/secretkey.json\"\n error_reporting = gcloud.error_reporting\n\n error_event = error_reporting.error_event \"Error with Backtrace\",\n event_time: Time.now,\n service_name: \"my_app_name\",\n service_version: \"v8\"\n error_reporting.report error_event", "Creates a new object for connecting to the DNS service.\n Each call creates a new connection.\n\n For more information on connecting to Google Cloud see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scope is:\n\n * `https://www.googleapis.com/auth/ndev.clouddns.readwrite`\n @param [Integer] retries Number of times to retry requests on server\n error. The default value is `3`. Optional.\n @param [Integer] timeout Default timeout to use in requests. Optional.\n\n @return [Google::Cloud::Dns::Project]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n dns = gcloud.dns\n zone = dns.zone \"example-com\"\n zone.records.each do |record|\n puts record.name\n end\n\n @example The default scope can be overridden with the `scope` option:\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n dns_readonly = \"https://www.googleapis.com/auth/ndev.clouddns.readonly\"\n dns = gcloud.dns scope: dns_readonly", "Creates a new object for connecting to the Spanner service.\n Each call creates a new connection.\n\n For more information on connecting to Google Cloud see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scopes are:\n\n * `https://www.googleapis.com/auth/spanner`\n * `https://www.googleapis.com/auth/spanner.data`\n @param [Integer] timeout Default timeout to use in requests. Optional.\n @param [Hash] client_config A hash of values to override the default\n behavior of the API client. Optional.\n\n @return [Google::Cloud::Spanner::Project]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n spanner = gcloud.spanner\n\n @example The default scope can be overridden with the `scope` option:\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n platform_scope = \"https://www.googleapis.com/auth/cloud-platform\"\n spanner = gcloud.spanner scope: platform_scope", "Creates a new object for connecting to the Stackdriver Logging service.\n Each call creates a new connection.\n\n For more information on connecting to Google Cloud see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scope is:\n\n * `https://www.googleapis.com/auth/logging.admin`\n\n @param [Integer] timeout Default timeout to use in requests. Optional.\n @param [Hash] client_config A hash of values to override the default\n behavior of the API client. Optional.\n\n @return [Google::Cloud::Logging::Project]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n logging = gcloud.logging\n\n entries = logging.entries\n entries.each do |e|\n puts \"[#{e.timestamp}] #{e.log_name} #{e.payload.inspect}\"\n end\n\n @example The default scope can be overridden with the `scope` option:\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n platform_scope = \"https://www.googleapis.com/auth/cloud-platform\"\n logging = gcloud.logging scope: platform_scope", "Creates a new object for connecting to the BigQuery service.\n Each call creates a new connection.\n\n For more information on connecting to Google Cloud see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scope is:\n\n * `https://www.googleapis.com/auth/bigquery`\n @param [Integer] retries Number of times to retry requests on server\n error. The default value is `5`. Optional.\n @param [Integer] timeout Default request timeout in seconds. Optional.\n\n @return [Google::Cloud::Bigquery::Project]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n bigquery = gcloud.bigquery\n dataset = bigquery.dataset \"my_dataset\"\n table = dataset.table \"my_table\"\n table.data.each do |row|\n puts row\n end\n\n @example The default scope can be overridden with the `scope` option:\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n platform_scope = \"https://www.googleapis.com/auth/cloud-platform\"\n bigquery = gcloud.bigquery scope: platform_scope", "Creates a new debugger object for instrumenting Stackdriver Debugger for\n an application. Each call creates a new debugger agent with independent\n connection service.\n\n For more information on connecting to Google Cloud see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param [String] service_name Name for the debuggee application. Optional.\n @param [String] service_version Version identifier for the debuggee\n application. Optional.\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scope is:\n\n * `https://www.googleapis.com/auth/cloud_debugger`\n * `https://www.googleapis.com/auth/logging.admin`\n\n @param [Integer] timeout Default timeout to use in requests. Optional.\n @param [Hash] client_config A hash of values to override the default\n behavior of the API client. Optional.\n\n @return [Google::Cloud::Debugger::Project]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n debugger = gcloud.debugger\n\n debugger.start\n\n @example The default scope can be overridden with the `scope` option:\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n platform_scope = \"https://www.googleapis.com/auth/cloud-platform\"\n debugger = gcloud.debugger scope: platform_scope", "Creates a new object for connecting to the Datastore service.\n Each call creates a new connection.\n\n For more information on connecting to Google Cloud see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scope is:\n\n * `https://www.googleapis.com/auth/datastore`\n @param [Integer] timeout Default timeout to use in requests. Optional.\n @param [Hash] client_config A hash of values to override the default\n behavior of the API client. See Google::Gax::CallSettings. Optional.\n\n @return [Google::Cloud::Datastore::Dataset]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n datastore = gcloud.datastore\n\n task = datastore.entity \"Task\" do |t|\n t[\"type\"] = \"Personal\"\n t[\"done\"] = false\n t[\"priority\"] = 4\n t[\"description\"] = \"Learn Cloud Datastore\"\n end\n\n datastore.save task\n\n @example You shouldn't need to override the default scope, but you can:\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n platform_scope = \"https://www.googleapis.com/auth/cloud-platform\"\n datastore = gcloud.datastore scope: platform_scope", "Creates a new object for connecting to the Resource Manager service.\n Each call creates a new connection.\n\n For more information on connecting to Google Cloud see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scope is:\n\n * `https://www.googleapis.com/auth/cloud-platform`\n @param [Integer] retries Number of times to retry requests on server\n error. The default value is `3`. Optional.\n @param [Integer] timeout Default timeout to use in requests. Optional.\n\n @return [Google::Cloud::ResourceManager::Manager]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n resource_manager = gcloud.resource_manager\n resource_manager.projects.each do |project|\n puts projects.project_id\n end\n\n @example The default scope can be overridden with the `scope` option:\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n readonly_scope = \\\n \"https://www.googleapis.com/auth/cloudresourcemanager.readonly\"\n resource_manager = gcloud.resource_manager scope: readonly_scope", "Creates a new object for connecting to the Storage service.\n Each call creates a new connection.\n\n For more information on connecting to Google Cloud see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @see https://cloud.google.com/storage/docs/authentication#oauth Storage\n OAuth 2.0 Authentication\n\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scope is:\n\n * `https://www.googleapis.com/auth/devstorage.full_control`\n @param [Integer] retries Number of times to retry requests on server\n error. The default value is `3`. Optional.\n @param [Integer] timeout Default timeout to use in requests. Optional.\n\n @return [Google::Cloud::Storage::Project]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n storage = gcloud.storage\n bucket = storage.bucket \"my-bucket\"\n file = bucket.file \"path/to/my-file.ext\"\n\n @example The default scope can be overridden with the `scope` option:\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n readonly_scope = \"https://www.googleapis.com/auth/devstorage.read_only\"\n readonly_storage = gcloud.storage scope: readonly_scope", "Creates a new object for connecting to the Cloud Translation API. Each\n call creates a new connection.\n\n Like other Cloud Platform services, Google Cloud Translation API supports\n authentication using a project ID and OAuth 2.0 credentials. In addition,\n it supports authentication using a public API access key. (If both the API\n key and the project and OAuth 2.0 credentials are provided, the API key\n will be used.) Instructions and configuration options are covered in the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param [String] key a public API access key (not an OAuth 2.0 token)\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scope is:\n\n * `https://www.googleapis.com/auth/cloud-platform`\n @param [Integer] retries Number of times to retry requests on server\n error. The default value is `3`. Optional.\n @param [Integer] timeout Default timeout to use in requests. Optional.\n\n @return [Google::Cloud::Translate::Api]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n translate = gcloud.translate \"api-key-abc123XYZ789\"\n\n translation = translate.translate \"Hello world!\", to: \"la\"\n translation.text #=> \"Salve mundi!\"\n\n @example Using API Key from the environment variable.\n require \"google/cloud\"\n\n ENV[\"TRANSLATE_KEY\"] = \"api-key-abc123XYZ789\"\n\n gcloud = Google::Cloud.new\n translate = gcloud.translate\n\n translation = translate.translate \"Hello world!\", to: \"la\"\n translation.text #=> \"Salve mundi!\"", "Creates a new object for connecting to the Firestore service.\n Each call creates a new connection.\n\n For more information on connecting to Google Cloud see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scope is:\n\n * `https://www.googleapis.com/auth/datastore`\n @param [Integer] timeout Default timeout to use in requests. Optional.\n @param [Hash] client_config A hash of values to override the default\n behavior of the API client. Optional.\n\n @return [Google::Cloud::Firestore::Client]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n firestore = gcloud.firestore\n\n @example The default scope can be overridden with the `scope` option:\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n platform_scope = \"https://www.googleapis.com/auth/cloud-platform\"\n firestore = gcloud.firestore scope: platform_scope", "Creates a new object for connecting to the Stackdriver Trace service.\n Each call creates a new connection.\n\n For more information on connecting to Google Cloud see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param [String, Array] scope The OAuth 2.0 scopes controlling the\n set of resources and operations that the connection can access. See\n [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n\n The default scope is:\n\n * `https://www.googleapis.com/auth/cloud-platform`\n\n @param [Integer] timeout Default timeout to use in requests. Optional.\n\n @return [Google::Cloud::Trace::Project]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n trace_client = gcloud.trace\n\n traces = trace_client.list_traces Time.now - 3600, Time.now\n traces.each do |trace|\n puts \"Retrieved trace ID: #{trace.trace_id}\"\n end", "Creates a new object for connecting to the Cloud Bigtable service.\n\n For more information on connecting to Google Cloud Platform, see the\n {file:AUTHENTICATION.md Authentication Guide}.\n\n @param scope [Array]\n The OAuth 2.0 scopes controlling the set of resources and operations\n that the connection can access. See [Using OAuth 2.0 to Access Google\n APIs](https://developers.google.com/identity/protocols/OAuth2).\n The OAuth scopes for this service. This parameter is ignored if an\n updater_proc is supplied.\n @param timeout [Integer]\n The default timeout, in seconds, for calls made through this client.\n @param credentials [Google::Auth::Credentials, String, Hash, GRPC::Core::Channel, GRPC::Core::ChannelCredentials, Proc]\n Provides the means for authenticating requests made by the client. This parameter can\n be one of the following types.\n `Google::Auth::Credentials` uses the properties of its represented keyfile for\n authenticating requests made by this client.\n `String` will be treated as the path to the keyfile to use to construct\n credentials for this client.\n `Hash` will be treated as the contents of a keyfile to use to construct\n credentials for this client.\n `GRPC::Core::Channel` will be used to make calls through.\n `GRPC::Core::ChannelCredentials` will be used to set up the gRPC client. The channel credentials\n should already be composed with a `GRPC::Core::CallCredentials` object.\n `Proc` will be used as an updater_proc for the gRPC channel. The proc transforms the\n metadata for requests, generally, to give OAuth credentials.\n @param client_config [Hash]\n A hash for call options for each method.\n See Google::Gax#construct_settings for the structure of\n this data. Falls back to the default config if not specified\n or the specified config is missing data points.\n @return [Google::Cloud::Bigtable::Project]\n\n @example\n require \"google/cloud\"\n\n gcloud = Google::Cloud.new\n\n bigtable = gcloud.bigtable", "Compare two hashes for equality\n\n For two hashes to match they must have the same length and all\n values must match when compared using `#===`.\n\n The following hashes are examples of matches:\n\n {a: /\\d+/} and {a: '123'}\n\n {a: '123'} and {a: '123'}\n\n {a: {b: /\\d+/}} and {a: {b: '123'}}\n\n {a: {b: 'wow'}} and {a: {b: 'wow'}}\n\n @param [Hash] query_parameters typically the result of parsing\n JSON, XML or URL encoded parameters.\n\n @param [Hash] pattern which contains keys with a string, hash or\n regular expression value to use for comparison.\n\n @return [Boolean] true if the paramaters match the comparison\n hash, false if not.", "Apply all filters in the pipeline to the given HTML.\n\n html - A String containing HTML or a DocumentFragment object.\n context - The context hash passed to each filter. See the Filter docs\n for more info on possible values. This object MUST NOT be modified\n in place by filters. Use the Result for passing state back.\n result - The result Hash passed to each filter for modification. This\n is where Filters store extracted information from the content.\n\n Returns the result Hash after being filtered by this Pipeline. Contains an\n :output key with the DocumentFragment or String HTML markup based on the\n output of the last filter in the pipeline.", "Like call but guarantee the value returned is a DocumentFragment.\n Pipelines may return a DocumentFragment or a String. Callers that need a\n DocumentFragment should use this method.", "Like call but guarantee the value returned is a string of HTML markup.", "Total number of pages", "Current page number", "Used for page_entry_info", "Executes a watcher action.\n\n @param [String, MatchData] matches the matched path or the match from the\n Regex\n @return [String] the final paths", "Start Guard by initializing the defined Guard plugins and watch the file\n system.\n\n This is the default task, so calling `guard` is the same as calling\n `guard start`.\n\n @see Guard.start", "List the Notifiers for use in your system.\n\n @see Guard::DslDescriber.notifiers", "Initializes the templates of all installed Guard plugins and adds them\n to the `Guardfile` when no Guard name is passed. When passing\n Guard plugin names it does the same but only for those Guard plugins.\n\n @see Guard::Guardfile.initialize_template\n @see Guard::Guardfile.initialize_all_templates\n\n @param [Array] plugin_names the name of the Guard plugins to\n initialize", "Shows all Guard plugins and their options that are defined in\n the `Guardfile`\n\n @see Guard::DslDescriber.show", "Adds a plugin's template to the Guardfile.", "Returns the constant for the current plugin.\n\n @example Returns the constant for a plugin\n > Guard::PluginUtil.new('rspec').send(:_plugin_constant)\n => Guard::RSpec", "Sets the interactor options or disable the interactor.\n\n @example Pass options to the interactor\n interactor option1: 'value1', option2: 'value2'\n\n @example Turn off interactions\n interactor :off\n\n @param [Symbol, Hash] options either `:off` or a Hash with interactor\n options", "Declares a Guard plugin to be used when running `guard start`.\n\n The name parameter is usually the name of the gem without\n the 'guard-' prefix.\n\n The available options are different for each Guard implementation.\n\n @example Declare a Guard without `watch` patterns\n guard :rspec\n\n @example Declare a Guard with a `watch` pattern\n guard :rspec do\n watch %r{.*_spec.rb}\n end\n\n @param [String] name the Guard plugin name\n @param [Hash] options the options accepted by the Guard plugin\n @yield a block where you can declare several watch patterns and actions\n\n @see Plugin\n @see Guard.add_plugin\n @see #watch\n @see #group", "Defines a pattern to be watched in order to run actions on file\n modification.\n\n @example Declare watchers for a Guard\n guard :rspec do\n watch('spec/spec_helper.rb')\n watch(%r{^.+_spec.rb})\n watch(%r{^app/controllers/(.+).rb}) do |m|\n 'spec/acceptance/#{m[1]}s_spec.rb'\n end\n end\n\n @example Declare global watchers outside of a Guard\n watch(%r{^(.+)$}) { |m| puts \"#{m[1]} changed.\" }\n\n @param [String, Regexp] pattern the pattern that Guard must watch for\n modification\n\n @yield a block to be run when the pattern is matched\n @yieldparam [MatchData] m matches of the pattern\n @yieldreturn a directory, a filename, an array of\n directories / filenames, or nothing (can be an arbitrary command)\n\n @see Guard::Watcher\n @see #guard", "Defines a callback to execute arbitrary code before or after any of\n the `start`, `stop`, `reload`, `run_all`, `run_on_changes`,\n `run_on_additions`, `run_on_modifications` and `run_on_removals` plugin\n method.\n\n @example Add callback before the `reload` action.\n callback(:reload_begin) { puts \"Let's reload!\" }\n\n @example Add callback before the `start` and `stop` actions.\n\n my_lambda = lambda do |plugin, event, *args|\n puts \"Let's #{event} #{plugin} with #{args}!\"\n end\n\n callback(my_lambda, [:start_begin, :start_end])\n\n @param [Array] args the callback arguments\n @yield a callback block", "Configures the Guard logger.\n\n * Log level must be either `:debug`, `:info`, `:warn` or `:error`.\n * Template supports the following placeholders: `:time`, `:severity`,\n `:progname`, `:pid`, `:unit_of_work_id` and `:message`.\n * Time format directives are the same as `Time#strftime` or\n `:milliseconds`.\n * The `:only` and `:except` options must be a `RegExp`.\n\n @example Set the log level\n logger level: :warn\n\n @example Set a custom log template\n logger template: '[Guard - :severity - :progname - :time] :message'\n\n @example Set a custom time format\n logger time_format: '%h'\n\n @example Limit logging to a Guard plugin\n logger only: :jasmine\n\n @example Log all but not the messages from a specific Guard plugin\n logger except: :jasmine\n\n @param [Hash] options the log options\n @option options [String, Symbol] level the log level\n @option options [String] template the logger template\n @option options [String, Symbol] time_format the time format\n @option options [Regexp] only show only messages from the matching Guard\n plugin\n @option options [Regexp] except does not show messages from the matching\n Guard plugin", "Sets the directories to pass to Listen\n\n @example watch only given directories\n directories %w(lib specs)\n\n @param [Array] directories directories for Listen to watch", "Start Guard by evaluating the `Guardfile`, initializing declared Guard\n plugins and starting the available file change listener.\n Main method for Guard that is called from the CLI when Guard starts.\n\n - Setup Guard internals\n - Evaluate the `Guardfile`\n - Configure Notifiers\n - Initialize the declared Guard plugins\n - Start the available file change listener\n\n @option options [Boolean] clear if auto clear the UI should be done\n @option options [Boolean] notify if system notifications should be shown\n @option options [Boolean] debug if debug output should be shown\n @option options [Array] group the list of groups to start\n @option options [String] watchdir the director to watch\n @option options [String] guardfile the path to the Guardfile\n @see CLI#start", "Trigger `run_all` on all Guard plugins currently enabled.\n\n @param [Hash] scopes hash with a Guard plugin or a group scope", "Pause Guard listening to file changes.", "Shows all Guard plugins and their options that are defined in\n the `Guardfile`.\n\n @see CLI#show", "Shows all notifiers and their options that are defined in\n the `Guardfile`.\n\n @see CLI#show", "Runs a Guard-task on all registered plugins.\n\n @param [Symbol] task the task to run\n\n @param [Hash] scope_hash either the Guard plugin or the group to run the task\n on", "Runs the appropriate tasks on all registered plugins\n based on the passed changes.\n\n @param [Array] modified the modified paths.\n @param [Array] added the added paths.\n @param [Array] removed the removed paths.", "Run a Guard plugin task, but remove the Guard plugin when his work leads\n to a system failure.\n\n When the Group has `:halt_on_fail` disabled, we've to catch\n `:task_has_failed` here in order to avoid an uncaught throw error.\n\n @param [Guard::Plugin] plugin guard the Guard to execute\n @param [Symbol] task the task to run\n @param [Array] args the arguments for the task\n @raise [:task_has_failed] when task has failed", "Value of the Content-Length header.\n\n @return [nil] if Content-Length was not given, or it's value was invalid\n (not an integer, e.g. empty string or string with non-digits).\n @return [Integer] otherwise", "Read a chunk of the body\n\n @return [String] data chunk\n @return [nil] when no more data left", "Sets up SSL context and starts TLS if needed.\n @param (see #initialize)\n @return [void]", "Open tunnel through proxy", "Store whether the connection should be kept alive.\n Once we reset the parser, we lose all of this state.\n @return [void]", "Feeds some more data into parser\n @return [void]", "Make a request through an HTTP proxy\n @param [Array] proxy\n @raise [Request::Error] if HTTP proxy is invalid", "Make a request with the given Basic authorization header\n @see http://tools.ietf.org/html/rfc2617\n @param [#fetch] opts\n @option opts [#to_s] :user\n @option opts [#to_s] :pass", "Make an HTTP request", "Prepare an HTTP request", "Verify our request isn't going to be made against another URI", "Merges query params if needed\n\n @param [#to_s] uri\n @return [URI]", "Create the request body object to send", "Removes header.\n\n @param [#to_s] name header name\n @return [void]", "Appends header.\n\n @param [#to_s] name header name\n @param [Array<#to_s>, #to_s] value header value(s) to be appended\n @return [void]", "Returns list of header values if any.\n\n @return [Array]", "Tells whenever header with given `name` is set or not.\n\n @return [Boolean]", "Merges `other` headers into `self`.\n\n @see #merge\n @return [void]", "Transforms `name` to canonical HTTP header capitalization\n\n @param [String] name\n @raise [HeaderError] if normalized name does not\n match {HEADER_NAME_RE}\n @return [String] canonical HTTP header name", "Ensures there is no new line character in the header value\n\n @param [String] value\n @raise [HeaderError] if value includes new line character\n @return [String] stringified header value", "Redirect policy for follow\n @return [Request]", "Stream the request to a socket", "Headers to send with proxy connect request", "returns all values in this column as an array\n column numbers are 1,2,3,... like in the spreadsheet", "returns the internal format of an excel cell", "Extracts all needed files from the zip file", "If the ODS file has an encryption-data element, then try to decrypt.\n If successful, the temporary content.xml will be overwritten with\n decrypted contents.", "Process the ODS encryption manifest and perform the decryption", "Create a cipher key based on an ODS algorithm string from manifest.xml", "Block decrypt raw bytes from the zip file based on the cipher", "helper function to set the internal representation of cells", "Compute upper bound for cells in a given cell range.", "Catalog a bundle.\n\n @param bundle [Bundle]\n @return [self]", "Get a clip by filename and position.\n\n @param filename [String]\n @param position [Position, Array(Integer, Integer)]\n @return [SourceMap::Clip]", "Get suggestions for constants in the specified namespace. The result\n may contain both constant and namespace pins.\n\n @param namespace [String] The namespace\n @param context [String] The context\n @return [Array]", "Get a fully qualified namespace name. This method will start the search\n in the specified context until it finds a match for the name.\n\n @param namespace [String, nil] The namespace to match\n @param context [String] The context to search\n @return [String]", "Get an array of instance variable pins defined in specified namespace\n and scope.\n\n @param namespace [String] A fully qualified namespace\n @param scope [Symbol] :instance or :class\n @return [Array]", "Get an array of methods available in a particular context.\n\n @param fqns [String] The fully qualified namespace to search for methods\n @param scope [Symbol] :class or :instance\n @param visibility [Array] :public, :protected, and/or :private\n @param deep [Boolean] True to include superclasses, mixins, etc.\n @return [Array]", "Get an array of method pins for a complex type.\n\n The type's namespace and the context should be fully qualified. If the\n context matches the namespace type or is a subclass of the type,\n protected methods are included in the results. If protected methods are\n included and internal is true, private methods are also included.\n\n @example\n api_map = Solargraph::ApiMap.new\n type = Solargraph::ComplexType.parse('String')\n api_map.get_complex_type_methods(type)\n\n @param type [Solargraph::ComplexType] The complex type of the namespace\n @param context [String] The context from which the type is referenced\n @param internal [Boolean] True to include private methods\n @return [Array]", "Get a stack of method pins for a method name in a namespace. The order\n of the pins corresponds to the ancestry chain, with highest precedence\n first.\n\n @example\n api_map.get_method_stack('Subclass', 'method_name')\n #=> [ , ]\n\n @param fqns [String]\n @param name [String]\n @param scope [Symbol] :instance or :class\n @return [Array]", "Get an array of all suggestions that match the specified path.\n\n @deprecated Use #get_path_pins instead.\n\n @param path [String] The path to find\n @return [Array]", "Get a list of documented paths that match the query.\n\n @example\n api_map.query('str') # Results will include `String` and `Struct`\n\n @param query [String] The text to match\n @return [Array]", "Get YARD documentation for the specified path.\n\n @example\n api_map.document('String#split')\n\n @param path [String] The path to find\n @return [Array]", "Get an array of all symbols in the workspace that match the query.\n\n @param query [String]\n @return [Array]", "Require extensions for the experimental plugin architecture. Any\n installed gem with a name that starts with \"solargraph-\" is considered\n an extension.\n\n @return [void]", "Sort an array of pins to put nil or undefined variables last.\n\n @param pins [Array]\n @return [Array]", "Check if a class is a superclass of another class.\n\n @param sup [String] The superclass\n @param sub [String] The subclass\n @return [Boolean]", "True if the specified position is inside the range.\n\n @param position [Position, Array(Integer, Integer)]\n @return [Boolean]", "True if the range contains the specified position and the position does not precede it.\n\n @param position [Position, Array(Integer, Integer)]\n @return [Boolean]", "Get an array of nodes containing the specified index, starting with the\n nearest node and ending with the root.\n\n @param line [Integer]\n @param column [Integer]\n @return [Array]", "Synchronize the Source with an update. This method applies changes to the\n code, parses the new code's AST, and returns the resulting Source object.\n\n @param updater [Source::Updater]\n @return [Source]", "A location representing the file in its entirety.\n\n @return [Location]", "Get a hash of comments grouped by the line numbers of the associated code.\n\n @return [Hash{Integer => Array}]", "Get a string representation of an array of comments.\n\n @param comments [Array]\n @return [String]", "Get an array of foldable comment block ranges. Blocks are excluded if\n they are less than 3 lines long.\n\n @return [Array]", "Merge the source. A merge will update the existing source for the file\n or add it to the sources if the workspace is configured to include it.\n The source is ignored if the configuration excludes it.\n\n @param source [Solargraph::Source]\n @return [Boolean] True if the source was added to the workspace", "Determine whether a file would be merged into the workspace.\n\n @param filename [String]\n @return [Boolean]", "Remove a source from the workspace. The source will not be removed if\n its file exists and the workspace is configured to include it.\n\n @param filename [String]\n @return [Boolean] True if the source was removed from the workspace", "True if the path resolves to a file in the workspace's require paths.\n\n @param path [String]\n @return [Boolean]", "Synchronize the workspace from the provided updater.\n\n @param updater [Source::Updater]\n @return [void]", "Generate require paths from gemspecs if they exist or assume the default\n lib directory.\n\n @return [Array]", "Get additional require paths defined in the configuration.\n\n @return [Array]", "Create a source to be added to the workspace. The file is ignored if it is\n neither open in the library nor included in the workspace.\n\n @param filename [String]\n @param text [String] The contents of the file\n @return [Boolean] True if the file was added to the workspace.", "Create a file source from a file on disk. The file is ignored if it is\n neither open in the library nor included in the workspace.\n\n @param filename [String]\n @return [Boolean] True if the file was added to the workspace.", "Delete a file from the library. Deleting a file will make it unavailable\n for checkout and optionally remove it from the workspace unless the\n workspace configuration determines that it should still exist.\n\n @param filename [String]\n @return [Boolean] True if the file was deleted", "Get completion suggestions at the specified file and location.\n\n @param filename [String] The file to analyze\n @param line [Integer] The zero-based line number\n @param column [Integer] The zero-based column number\n @return [SourceMap::Completion]\n @todo Take a Location instead of filename/line/column", "Get definition suggestions for the expression at the specified file and\n location.\n\n @param filename [String] The file to analyze\n @param line [Integer] The zero-based line number\n @param column [Integer] The zero-based column number\n @return [Array]\n @todo Take filename/position instead of filename/line/column", "Get signature suggestions for the method at the specified file and\n location.\n\n @param filename [String] The file to analyze\n @param line [Integer] The zero-based line number\n @param column [Integer] The zero-based column number\n @return [Array]\n @todo Take filename/position instead of filename/line/column", "Get diagnostics about a file.\n\n @param filename [String]\n @return [Array]", "Update the ApiMap from the library's workspace and open files.\n\n @return [void]", "Try to merge a source into the library's workspace. If the workspace is\n not configured to include the source, it gets ignored.\n\n @param source [Source]\n @return [Boolean] True if the source was merged into the workspace.", "Get the source for an open file or create a new source if the file\n exists on disk. Sources created from disk are not added to the open\n workspace files, i.e., the version on disk remains the authoritative\n version.\n\n @raise [FileNotFoundError] if the file does not exist\n @param filename [String]\n @return [Solargraph::Source]", "Removes the given header fields from options and returns the result. This\n modifies the given options in place.\n\n @param [Hash] options\n\n @return [Hash]", "Unseal the vault with the given shard.\n\n @example\n Vault.sys.unseal(\"abcd-1234\") #=> #\n\n @param [String] shard\n the key to use\n\n @return [SealStatus]", "List the secrets at the given path, if the path supports listing. If the\n the path does not exist, an exception will be raised.\n\n @example\n Vault.logical.list(\"secret\") #=> [#, #, ...]\n\n @param [String] path\n the path to list\n\n @return [Array]", "Read the secret at the given path. If the secret does not exist, +nil+\n will be returned.\n\n @example\n Vault.logical.read(\"secret/password\") #=> #\n\n @param [String] path\n the path to read\n\n @return [Secret, nil]", "Unwrap the data stored against the given token. If the secret does not\n exist, `nil` will be returned.\n\n @example\n Vault.logical.unwrap(\"f363dba8-25a7-08c5-430c-00b2367124e6\") #=> #\n\n @param [String] wrapper\n the token to use when unwrapping the value\n\n @return [Secret, nil]", "Unwrap a token in a wrapped response given the temporary token.\n\n @example\n Vault.logical.unwrap(\"f363dba8-25a7-08c5-430c-00b2367124e6\") #=> \"0f0f40fd-06ce-4af1-61cb-cdc12796f42b\"\n\n @param [String, Secret] wrapper\n the token to unwrap\n\n @return [String, nil]", "List all auths in Vault.\n\n @example\n Vault.sys.auths #=> {:token => #}\n\n @return [Hash]", "Enable a particular authentication at the given path.\n\n @example\n Vault.sys.enable_auth(\"github\", \"github\") #=> true\n\n @param [String] path\n the path to mount the auth\n @param [String] type\n the type of authentication\n @param [String] description\n a human-friendly description (optional)\n\n @return [true]", "Read the given auth path's configuration.\n\n @example\n Vault.sys.auth_tune(\"github\") #=> #\n\n @param [String] path\n the path to retrieve configuration for\n\n @return [AuthConfig]\n configuration of the given auth path", "Write the given auth path's configuration.\n\n @example\n Vault.sys.auth_tune(\"github\", \"default_lease_ttl\" => 600, \"max_lease_ttl\" => 1200 ) #=> true\n\n @param [String] path\n the path to retrieve configuration for\n\n @return [AuthConfig]\n configuration of the given auth path", "Returns true if the connection should be reset due to an idle timeout, or\n maximum request count, false otherwise.", "Is +req+ idempotent according to RFC 2616?", "Pipelines +requests+ to the HTTP server at +uri+ yielding responses if a\n block is given. Returns all responses recieved.\n\n See\n Net::HTTP::Pipeline[http://docs.seattlerb.org/net-http-pipeline/Net/HTTP/Pipeline.html]\n for further details.\n\n Only if net-http-pipeline was required before\n net-http-persistent #pipeline will be present.", "Creates a URI for an HTTP proxy server from ENV variables.\n\n If +HTTP_PROXY+ is set a proxy will be returned.\n\n If +HTTP_PROXY_USER+ or +HTTP_PROXY_PASS+ are set the URI is given the\n indicated user and password unless HTTP_PROXY contains either of these in\n the URI.\n\n The +NO_PROXY+ ENV variable can be used to specify hosts which shouldn't\n be reached via proxy; if set it should be a comma separated list of\n hostname suffixes, optionally with +:port+ appended, for example\n example.com,some.host:8080 . When set to * no proxy will\n be returned.\n\n For Windows users, lowercase ENV variables are preferred over uppercase ENV\n variables.", "Returns true when proxy should by bypassed for host.", "Raises an Error for +exception+ which resulted from attempting the request\n +req+ on the +connection+.\n\n Finishes the +connection+.", "Creates a GET request if +req_or_uri+ is a URI and adds headers to the\n request.\n\n Returns the request.", "Authenticate via the \"token\" authentication method. This authentication\n method is a bit bizarre because you already have a token, but hey,\n whatever floats your boat.\n\n This method hits the `/v1/auth/token/lookup-self` endpoint after setting\n the Vault client's token to the given token parameter. If the self lookup\n succeeds, the token is persisted onto the client for future requests. If\n the lookup fails, the old token (which could be unset) is restored on the\n client.\n\n @example\n Vault.auth.token(\"6440e1bd-ba22-716a-887d-e133944d22bd\") #=> #\n Vault.token #=> \"6440e1bd-ba22-716a-887d-e133944d22bd\"\n\n @param [String] new_token\n the new token to try to authenticate and store on the client\n\n @return [Secret]", "Authenticate via the \"app-id\" authentication method. If authentication is\n successful, the resulting token will be stored on the client and used for\n future requests.\n\n @example\n Vault.auth.app_id(\n \"aeece56e-3f9b-40c3-8f85-781d3e9a8f68\",\n \"3b87be76-95cf-493a-a61b-7d5fc70870ad\",\n ) #=> #\n\n @example with a custom mount point\n Vault.auth.app_id(\n \"aeece56e-3f9b-40c3-8f85-781d3e9a8f68\",\n \"3b87be76-95cf-493a-a61b-7d5fc70870ad\",\n mount: \"new-app-id\",\n )\n\n @param [String] app_id\n @param [String] user_id\n @param [Hash] options\n additional options to pass to the authentication call, such as a custom\n mount point\n\n @return [Secret]", "Authenticate via the \"approle\" authentication method. If authentication is\n successful, the resulting token will be stored on the client and used for\n future requests.\n\n @example\n Vault.auth.approle(\n \"db02de05-fa39-4855-059b-67221c5c2f63\",\n \"6a174c20-f6de-a53c-74d2-6018fcceff64\",\n ) #=> #\n\n @param [String] role_id\n @param [String] secret_id (default: nil)\n It is required when `bind_secret_id` is enabled for the specified role_id\n\n @return [Secret]", "Authenticate via the \"userpass\" authentication method. If authentication\n is successful, the resulting token will be stored on the client and used\n for future requests.\n\n @example\n Vault.auth.userpass(\"sethvargo\", \"s3kr3t\") #=> #\n\n @example with a custom mount point\n Vault.auth.userpass(\"sethvargo\", \"s3kr3t\", mount: \"admin-login\") #=> #\n\n @param [String] username\n @param [String] password\n @param [Hash] options\n additional options to pass to the authentication call, such as a custom\n mount point\n\n @return [Secret]", "Authenticate via the GitHub authentication method. If authentication is\n successful, the resulting token will be stored on the client and used\n for future requests.\n\n @example\n Vault.auth.github(\"mypersonalgithubtoken\") #=> #\n\n @param [String] github_token\n\n @return [Secret]", "Authenticate via the AWS EC2 authentication method. If authentication is\n successful, the resulting token will be stored on the client and used\n for future requests.\n\n @example\n Vault.auth.aws_ec2(\"read-only\", \"pkcs7\", \"vault-nonce\") #=> #\n\n @param [String] role\n @param [String] pkcs7\n pkcs7 returned by the instance identity document (with line breaks removed)\n @param [String] nonce optional\n @param [String] route optional\n\n @return [Secret]", "Authenticate via the GCP authentication method. If authentication is\n successful, the resulting token will be stored on the client and used\n for future requests.\n\n @example\n Vault.auth.gcp(\"read-only\", \"jwt\", \"gcp\") #=> #\n\n @param [String] role\n @param [String] jwt\n jwt returned by the instance identity metadata, or iam api\n @param [String] path optional\n the path were the gcp auth backend is mounted\n\n @return [Secret]", "Authenticate via a TLS authentication method. If authentication is\n successful, the resulting token will be stored on the client and used\n for future requests.\n\n @example Sending raw pem contents\n Vault.auth.tls(pem_contents) #=> #\n\n @example Reading a pem from disk\n Vault.auth.tls(File.read(\"/path/to/my/certificate.pem\")) #=> #\n\n @example Sending to a cert authentication backend mounted at a custom location\n Vault.auth.tls(pem_contents, 'custom/location') #=> #\n\n @param [String] pem (default: the configured SSL pem file or contents)\n The raw pem contents to use for the login procedure.\n\n @param [String] path (default: 'cert')\n The path to the auth backend to use for the login procedure.\n\n @return [Secret]", "Get the policy by the given name. If a policy does not exist by that name,\n +nil+ is returned.\n\n @example\n Vault.sys.policy(\"root\") #=> #\n\n @return [Policy, nil]", "Create a new policy with the given name and rules.\n\n @example\n policy = <<-EOH\n path \"sys\" {\n policy = \"deny\"\n }\n EOH\n Vault.sys.put_policy(\"dev\", policy) #=> true\n\n It is recommend that you load policy rules from a file:\n\n @example\n policy = File.read(\"/path/to/my/policy.hcl\")\n Vault.sys.put_policy(\"dev\", policy)\n\n @param [String] name\n the name of the policy\n @param [String] rules\n the policy rules\n\n @return [true]", "List all audits for the vault.\n\n @example\n Vault.sys.audits #=> { :file => # }\n\n @return [Hash]", "Generates a HMAC verifier for a given input.\n\n @example\n Vault.sys.audit_hash(\"file-audit\", \"my input\") #=> \"hmac-sha256:30aa7de18a5e90bbc1063db91e7c387b32b9fa895977eb8c177bbc91e7d7c542\"\n\n @param [String] path\n the path of the audit backend\n @param [String] input\n the input to generate a HMAC for\n\n @return [String]", "Lists all token accessors.\n\n @example Listing token accessors\n result = Vault.auth_token.accessors #=> #\n result.data[:keys] #=> [\"476ea048-ded5-4d07-eeea-938c6b4e43ec\", \"bb00c093-b7d3-b0e9-69cc-c4d85081165b\"]\n\n @return [Array]", "Create an authentication token. Note that the parameters specified below\n are not validated and passed directly to the Vault server. Depending on\n the version of Vault in operation, some of these options may not work, and\n newer options may be available that are not listed here.\n\n @example Creating a token\n Vault.auth_token.create #=> #\n\n @example Creating a token assigned to policies with a wrap TTL\n Vault.auth_token.create(\n policies: [\"myapp\"],\n wrap_ttl: 500,\n )\n\n @param [Hash] options\n @option options [String] :id\n The ID of the client token - this can only be specified for root tokens\n @option options [Array] :policies\n List of policies to apply to the token\n @option options [Fixnum, String] :wrap_ttl\n The number of seconds or a golang-formatted timestamp like \"5s\" or \"10m\"\n for the TTL on the wrapped response\n @option options [Hash] :meta\n A map of metadata that is passed to audit backends\n @option options [Boolean] :no_parent\n Create a token without a parent - see also {#create_orphan}\n @option options [Boolean] :no_default_policy\n Create a token without the default policy attached\n @option options [Boolean] :renewable\n Set whether this token is renewable or not\n @option options [String] :display_name\n Name of the token\n @option options [Fixnum] :num_uses\n Maximum number of uses for the token\n\n @return [Secret]", "Create an orphaned authentication token.\n\n @example\n Vault.auth_token.create_with_role(\"developer\") #=> #\n\n @param [Hash] options\n\n @return [Secret]", "Lookup information about the current token.\n\n @example\n Vault.auth_token.lookup(\"abcd-...\") #=> #\n\n @param [String] token\n @param [Hash] options\n\n @return [Secret]", "Lookup information about the given token accessor.\n\n @example\n Vault.auth_token.lookup_accessor(\"acbd-...\") #=> #\n\n @param [String] accessor\n @param [Hash] options", "Renew the given authentication token.\n\n @example\n Vault.auth_token.renew(\"abcd-1234\") #=> #\n\n @param [String] token\n the auth token\n @param [Fixnum] increment\n\n @return [Secret]", "Renews a lease associated with the calling token.\n\n @example\n Vault.auth_token.renew_self #=> #\n\n @param [Fixnum] increment\n\n @return [Secret]", "Create a new Client with the given options. Any options given take\n precedence over the default options.\n\n @return [Vault::Client]", "Perform a LIST request.\n @see Client#request", "Renew a lease with the given ID.\n\n @example\n Vault.sys.renew(\"aws/username\") #=> #\n\n @param [String] id\n the lease ID\n @param [Fixnum] increment\n\n @return [Secret]", "Create a hash-bashed representation of this response.\n\n @return [Hash]", "Initialize a new vault.\n\n @example\n Vault.sys.init #=> #\n\n @param [Hash] options\n the list of init options\n\n @option options [String] :root_token_pgp_key\n optional base64-encoded PGP public key used to encrypt the initial root\n token.\n @option options [Fixnum] :secret_shares\n the number of shares\n @option options [Fixnum] :secret_threshold\n the number of keys needed to unlock\n @option options [Array] :pgp_keys\n an optional Array of base64-encoded PGP public keys to encrypt sharees\n @option options [Fixnum] :stored_shares\n the number of shares that should be encrypted by the HSM for\n auto-unsealing\n @option options [Fixnum] :recovery_shares\n the number of shares to split the recovery key into\n @option options [Fixnum] :recovery_threshold\n the number of shares required to reconstruct the recovery key\n @option options [Array] :recovery_pgp_keys\n an array of PGP public keys used to encrypt the output for the recovery\n keys\n\n @return [InitResponse]", "Creates a new AppRole or update an existing AppRole with the given name\n and attributes.\n\n @example\n Vault.approle.set_role(\"testrole\", {\n secret_id_ttl: \"10m\",\n token_ttl: \"20m\",\n policies: \"default\",\n period: 3600,\n }) #=> true\n\n @param [String] name\n The name of the AppRole\n @param [Hash] options\n @option options [Boolean] :bind_secret_id\n Require secret_id to be presented when logging in using this AppRole.\n @option options [String] :bound_cidr_list\n Comma-separated list of CIDR blocks. Specifies blocks of IP addresses\n which can perform the login operation.\n @option options [String] :policies\n Comma-separated list of policies set on tokens issued via this AppRole.\n @option options [String] :secret_id_num_uses\n Number of times any particular SecretID can be used to fetch a token\n from this AppRole, after which the SecretID will expire.\n @option options [Fixnum, String] :secret_id_ttl\n The number of seconds or a golang-formatted timestamp like \"60m\" after\n which any SecretID expires.\n @option options [Fixnum, String] :token_ttl\n The number of seconds or a golang-formatted timestamp like \"60m\" to set\n as the TTL for issued tokens and at renewal time.\n @option options [Fixnum, String] :token_max_ttl\n The number of seconds or a golang-formatted timestamp like \"60m\" after\n which the issued token can no longer be renewed.\n @option options [Fixnum, String] :period\n The number of seconds or a golang-formatted timestamp like \"60m\".\n If set, the token generated using this AppRole is a periodic token.\n So long as it is renewed it never expires, but the TTL set on the token\n at each renewal is fixed to the value specified here. If this value is\n modified, the token will pick up the new value at its next renewal.\n\n @return [true]", "Gets the AppRole by the given name. If an AppRole does not exist by that\n name, +nil+ is returned.\n\n @example\n Vault.approle.role(\"testrole\") #=> #\n\n @return [Secret, nil]", "Reads the RoleID of an existing AppRole. If an AppRole does not exist by\n that name, +nil+ is returned.\n\n @example\n Vault.approle.role_id(\"testrole\") #=> #\n\n @return [Secret, nil]", "Updates the RoleID of an existing AppRole to a custom value.\n\n @example\n Vault.approle.set_role_id(\"testrole\") #=> true\n\n @return [true]", "Generates and issues a new SecretID on an existing AppRole.\n\n @example Generate a new SecretID\n result = Vault.approle.create_secret_id(\"testrole\") #=> #\n result.data[:secret_id] #=> \"841771dc-11c9-bbc7-bcac-6a3945a69cd9\"\n\n @example Assign a custom SecretID\n result = Vault.approle.create_secret_id(\"testrole\", {\n secret_id: \"testsecretid\"\n }) #=> #\n result.data[:secret_id] #=> \"testsecretid\"\n\n @param [String] role_name\n The name of the AppRole\n @param [Hash] options\n @option options [String] :secret_id\n SecretID to be attached to the Role. If not set, then the new SecretID\n will be generated\n @option options [Hash] :metadata\n Metadata to be tied to the SecretID. This should be a JSON-formatted\n string containing the metadata in key-value pairs. It will be set on\n tokens issued with this SecretID, and is logged in audit logs in\n plaintext.\n\n @return [true]", "Reads out the properties of a SecretID assigned to an AppRole.\n If the specified SecretID don't exist, +nil+ is returned.\n\n @example\n Vault.approle.role(\"testrole\", \"841771dc-11c9-...\") #=> #\n\n @param [String] role_name\n The name of the AppRole\n @param [String] secret_id\n SecretID belonging to AppRole\n\n @return [Secret, nil]", "Lists the accessors of all the SecretIDs issued against the AppRole.\n This includes the accessors for \"custom\" SecretIDs as well. If there are\n no SecretIDs against this role, an empty array will be returned.\n\n @example\n Vault.approle.secret_ids(\"testrole\") #=> [\"ce102d2a-...\", \"a1c8dee4-...\"]\n\n @return [Array]", "Encodes a string according to the rules for URL paths. This is\n used as opposed to CGI.escape because in a URL path, space\n needs to be escaped as %20 and CGI.escapes a space as +.\n\n @param [String]\n\n @return [String]", "List all mounts in the vault.\n\n @example\n Vault.sys.mounts #=> { :secret => # }\n\n @return [Hash]", "Tune a mount at the given path.\n\n @example\n Vault.sys.mount_tune(\"pki\", max_lease_ttl: '87600h') #=> true\n\n @param [String] path\n the path to write\n @param [Hash] data\n the data to write", "Change the name of the mount\n\n @example\n Vault.sys.remount(\"pg\", \"postgres\") #=> true\n\n @param [String] from\n the origin mount path\n @param [String] to\n the new mount path\n\n @return [true]", "Returns the full path to the output directory using SimpleCov.root\n and SimpleCov.coverage_dir, so you can adjust this by configuring those\n values. Will create the directory if it's missing", "Gets or sets the behavior to process coverage results.\n\n By default, it will call SimpleCov.result.format!\n\n Configure with:\n\n SimpleCov.at_exit do\n puts \"Coverage done\"\n SimpleCov.result.format!\n end", "Returns the project name - currently assuming the last dirname in\n the SimpleCov.root is this.", "The actual filter processor. Not meant for direct use", "Merges two Coverage.result hashes", "Applies the profile of given name on SimpleCov.configure", "Build link to the documentation about the given subject for the current\n version of Reek. The subject can be either a smell type like\n 'FeatureEnvy' or a general subject like 'Rake Task'.\n\n @param subject [String]\n @return [String] the full URL for the relevant documentation", "Attempts to load pre-generated code returning true if it succeeds.", "Registers C type-casts +r2c+ and +c2r+ for +type+.", "Adds a C function to the source, including performing automatic\n type conversion to arguments and the return value. The Ruby\n method name can be overridden by providing method_name. Unknown\n type conversions can be extended by using +add_type_converter+.", "Same as +c+, but adds a class function.", "Same as +c_raw+, but adds a class function.", "Checks the target source code for instances of \"smell type\"\n and returns true only if it can find one of them that matches.\n\n You can pass the smell type you want to check for as String or as Symbol:\n\n - :UtilityFunction\n - \"UtilityFunction\"\n\n It is recommended to pass this as a symbol like :UtilityFunction. However we don't\n enforce this.\n\n Additionally you can be more specific and pass in \"smell_details\" you\n want to check for as well e.g. \"name\" or \"count\" (see the examples below).\n The parameters you can check for are depending on the smell you are checking for.\n For instance \"count\" doesn't make sense everywhere whereas \"name\" does in most cases.\n If you pass in a parameter that doesn't exist (e.g. you make a typo like \"namme\") Reek will\n raise an ArgumentError to give you a hint that you passed something that doesn't make\n much sense.\n\n @param smell_type [Symbol, String] The \"smell type\" to check for.\n @param smell_details [Hash] A hash containing \"smell warning\" parameters\n\n @example Without smell_details\n\n reek_of(:FeatureEnvy)\n reek_of(:UtilityFunction)\n\n @example With smell_details\n\n reek_of(:UncommunicativeParameterName, name: 'x2')\n reek_of(:DataClump, count: 3)\n\n @example From a real spec\n\n expect(src).to reek_of(:DuplicateMethodCall, name: '@other.thing')\n\n @public\n\n @quality :reek:UtilityFunction", "See the documentaton for \"reek_of\".\n\n Notable differences to reek_of:\n 1.) \"reek_of\" doesn't mind if there are other smells of a different type.\n \"reek_only_of\" will fail in that case.\n 2.) \"reek_only_of\" doesn't support the additional smell_details hash.\n\n @param smell_type [Symbol, String] The \"smell type\" to check for.\n\n @public\n\n @quality :reek:UtilityFunction", "Processes the given AST, memoizes it and returns a tree of nested\n contexts.\n\n For example this ruby code:\n\n class Car; def drive; end; end\n\n would get compiled into this AST:\n\n (class\n (const nil :Car) nil\n (def :drive\n (args) nil))\n\n Processing this AST would result in a context tree where each node\n contains the outer context, the AST and the child contexts. The top\n node is always Reek::Context::RootContext. Using the example above,\n the tree would look like this:\n\n RootContext -> children: 1 ModuleContext -> children: 1 MethodContext\n\n @return [Reek::Context::RootContext] tree of nested contexts", "Handles every node for which we have no context_processor.", "Handles `def` nodes.\n\n An input example that would trigger this method would be:\n\n def call_me; foo = 2; bar = 5; end\n\n Given the above example we would count 2 statements overall.", "Handles `send` nodes a.k.a. method calls.\n\n An input example that would trigger this method would be:\n\n call_me()\n\n Besides checking if it's a visibility modifier or an attribute writer\n we also record to what the method call is referring to\n which we later use for smell detectors like FeatureEnvy.", "Handles `if` nodes.\n\n An input example that would trigger this method would be:\n\n if a > 5 && b < 3\n puts 'bingo'\n else\n 3\n end\n\n Counts the `if` body as one statement and the `else` body as another statement.\n\n At the end we subtract one statement because the surrounding context was already counted\n as one (e.g. via `process_def`).\n\n `children[1]` refers to the `if` body (so `puts 'bingo'` from above) and\n `children[2]` to the `else` body (so `3` from above), which might be nil.", "Handles `rescue` nodes.\n\n An input example that would trigger this method would be:\n\n def simple\n raise ArgumentError, 'raising...'\n rescue => e\n puts 'rescued!'\n end\n\n Counts everything before the `rescue` body as one statement.\n\n At the end we subtract one statement because the surrounding context was already counted\n as one (e.g. via `process_def`).\n\n `exp.children.first` below refers to everything before the actual `rescue`\n which would be the\n\n raise ArgumentError, 'raising...'\n\n in the example above.\n `exp` would be the whole method body wrapped under a `rescue` node.\n See `process_resbody` for additional reference.", "Stores a reference to the current context, creates a nested new one,\n yields to the given block and then restores the previous context.\n\n @param klass [Context::*Context] context class\n @param args arguments for the class initializer\n @yield block", "Appends a new child context to the current context but does not change\n the current context.\n\n @param klass [Context::*Context] context class\n @param args arguments for the class initializer\n\n @return [Context::*Context] the context that was appended", "Retrieves the value, if any, for the given +key+ in the given +context+.\n\n Raises an error if neither the context nor this config have a value for\n the key.", "Find any overrides that match the supplied context", "Recursively enhance an AST with type-dependent mixins, and comments.\n\n See {file:docs/How-reek-works-internally.md} for the big picture of how this works.\n Example:\n This\n class Klazz; def meth(argument); argument.call_me; end; end\n corresponds to this sexp:\n (class\n (const nil :Klazz) nil\n (def :meth\n (args\n (arg :argument))\n (send\n (lvar :argument) :call_me)))\n where every node is of type Parser::AST::Node.\n Passing this into `dress` will return the exact same structure, but this\n time the nodes will contain type-dependent mixins, e.g. this:\n (const nil :Klazz)\n will be of type Reek::AST::Node with Reek::AST::SexpExtensions::ConstNode mixed in.\n\n @param sexp [Parser::AST::Node] the given sexp\n @param comment_map [Hash] see the documentation for SourceCode#syntax_tree\n\n @return an instance of Reek::AST::Node with type-dependent sexp extensions mixed in.\n\n @quality :reek:FeatureEnvy\n @quality :reek:TooManyStatements { max_statements: 6 }", "append_record_to_messages adds a record to the bulk message\n payload to be submitted to Elasticsearch. Records that do\n not include '_id' field are skipped when 'write_operation'\n is configured for 'create' or 'update'\n\n returns 'true' if record was appended to the bulk message\n and 'false' otherwise", "send_bulk given a specific bulk request, the original tag,\n chunk, and bulk_message_count", "Adds the given responders to the current controller's responder, allowing you to cherry-pick\n which responders you want per controller.\n\n class InvitationsController < ApplicationController\n responders :flash, :http_cache\n end\n\n Takes symbols and strings and translates them to VariableResponder (eg. :flash becomes FlashResponder).\n Also allows passing in the responders modules in directly, so you could do:\n\n responders FlashResponder, HttpCacheResponder\n\n Or a mix of both methods:\n\n responders :flash, MyCustomResponder", "For a given controller action, respond_with generates an appropriate\n response based on the mime-type requested by the client.\n\n If the method is called with just a resource, as in this example -\n\n class PeopleController < ApplicationController\n respond_to :html, :xml, :json\n\n def index\n @people = Person.all\n respond_with @people\n end\n end\n\n then the mime-type of the response is typically selected based on the\n request's Accept header and the set of available formats declared\n by previous calls to the controller's class method +respond_to+. Alternatively\n the mime-type can be selected by explicitly setting request.format in\n the controller.\n\n If an acceptable format is not identified, the application returns a\n '406 - not acceptable' status. Otherwise, the default response is to render\n a template named after the current action and the selected format,\n e.g. index.html.erb . If no template is available, the behavior\n depends on the selected format:\n\n * for an html response - if the request method is +get+, an exception\n is raised but for other requests such as +post+ the response\n depends on whether the resource has any validation errors (i.e.\n assuming that an attempt has been made to save the resource,\n e.g. by a +create+ action) -\n 1. If there are no errors, i.e. the resource\n was saved successfully, the response +redirect+'s to the resource\n i.e. its +show+ action.\n 2. If there are validation errors, the response\n renders a default action, which is :new for a\n +post+ request or :edit for +patch+ or +put+.\n Thus an example like this -\n\n respond_to :html, :xml\n\n def create\n @user = User.new(params[:user])\n flash[:notice] = 'User was successfully created.' if @user.save\n respond_with(@user)\n end\n\n is equivalent, in the absence of create.html.erb , to -\n\n def create\n @user = User.new(params[:user])\n respond_to do |format|\n if @user.save\n flash[:notice] = 'User was successfully created.'\n format.html { redirect_to(@user) }\n format.xml { render xml: @user }\n else\n format.html { render action: \"new\" }\n format.xml { render xml: @user }\n end\n end\n end\n\n * for a JavaScript request - if the template isn't found, an exception is\n raised.\n * for other requests - i.e. data formats such as xml, json, csv etc, if\n the resource passed to +respond_with+ responds to to_
,\n the method attempts to render the resource in the requested format\n directly, e.g. for an xml request, the response is equivalent to calling\n render xml: resource
.\n\n === Nested resources\n\n As outlined above, the +resources+ argument passed to +respond_with+\n can play two roles. It can be used to generate the redirect url\n for successful html requests (e.g. for +create+ actions when\n no template exists), while for formats other than html and JavaScript\n it is the object that gets rendered, by being converted directly to the\n required format (again assuming no template exists).\n\n For redirecting successful html requests, +respond_with+ also supports\n the use of nested resources, which are supplied in the same way as\n in form_for
and polymorphic_url
. For example -\n\n def create\n @project = Project.find(params[:project_id])\n @task = @project.comments.build(params[:task])\n flash[:notice] = 'Task was successfully created.' if @task.save\n respond_with(@project, @task)\n end\n\n This would cause +respond_with+ to redirect to project_task_url
\n instead of task_url
. For request formats other than html or\n JavaScript, if multiple resources are passed in this way, it is the last\n one specified that is rendered.\n\n === Customizing response behavior\n\n Like +respond_to+, +respond_with+ may also be called with a block that\n can be used to overwrite any of the default responses, e.g. -\n\n def create\n @user = User.new(params[:user])\n flash[:notice] = \"User was successfully created.\" if @user.save\n\n respond_with(@user) do |format|\n format.html { render }\n end\n end\n\n The argument passed to the block is an ActionController::MimeResponds::Collector\n object which stores the responses for the formats defined within the\n block. Note that formats with responses defined explicitly in this way\n do not have to first be declared using the class method +respond_to+.\n\n Also, a hash passed to +respond_with+ immediately after the specified\n resource(s) is interpreted as a set of options relevant to all\n formats. Any option accepted by +render+ can be used, e.g.\n\n respond_with @people, status: 200\n\n However, note that these options are ignored after an unsuccessful attempt\n to save a resource, e.g. when automatically rendering :new \n after a post request.\n\n Three additional options are relevant specifically to +respond_with+ -\n 1. :location - overwrites the default redirect location used after\n a successful html +post+ request.\n 2. :action - overwrites the default render action used after an\n unsuccessful html +post+ request.\n 3. :render - allows to pass any options directly to the :render \n call after unsuccessful html +post+ request. Usefull if for example you\n need to render a template which is outside of controller's path or you\n want to override the default http :status code, e.g.\n\n respond_with(resource, render: { template: 'path/to/template', status: 422 })", "Collect mimes declared in the class method respond_to valid for the\n current action.", "reindex whole database using a extra temporary index + move operation", "special handling of get_settings to avoid raising errors on 404", "Defines attr accessors for each available_filter on self and assigns\n values based on fp.\n @param fp [Hash] filterrific_params with stringified keys", "Computes filterrific params using a number of strategies. Limits params\n to 'available_filters' if given via opts.\n @param model_class [ActiveRecord::Base]\n @param filterrific_params [ActionController::Params, Hash]\n @param opts [Hash]\n @option opts [Boolean, optional] \"sanitize_params\"\n if true, sanitizes all filterrific params to prevent reflected (or stored) XSS attacks.\n Defaults to true.\n @param persistence_id [String, nil]", "Sets all options on form_for to defaults that work with Filterrific\n @param record [Filterrific] the @filterrific object\n @param options [Hash] standard options for form_for\n @param block [Proc] the form body", "Renders HTML to reverse sort order on currently sorted column.\n @param filterrific [Filterrific::ParamSet]\n @param new_sort_key [String]\n @param opts [Hash]\n @return [String] an HTML fragment", "explicit hash, to get symbols in hash keys", "Executes a task on a specific VM.\n\n @param vm [Vagrant::VM]\n @param options [Hash] Parsed options from the command line", "shows a link that will allow to dynamically add a new associated object.\n\n - *name* : the text to show in the link\n - *f* : the form this should come in (the formtastic form)\n - *association* : the associated objects, e.g. :tasks, this should be the name of the has_many relation.\n - *html_options*: html options to be passed to link_to (see link_to )\n - *:render_options* : options passed to `simple_fields_for, semantic_fields_for or fields_for`\n - *:locals* : the locals hash in the :render_options is handed to the partial\n - *:partial* : explicitly override the default partial name\n - *:wrap_object* : a proc that will allow to wrap your object, especially suited when using\n decorators, or if you want special initialisation\n - *:form_name* : the parameter for the form in the nested form partial. Default `f`.\n - *:count* : Count of how many objects will be added on a single click. Default `1`.\n - *&block*: see link_to ", "Capture and process any exceptions from the given block.\n\n @example\n Raven.capture do\n MyApp.run\n end", "Provides extra context to the exception prior to it being handled by\n Raven. An exception can have multiple annotations, which are merged\n together.\n\n The options (annotation) is treated the same as the ``options``\n parameter to ``capture_exception`` or ``Event.from_exception``, and\n can contain the same ``:user``, ``:tags``, etc. options as these\n methods.\n\n These will be merged with the ``options`` parameter to\n ``Event.from_exception`` at the top of execution.\n\n @example\n begin\n raise \"Hello\"\n rescue => exc\n Raven.annotate_exception(exc, :user => { 'id' => 1,\n 'email' => 'foo@example.com' })\n end", "Once an ActiveJob is queued, ActiveRecord references get serialized into\n some internal reserved keys, such as _aj_globalid.\n\n The problem is, if this job in turn gets queued back into ActiveJob with\n these magic reserved keys, ActiveJob will throw up and error. We want to\n capture these and mutate the keys so we can sanely report it.", "run all plugins or those that match the attribute filter is provided\n\n @param safe [Boolean]\n @param [Array] attribute_filter the attributes to run. All will be run if not specified\n\n @return [Mash]", "Pretty Print this object as JSON", "gather plugins providing exactly the attributes listed", "This function is used to fetch the plugins for the attributes specified\n in the CLI options to Ohai.\n It first attempts to find the plugins for the attributes\n or the sub attributes given.\n If it can't find any, it looks for plugins that might\n provide the parents of a given attribute and returns the\n first parent found.", "This function is used to fetch the plugins from\n 'depends \"languages\"' statements in plugins.\n It gathers plugins providing each of the attributes listed, or the\n plugins providing the closest parent attribute", "Takes a section of the map, recursively searches for a `_plugins` key\n to find all the plugins in that section of the map. If given the whole\n map, it will find all of the plugins that have at least one provided\n attribute.", "Searches all plugin paths and returns an Array of file paths to plugins\n\n @param dir [Array, String] directory/directories to load plugins from\n @return [Array]", "load additional plugins classes from a given directory\n @param from [String] path to a directory with additional plugins to load", "Load a specified file as an ohai plugin and creates an instance of it.\n Not used by ohai itself, but is used in the specs to load plugins for testing\n\n @private\n @param plugin_path [String]", "Given a list of plugins and the first plugin in the cycle,\n returns the list of plugin source files responsible for the\n cycle. Does not include plugins that aren't a part of the cycle", "A point is inside a triangle if the area of 3 triangles, constructed from\n triangle sides and the given point, is equal to the area of triangle.", "Play an animation", "Set the position of the clipping retangle based on the current frame", "Calculate the distance between two points", "Set a window attribute", "Add an object to the window", "Remove an object from the window", "Set an event handler", "Key callback method, called by the native and web extentions", "Mouse callback method, called by the native and web extentions", "Controller callback method, called by the native and web extentions", "Update callback method, called by the native and web extentions", "An an object to the window, used by the public `add` method", "Create a new database view.\n\n @param name [String, Symbol] The name of the database view.\n @param version [Fixnum] The version number of the view, used to find the\n definition file in `db/views`. This defaults to `1` if not provided.\n @param sql_definition [String] The SQL query for the view schema. An error\n will be raised if `sql_definition` and `version` are both set,\n as they are mutually exclusive.\n @param materialized [Boolean, Hash] Set to true to create a materialized\n view. Set to { no_data: true } to create materialized view without\n loading data. Defaults to false.\n @return The database response from executing the create statement.\n\n @example Create from `db/views/searches_v02.sql`\n create_view(:searches, version: 2)\n\n @example Create from provided SQL string\n create_view(:active_users, sql_definition: <<-SQL)\n SELECT * FROM users WHERE users.active = 't'\n SQL", "Drop a database view by name.\n\n @param name [String, Symbol] The name of the database view.\n @param revert_to_version [Fixnum] Used to reverse the `drop_view` command\n on `rake db:rollback`. The provided version will be passed as the\n `version` argument to {#create_view}.\n @param materialized [Boolean] Set to true if dropping a meterialized view.\n defaults to false.\n @return The database response from executing the drop statement.\n\n @example Drop a view, rolling back to version 3 on rollback\n drop_view(:users_who_recently_logged_in, revert_to_version: 3)", "Update a database view to a new version.\n\n The existing view is dropped and recreated using the supplied `version`\n parameter.\n\n @param name [String, Symbol] The name of the database view.\n @param version [Fixnum] The version number of the view.\n @param sql_definition [String] The SQL query for the view schema. An error\n will be raised if `sql_definition` and `version` are both set,\n as they are mutually exclusive.\n @param revert_to_version [Fixnum] The version number to rollback to on\n `rake db rollback`\n @param materialized [Boolean, Hash] True if updating a materialized view.\n Set to { no_data: true } to update materialized view without loading\n data. Defaults to false.\n @return The database response from executing the create statement.\n\n @example\n update_view :engagement_reports, version: 3, revert_to_version: 2", "Update a database view to a new version using `CREATE OR REPLACE VIEW`.\n\n The existing view is replaced using the supplied `version`\n parameter.\n\n Does not work with materialized views due to lack of database support.\n\n @param name [String, Symbol] The name of the database view.\n @param version [Fixnum] The version number of the view.\n @param revert_to_version [Fixnum] The version number to rollback to on\n `rake db rollback`\n @return The database response from executing the create statement.\n\n @example\n replace_view :engagement_reports, version: 3, revert_to_version: 2", "Returns a hash representation of the event.\n\n Metadata is converted to hash as well\n\n @return [Hash] with :event_id, :metadata, :data, :type keys", "Persists events and notifies subscribed handlers about them\n\n @param events [Array, Event, Proto] event(s)\n @param stream_name [String] name of the stream for persisting events.\n @param expected_version [:any, :auto, :none, Integer] controls optimistic locking strategy. {http://railseventstore.org/docs/expected_version/ Read more}\n @return [self]", "merges the hash of headers into the current header set.", "disable Secure cookies for non-https requests", "when configuring with booleans, only one enforcement is permitted", "validate exclusive use of only or except but not both at the same time", "validate exclusivity of only and except members within strict and lax", "Discard any 'none' values if more directives are supplied since none may override values.", "Removes duplicates and sources that already match an existing wild card.\n\n e.g. *.github.com asdf.github.com becomes *.github.com", "Invisible reCAPTCHA implementation", "Your private API can be specified in the +options+ hash or preferably\n using the Configuration.", "Compares this configuration with another.\n\n @param other [HamlLint::Configuration]\n @return [true,false] whether the given configuration is equivalent\n Returns a non-modifiable configuration for the specified linter.\n\n @param linter [HamlLint::Linter,Class]", "Merge two hashes such that nested hashes are merged rather than replaced.\n\n @param parent [Hash]\n @param child [Hash]\n @return [Hash]", "Prints the standard progress reporter output and writes the new config file.\n\n @param report [HamlLint::Report]\n @return [void]", "Prints the standard progress report marks and tracks files with lint.\n\n @param file [String]\n @param lints [Array]\n @return [void]", "The contents of the generated configuration file based on captured lint.\n\n @return [String] a Yaml-formatted configuration file's contents", "Constructs the configuration for excluding a linter in some files.\n\n @param linter [String] the name of the linter to exclude\n @param files [Array] the files in which the linter is excluded\n @return [String] a Yaml-formatted configuration", "Returns the class of the specified Reporter.\n\n @param reporter_name [String]\n @raise [HamlLint::Exceptions::InvalidCLIOption] if reporter doesn't exist\n @return [Class]", "Enables the linter if the tree is for the right file type.\n\n @param [HamlLint::Tree::RootNode] the root of a syntax tree\n @return [true, false] whether the linter is enabled for the tree", "Checks for instance variables in tag nodes when the linter is enabled.\n\n @param [HamlLint::Tree:TagNode]\n @return [void]", "Runs the appropriate linters against the desired files given the specified\n options.\n\n @param [Hash] options\n @option options :config_file [String] path of configuration file to load\n @option options :config [HamlLint::Configuration] configuration to use\n @option options :excluded_files [Array]\n @option options :included_linters [Array]\n @option options :excluded_linters [Array]\n @option options :fail_fast [true, false] flag for failing after first failure\n @option options :fail_level\n @option options :reporter [HamlLint::Reporter]\n @return [HamlLint::Report] a summary of all lints found", "Runs all provided linters using the specified config against the given\n file.\n\n @param file [String] path to file to lint\n @param linter_selector [HamlLint::LinterSelector]\n @param config [HamlLint::Configuration]", "Returns the list of files that should be linted given the specified\n configuration and options.\n\n @param config [HamlLint::Configuration]\n @param options [Hash]\n @return [Array]", "Process the files and add them to the given report.\n\n @param report [HamlLint::Report]\n @return [void]", "Process a file and add it to the given report.\n\n @param file [String] the name of the file to process\n @param report [HamlLint::Report]\n @return [void]", "Generates a report based on the given options.\n\n @param options [Hash]\n @option options :reporter [HamlLint::Reporter] the reporter to report with\n @return [HamlLint::Report]", "Create a file finder using the specified configuration.\n\n @param config [HamlLint::Configuration]\n Return list of files to lint given the specified set of paths and glob\n patterns.\n @param patterns [Array]\n @param excluded_patterns [Array]\n @raise [HamlLint::Exceptions::InvalidFilePath]\n @return [Array] list of actual files", "Extract the list of matching files given the list of glob patterns, file\n paths, and directories.\n\n @param patterns [Array]\n @return [Array]", "Whether the given file should be treated as a Haml file.\n\n @param file [String]\n @return [Boolean]", "Returns whether a string starts with a character that would otherwise be\n given special treatment, thus making enclosing it in a string necessary.", "Initializes a linter with the specified configuration.\n\n @param config [Hash] configuration for this linter\n Runs the linter against the given Haml document.\n\n @param document [HamlLint::Document]", "Returns whether the inline content for a node is a string.\n\n For example, the following node has a literal string:\n\n %tag= \"A literal #{string}\"\n\n whereas this one does not:\n\n %tag A literal #{string}\n\n @param node [HamlLint::Tree::Node]\n @return [true,false]", "Get the inline content for this node.\n\n Inline content is the content that appears inline right after the\n tag/script. For example, in the code below...\n\n %tag Some inline content\n\n ...\"Some inline content\" would be the inline content.\n\n @param node [HamlLint::Tree::Node]\n @return [String]", "Gets the next node following this node, ascending up the ancestor chain\n recursively if this node has no siblings.\n\n @param node [HamlLint::Tree::Node]\n @return [HamlLint::Tree::Node,nil]", "Creates a reusable parser.\n Parse the given Ruby source into an abstract syntax tree.\n\n @param source [String] Ruby source code\n @return [Array] syntax tree in the form returned by Parser gem", "Given the provided options, execute the appropriate command.\n\n @return [Integer] exit status code", "Given the provided options, configure the logger.\n\n @return [void]", "Outputs a message and returns an appropriate error code for the specified\n exception.", "Instantiates a new reporter based on the options.\n\n @param options [HamlLint::Configuration]\n @option options [true, nil] :auto_gen_config whether to use the config\n generating reporter\n @option options [Class] :reporter the class of reporter to use\n @return [HamlLint::Reporter]", "Scans the files specified by the given options for lints.\n\n @return [Integer] exit status code", "Outputs a list of all currently available linters.", "Outputs a list of currently available reporters.", "Outputs the application name and version.", "Outputs the backtrace of an exception with instructions on how to report\n the issue.", "Removes YAML frontmatter", "Checks whether a visitor is disabled due to comment configuration.\n\n @param [HamlLint::HamlVisitor]\n @return [true, false]", "Implements the Enumerable interface to walk through an entire tree.\n\n @return [Enumerator, HamlLint::Tree::Node]", "The line numbers that are contained within the node.\n\n @api public\n @return [Range]", "Discovers the end line of the node when there are no lines.\n\n @return [Integer] the end line of the node", "Gets the node of the syntax tree for a given line number.\n\n @param line [Integer] the line number of the node\n @return [HamlLint::Node]", "Returns a list of linters that are enabled given the specified\n configuration and additional options.\n\n @param config [HamlLint::Configuration]\n @param options [Hash]\n @return [Array]", "Whether to run the given linter against the specified file.\n\n @param config [HamlLint::Configuration]\n @param linter [HamlLint::Linter]\n @param file [String]\n @return [Boolean]", "Returns the source code for the static and dynamic attributes\n of a tag.\n\n @example For `%tag.class{ id: 'hello' }(lang=en)`, this returns:\n { :static => '.class', :hash => \" id: 'hello' \", :html => \"lang=en\" }\n\n @return [Hash]", "Executes RuboCop against the given Ruby code and records the offenses as\n lints.\n\n @param ruby [String] Ruby code\n @param source_map [Hash] map of Ruby code line numbers to original line\n numbers in the template", "Overrides the global stdin to allow RuboCop to read Ruby code from it.\n\n @param ruby [String] the Ruby code to write to the overridden stdin\n @param _block [Block] the block to perform with the overridden stdin\n @return [void]", "Returns an array of two items, the first being the absolute path, the second\n the relative path.\n\n The relative path is relative to the current working dir. The path passed can\n be either relative or absolute.\n\n @param path [String] Path to get absolute and relative path of\n @return [Array] Absolute and relative path", "Yields interpolated values within a block of text.\n\n @param text [String]\n @yield Passes interpolated code and line number that code appears on in\n the text.\n @yieldparam interpolated_code [String] code that was interpolated\n @yieldparam line [Integer] line number code appears on in text", "Find all consecutive items satisfying the given block of a minimum size,\n yielding each group of consecutive items to the provided block.\n\n @param items [Array]\n @param satisfies [Proc] function that takes an item and returns true/false\n @param min_consecutive [Fixnum] minimum number of consecutive items before\n yielding the group\n @yield Passes list of consecutive items all matching the criteria defined\n by the `satisfies` {Proc} to the provided block\n @yieldparam group [Array] List of consecutive items\n @yieldreturn [Boolean] block should return whether item matches criteria\n for inclusion", "Calls a block of code with a modified set of environment variables,\n restoring them once the code has executed.\n\n @param env [Hash] environment variables to set", "Executes the CLI given the specified task arguments.\n\n @param task_args [Rake::TaskArguments]", "Returns the list of files that should be linted given the specified task\n arguments.\n\n @param task_args [Rake::TaskArguments]", "Log setting or extension loading notices, sensitive information\n is redacted.\n\n @param notices [Array] to be logged.\n @param level [Symbol] to log the notices at.", "Set up Sensu spawn, creating a worker to create, control, and\n limit spawned child processes. This method adjusts the\n EventMachine thread pool size to accommodate the concurrent\n process spawn limit and other Sensu process operations.\n\n https://github.com/sensu/sensu-spawn", "Retry a code block until it retures true. The first attempt and\n following retries are delayed.\n\n @param wait [Numeric] time to delay block calls.\n @param block [Proc] to call that needs to return true.", "Deep merge two hashes. Nested hashes are deep merged, arrays are\n concatenated and duplicate array items are removed.\n\n @param hash_one [Hash]\n @param hash_two [Hash]\n @return [Hash] deep merged hash.", "Creates a deep dup of basic ruby objects with support for walking\n hashes and arrays.\n\n @param obj [Object]\n @return [obj] a dup of the original object.", "Retrieve the system IP address. If a valid non-loopback\n IPv4 address cannot be found and an error is thrown,\n `nil` will be returned.\n\n @return [String] system ip address", "Traverse a hash for an attribute value, with a fallback default\n value if nil.\n\n @param tree [Hash] to traverse.\n @param path [Array] of attribute keys.\n @param default [Object] value if attribute value is nil.\n @return [Object] attribute or fallback default value.", "Determine the next check cron time.\n\n @param check [Hash] definition.", "Execute the given block, and retry the current restartable transaction if a\n MySQL deadlock occurs.", "Get the current or historic balance of an account.\n\n @param account [DoubleEntry::Account:Instance]\n @option args :from [Time]\n @option args :to [Time]\n @option args :at [Time]\n @option args :code [Symbol]\n @option args :codes [Array]\n @return [Money]", "This method will populate all matched page TextFields,\n TextAreas, SelectLists, FileFields, Checkboxes, and Radio Buttons from the\n Hash passed as an argument. The way it find an element is by\n matching the Hash key to the name you provided when declaring\n the element on your page.\n\n Checkbox and Radio Button values must be true or false.\n\n @example\n class ExamplePage\n include PageObject\n\n text_field(:username, :id => 'username_id')\n checkbox(:active, :id => 'active_id')\n end\n\n ...\n\n @browser = Watir::Browser.new :firefox\n example_page = ExamplePage.new(@browser)\n example_page.populate_page_with :username => 'a name', :active => true\n\n @param data [Hash] the data to use to populate this page. The key\n can be either a string or a symbol. The value must be a string\n for TextField, TextArea, SelectList, and FileField and must be true or\n false for a Checkbox or RadioButton.", "Specify the url for the page. A call to this method will generate a\n 'goto' method to take you to the page.\n\n @param [String] the url for the page.\n @param [Symbol] a method name to call to get the url", "Identify an element as existing within a frame . A frame parameter\n is passed to the block and must be passed to the other calls to PageObject.\n You can nest calls to in_frame by passing the frame to the next level.\n\n @example\n in_frame(:id => 'frame_id') do |frame|\n text_field(:first_name, :id => 'fname', :frame => frame)\n end\n\n @param [Hash] identifier how we find the frame. The valid keys are:\n * :id\n * :index\n * :name\n * :regexp\n @param frame passed from a previous call to in_frame. Used to nest calls\n @param block that contains the calls to elements that exist inside the frame.", "Identify an element as existing within an iframe. A frame parameter\n is passed to the block and must be passed to the other calls to PageObject.\n You can nest calls to in_frame by passing the frame to the next level.\n\n @example\n in_iframe(:id => 'frame_id') do |frame|\n text_field(:first_name, :id => 'fname', :frame => frame)\n end\n\n @param [Hash] identifier how we find the frame. The valid keys are:\n * :id\n * :index\n * :name\n * :regexp\n @param frame passed from a previous call to in_iframe. Used to nest calls\n @param block that contains the calls to elements that exist inside the iframe.", "adds four methods to the page object - one to set text in a text field,\n another to retrieve text from a text field, another to return the text\n field element, another to check the text field's existence.\n\n @example\n text_field(:first_name, :id => \"first_name\")\n # will generate 'first_name', 'first_name=', 'first_name_element',\n # 'first_name?' methods\n\n @param [String] the name used for the generated methods\n @param [Hash] identifier how we find a text field.\n @param optional block to be invoked when element method is called", "adds three methods to the page object - one to get the text from a hidden field,\n another to retrieve the hidden field element, and another to check the hidden\n field's existence.\n\n @example\n hidden_field(:user_id, :id => \"user_identity\")\n # will generate 'user_id', 'user_id_element' and 'user_id?' methods\n\n @param [String] the name used for the generated methods\n @param [Hash] identifier how we find a hidden field.\n @param optional block to be invoked when element method is called", "adds four methods to the page object - one to set text in a text area,\n another to retrieve text from a text area, another to return the text\n area element, and another to check the text area's existence.\n\n @example\n text_area(:address, :id => \"address\")\n # will generate 'address', 'address=', 'address_element',\n # 'address?' methods\n\n @param [String] the name used for the generated methods\n @param [Hash] identifier how we find a text area.\n @param optional block to be invoked when element method is called", "adds five methods - one to select an item in a drop-down,\n another to fetch the currently selected item text, another\n to retrieve the select list element, another to check the\n drop down's existence and another to get all the available options\n to select from.\n\n @example\n select_list(:state, :id => \"state\")\n # will generate 'state', 'state=', 'state_element', 'state?', \"state_options\" methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a select list.\n @param optional block to be invoked when element method is called", "adds three methods - one to click a button, another to\n return the button element, and another to check the button's existence.\n\n @example\n button(:purchase, :id => 'purchase')\n # will generate 'purchase', 'purchase_element', and 'purchase?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a button.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text from a div,\n another to return the div element, and another to check the div's existence.\n\n @example\n div(:message, :id => 'message')\n # will generate 'message', 'message_element', and 'message?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a div.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text from a span,\n another to return the span element, and another to check the span's existence.\n\n @example\n span(:alert, :id => 'alert')\n # will generate 'alert', 'alert_element', and 'alert?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a span.\n @param optional block to be invoked when element method is called", "adds three methods - one to return the text for the table, one\n to retrieve the table element, and another to\n check the table's existence.\n\n @example\n table(:cart, :id => 'shopping_cart')\n # will generate a 'cart', 'cart_element' and 'cart?' method\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a table.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text from a table cell,\n another to return the table cell element, and another to check the cell's\n existence.\n\n @example\n cell(:total, :id => 'total_cell')\n # will generate 'total', 'total_element', and 'total?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a cell.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text from a table row,\n another to return the table row element, and another to check the row's\n existence.\n\n @example\n row(:sums, :id => 'sum_row')\n # will generate 'sums', 'sums_element', and 'sums?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a cell.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the image element, another to\n check the load status of the image, and another to check the\n image's existence.\n\n @example\n image(:logo, :id => 'logo')\n # will generate 'logo_element', 'logo_loaded?', and 'logo?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find an image.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text from a list item,\n another to return the list item element, and another to check the list item's\n existence.\n\n @example\n list_item(:item_one, :id => 'one')\n # will generate 'item_one', 'item_one_element', and 'item_one?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a list item.\n @param optional block to be invoked when element method is called", "adds three methods - one to return the text within the unordered\n list, one to retrieve the unordered list element, and another to\n check it's existence.\n\n @example\n unordered_list(:menu, :id => 'main_menu')\n # will generate 'menu', 'menu_element' and 'menu?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find an unordered list.\n @param optional block to be invoked when element method is called", "adds three methods - one to return the text within the ordered\n list, one to retrieve the ordered list element, and another to\n test it's existence.\n\n @example\n ordered_list(:top_five, :id => 'top')\n # will generate 'top_five', 'top_five_element' and 'top_five?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find an ordered list.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text of a h1 element, another to\n retrieve a h1 element, and another to check for it's existence.\n\n @example\n h1(:title, :id => 'title')\n # will generate 'title', 'title_element', and 'title?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a H1. You can use a multiple parameters\n by combining of any of the following except xpath.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text of a h2 element, another\n to retrieve a h2 element, and another to check for it's existence.\n\n @example\n h2(:title, :id => 'title')\n # will generate 'title', 'title_element', and 'title?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a H2.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text of a h3 element,\n another to return a h3 element, and another to check for it's existence.\n\n @example\n h3(:title, :id => 'title')\n # will generate 'title', 'title_element', and 'title?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a H3.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text of a h4 element,\n another to return a h4 element, and another to check for it's existence.\n\n @example\n h4(:title, :id => 'title')\n # will generate 'title', 'title_element', and 'title?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a H4.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text of a h5 element,\n another to return a h5 element, and another to check for it's existence.\n\n @example\n h5(:title, :id => 'title')\n # will generate 'title', 'title_element', and 'title?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a H5.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text of a h6 element,\n another to return a h6 element, and another to check for it's existence.\n\n @example\n h6(:title, :id => 'title')\n # will generate 'title', 'title_element', and 'title?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a H6.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text of a paragraph, another\n to retrieve a paragraph element, and another to check the paragraph's existence.\n\n @example\n paragraph(:title, :id => 'title')\n # will generate 'title', 'title_element', and 'title?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a paragraph.\n @param optional block to be invoked when element method is called", "adds three methods - one to set the file for a file field, another to retrieve\n the file field element, and another to check it's existence.\n\n @example\n file_field(:the_file, :id => 'file_to_upload')\n # will generate 'the_file=', 'the_file_element', and 'the_file?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a file_field.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text from a label,\n another to return the label element, and another to check the label's existence.\n\n @example\n label(:message, :id => 'message')\n # will generate 'message', 'message_element', and 'message?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a label.\n @param optional block to be invoked when element method is called", "adds three methods - one to click the area,\n another to return the area element, and another to check the area's existence.\n\n @example\n area(:message, :id => 'message')\n # will generate 'message', 'message_element', and 'message?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find an area.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text of a b element, another to\n retrieve a b element, and another to check for it's existence.\n\n @example\n b(:bold, :id => 'title')\n # will generate 'bold', 'bold_element', and 'bold?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a b.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text of a i element, another to\n retrieve a i element, and another to check for it's existence.\n\n @example\n i(:italic, :id => 'title')\n # will generate 'italic', 'italic_element', and 'italic?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Hash] identifier how we find a i.\n @param optional block to be invoked when element method is called", "adds three methods - one to retrieve the text of an element, another\n to retrieve an element, and another to check the element's existence.\n\n @example\n element(:title, :header, :id => 'title')\n # will generate 'title', 'title_element', and 'title?' methods\n\n @param [Symbol] the name used for the generated methods\n @param [Symbol] the name of the tag for the element\n @param [Hash] identifier how we find an element.\n @param optional block to be invoked when element method is called", "adds a method to return a collection of generic Element objects\n for a specific tag.\n\n @example\n elements(:title, :header, :id => 'title')\n # will generate ''title_elements'\n\n @param [Symbol] the name used for the generated methods\n @param [Symbol] the name of the tag for the element\n @param [Hash] identifier how we find an element.\n @param optional block to be invoked when element method is called", "adds a method to return a page object rooted at an element\n\n @example\n page_section(:navigation_bar, NavigationBar, :id => 'nav-bar')\n # will generate 'navigation_bar'\n\n @param [Symbol] the name used for the generated methods\n @param [Class] the class to instantiate for the element\n @param [Hash] identifier how we find an element.", "adds a method to return a collection of page objects rooted at elements\n\n @example\n page_sections(:articles, Article, :class => 'article')\n # will generate 'articles'\n\n @param [Symbol] the name used for the generated method\n @param [Class] the class to instantiate for each element\n @param [Hash] identifier how we find an element.", "Create a page object.\n\n @param [PageObject, String] a class that has included the PageObject module or a string containing the name of the class\n @param Hash values that is pass through to page class a\n available in the @params instance variable.\n @param [Boolean] a boolean indicating if the page should be visited? default is false.\n @param [block] an optional block to be called\n @return [PageObject] the newly created page object", "Create a page object if and only if the current page is the same page to be created\n\n @param [PageObject, String] a class that has included the PageObject module or a string containing the name of the class\n @param Hash values that is pass through to page class a\n available in the @params instance variable.\n @param [block] an optional block to be called\n @return [PageObject] the newly created page object", "Handles requests for Hash values. Others cause an Exception to be raised.\n @param [Symbol|String] m method symbol\n @return [Boolean] the value of the specified instance variable.\n @raise [ArgumentError] if an argument is given. Zero arguments expected.\n @raise [NoMethodError] if the instance variable is not defined.", "Process `css` and return result.\n\n Options can be:\n * `from` with input CSS file name. Will be used in error messages.\n * `to` with output CSS file name.\n * `map` with true to generate new source map or with previous map.", "Parse Browserslist config", "Convert ruby_options to jsOptions", "Try to find Browserslist config", "Lazy load for JS library", "Cache autoprefixer.js content", "Construct a new record\n\n licenses - a string, or array of strings, representing the content of each license\n notices - a string, or array of strings, representing the content of each legal notice\n metadata - a Hash of the metadata for the package\n Save the metadata and text to a file\n\n filename - The destination file to save record contents at", "Returns the license text content from all matched sources\n except the package file, which doesn't contain license text.", "Returns legal notices found at the dependency path", "Returns the sources for a group of license file contents\n\n Sources are returned as a single string with sources separated by \", \"", "Returns an array of enabled app sources", "Returns whether a source type is enabled", "Authenticate a record using cookies. Looks for a cookie corresponding to\n the _authenticatable_class_. If found try to find it in the database.\n @param authenticatable_class [ActiveRecord::Base] any Model connected to\n passwordless. (e.g - _User_ or _Admin_).\n @return [ActiveRecord::Base|nil] an instance of Model found by id stored\n in cookies.encrypted or nil if nothing is found.\n @see ModelHelpers#passwordless_with", "Signs in user by assigning their id to a permanent cookie.\n @param authenticatable [ActiveRecord::Base] Instance of Model to sign in\n (e.g - @user when @user = User.find(id: some_id)).\n @return [ActiveRecord::Base] the record that is passed in.", "Signs out user by deleting their encrypted cookie.\n @param (see #authenticate_by_cookie)\n @return [boolean] Always true", "Sends an arbitrary count for the given stat to the statsd server.\n\n @param [String] stat stat name\n @param [Integer] count count\n @param [Hash] opts the options to create the metric with\n @option opts [Numeric] :sample_rate sample rate, 1 for always\n @option opts [Array] :tags An array of tags", "Sends an arbitary gauge value for the given stat to the statsd server.\n\n This is useful for recording things like available disk space,\n memory usage, and the like, which have different semantics than\n counters.\n\n @param [String] stat stat name.\n @param [Numeric] value gauge value.\n @param [Hash] opts the options to create the metric with\n @option opts [Numeric] :sample_rate sample rate, 1 for always\n @option opts [Array] :tags An array of tags\n @example Report the current user count:\n $statsd.gauge('user.count', User.count)", "Sends a value to be tracked as a histogram to the statsd server.\n\n @param [String] stat stat name.\n @param [Numeric] value histogram value.\n @param [Hash] opts the options to create the metric with\n @option opts [Numeric] :sample_rate sample rate, 1 for always\n @option opts [Array] :tags An array of tags\n @example Report the current user count:\n $statsd.histogram('user.count', User.count)", "Sends a value to be tracked as a set to the statsd server.\n\n @param [String] stat stat name.\n @param [Numeric] value set value.\n @param [Hash] opts the options to create the metric with\n @option opts [Numeric] :sample_rate sample rate, 1 for always\n @option opts [Array] :tags An array of tags\n @example Record a unique visitory by id:\n $statsd.set('visitors.uniques', User.id)", "This method allows you to send custom service check statuses.\n\n @param [String] name Service check name\n @param [String] status Service check status.\n @param [Hash] opts the additional data about the service check\n @option opts [Integer, nil] :timestamp (nil) Assign a timestamp to the event. Default is now when none\n @option opts [String, nil] :hostname (nil) Assign a hostname to the event.\n @option opts [Array, nil] :tags (nil) An array of tags\n @option opts [String, nil] :message (nil) A message to associate with this service check status\n @example Report a critical service check status\n $statsd.service_check('my.service.check', Statsd::CRITICAL, :tags=>['urgent'])", "This end point allows you to post events to the stream. You can tag them, set priority and even aggregate them with other events.\n\n Aggregation in the stream is made on hostname/event_type/source_type/aggregation_key.\n If there's no event type, for example, then that won't matter;\n it will be grouped with other events that don't have an event type.\n\n @param [String] title Event title\n @param [String] text Event text. Supports newlines (+\\n+)\n @param [Hash] opts the additional data about the event\n @option opts [Integer, nil] :date_happened (nil) Assign a timestamp to the event. Default is now when none\n @option opts [String, nil] :hostname (nil) Assign a hostname to the event.\n @option opts [String, nil] :aggregation_key (nil) Assign an aggregation key to the event, to group it with some others\n @option opts [String, nil] :priority ('normal') Can be \"normal\" or \"low\"\n @option opts [String, nil] :source_type_name (nil) Assign a source type to the event\n @option opts [String, nil] :alert_type ('info') Can be \"error\", \"warning\", \"info\" or \"success\".\n @option opts [Array] :tags tags to be added to every metric\n @example Report an awful event:\n $statsd.event('Something terrible happened', 'The end is near if we do nothing', :alert_type=>'warning', :tags=>['end_of_times','urgent'])", "For every `redirect_from` entry, generate a redirect page", "Helper function to set the appropriate path metadata\n\n from - the relative path to the redirect page\n to - the relative path or absolute URL to the redirect target", "Compile some ruby code to a string.\n\n @return [String] javascript code", "Used to generate a unique id name per file. These are used\n mainly to name method bodies for methods that use blocks.", "Process the given sexp by creating a node instance, based on its type,\n and compiling it to fragments.", "The last sexps in method bodies, for example, need to be returned\n in the compiled javascript. Due to syntax differences between\n javascript any ruby, some sexps need to be handled specially. For\n example, `if` statemented cannot be returned in javascript, so\n instead the \"truthy\" and \"falsy\" parts of the if statement both\n need to be returned instead.\n\n Sexps that need to be returned are passed to this method, and the\n alterned/new sexps are returned and should be used instead. Most\n sexps can just be added into a `s(:return) sexp`, so that is the\n default action if no special case is required.", "This method is called when a parse error is found.\n\n ERROR_TOKEN_ID is an internal ID of token which caused error.\n You can get string representation of this ID by calling\n #token_to_str.\n\n ERROR_VALUE is a value of error token.\n\n value_stack is a stack of symbol values.\n DO NOT MODIFY this object.\n\n This method raises ParseError by default.\n\n If this method returns, parsers enter \"error recovering mode\".", "For debugging output", "Returns a new Tms object obtained by memberwise operation +op+\n of the individual times for this Tms object with those of the other\n Tms object.\n\n +op+ can be a mathematical operation such as + , - ,\n * , / ", "Defines a new configuration option\n\n @param [String] name the option name\n @param [Object] default_value the option's default value\n @!macro [attach] property\n @!attribute [rw] $1", "Reads and returns Float from an input stream\n\n @example\n 123.456\n Is encoded as\n 'f', '123.456'", "Reads and returns Bignum from an input stream", "Reads and returns Regexp from an input stream\n\n @example\n r = /regexp/mix\n is encoded as\n '/', 'regexp', r.options.chr", "Reads and returns a Struct from an input stream\n\n @example\n Point = Struct.new(:x, :y)\n Point.new(100, 200)\n is encoded as\n 'S', :Point, {:x => 100, :y => 200}", "Reads and returns a Class from an input stream\n\n @example\n String\n is encoded as\n 'c', 'String'", "Reads and returns a Module from an input stream\n\n @example\n Kernel\n is encoded as\n 'm', 'Kernel'", "Reads and returns an abstract object from an input stream\n\n @example\n obj = Object.new\n obj.instance_variable_set(:@ivar, 100)\n obj\n is encoded as\n 'o', :Object, {:@ivar => 100}\n\n The only exception is a Range class (and its subclasses)\n For some reason in MRI isntances of this class have instance variables\n - begin\n - end\n - excl\n without '@' perfix.", "Reads an object that was dynamically extended before marshaling like\n\n @example\n M1 = Module.new\n M2 = Module.new\n obj = Object.new\n obj.extend(M1)\n obj.extend(M2)\n obj\n is encoded as\n 'e', :M2, :M1, obj", "Collects object allocation and memory of ruby code inside of passed block.", "Iterates through objects in memory of a given generation.\n Stores results along with meta data of objects collected.", "Output the results of the report\n @param [Hash] options the options for output\n @option opts [String] :to_file a path to your log file\n @option opts [Boolean] :color_output a flag for whether to colorize output\n @option opts [Integer] :retained_strings how many retained strings to print\n @option opts [Integer] :allocated_strings how many allocated strings to print\n @option opts [Boolean] :detailed_report should report include detailed information\n @option opts [Boolean] :scale_bytes calculates unit prefixes for the numbers of bytes", "Copy from origin to destination in chunks of size `stride`.\n Use the `throttler` class to sleep between each stride.", "Rename an existing column.\n\n @example\n\n Lhm.change_table(:users) do |m|\n m.rename_column(:login, :username)\n end\n\n @param [String] old Name of the column to change\n @param [String] nu New name to use for the column", "Remove an index from a table\n\n @example\n\n Lhm.change_table(:users) do |m|\n m.remove_index(:comment)\n m.remove_index([:username, :created_at])\n end\n\n @param [String, Symbol, Array] columns\n A column name given as String or Symbol. An Array of Strings or Symbols\n for compound indexes.\n @param [String, Symbol] index_name\n Optional name of the index to be removed", "Set up the queues for each of the worker's consumers.", "Bind a consumer's routing keys to its queue, and set up a subscription to\n receive messages sent to the queue.", "Called internally when a new messages comes in from RabbitMQ. Responsible\n for wrapping up the message and passing it to the consumer.", "Set up the connection to the RabbitMQ management API. Unfortunately, this\n is necessary to do a few things that are impossible over AMQP. E.g.\n listing queues and bindings.", "Return a mapping of queue names to the routing keys they're bound to.", "Find the existing bindings, and unbind any redundant bindings", "Bind a queue to the broker's exchange on the routing keys provided. Any\n existing bindings on the queue that aren't present in the array of\n routing keys will be unbound.", "Run a Hutch worker with the command line interface.", "Returns true if the bounds contain the passed point.\n allows for bounds which cross the meridian", "Returns a comma-delimited string consisting of the street address, city,\n state, zip, and country code. Only includes those attributes that are\n non-blank.", "Builds nested hash structure using the scope returned from the passed in scope", "Find or create a descendant node whose +ancestry_path+ will be ```self.ancestry_path + path```", "Uses Rails auto_link to add links to fields\n\n @param field [String,Hash] string to format and escape, or a hash as per helper_method\n @option field [SolrDocument] :document\n @option field [String] :field name of the solr field\n @option field [Blacklight::Configuration::IndexField, Blacklight::Configuration::ShowField] :config\n @option field [Array] :value array of values for the field\n @param show_link [Boolean]\n @return [ActiveSupport::SafeBuffer]\n @todo stop being a helper_method, start being part of the Blacklight render stack?", "Returns an array of users sorted by the date of their last stats update. Users that have not been recently updated\n will be at the top of the array.", "This method never fails. It tries multiple times and finally logs the exception", "Removes a single lease", "Compute the sum of each file in the collection using Solr to\n avoid having to access Fedora\n\n @return [Fixnum] size of collection in bytes\n @raise [RuntimeError] unsaved record does not exist in solr", "Calculate the size of all the files in the work\n @param work_id [String] identifer for a work\n @return [Integer] the size in bytes", "This performs a two pass query, first getting the AdminSets\n and then getting the work and file counts\n @param [Symbol] access :read or :edit\n @param join_field [String] how are we joining the admin_set ids (by default \"isPartOf_ssim\")\n @return [Array] a list with document, then work and file count", "Count number of files from admin set works\n @param [Array] AdminSets to count files in\n @return [Hash] admin set id keys and file count values", "Registers the given curation concern model in the configuration\n @param [Array,Symbol] curation_concern_types", "Return AdminSet selectbox options based on access type\n @param [Symbol] access :deposit, :read, or :edit", "Create a hash of HTML5 'data' attributes. These attributes are added to select_options and\n later utilized by Javascript to limit new Work options based on AdminSet selected", "Does the workflow for the currently selected permission template allow sharing?", "Handle the HTTP show request", "render an HTTP Range response", "Creates an admin set, setting the creator and the default access controls.\n @return [TrueClass, FalseClass] true if it was successful", "Gives deposit access to registered users to default AdminSet", "Given a deeply nested hash, return a single hash", "These are the file sets that belong to this work, but not necessarily\n in order.\n Arbitrarily maxed at 10 thousand; had to specify rows due to solr's default of 10", "Namespaces routes appropriately\n @example namespaced_resources(\"hyrax/my_work\") is equivalent to\n namespace \"hyrax\", path: :concern do\n resources \"my_work\", except: [:index]\n end", "IIIF metadata for inclusion in the manifest\n Called by the `iiif_manifest` gem to add metadata\n\n @return [Array] array of metadata hashes", "list of item ids to display is based on ordered_ids", "Uses kaminari to paginate an array to avoid need for solr documents for items here", "add hidden fields to a form for performing an action on a single document on a collection", "Finds a solr document matching the id and sets @presenter\n @raise CanCan::AccessDenied if the document is not found or the user doesn't have access to it.", "Only returns unsuppressed documents the user has read access to", "Add uploaded_files to the parameters received by the actor.", "Build a rendering hash\n\n @return [Hash] rendering", "For use with javascript user selector that allows for searching for an existing user\n and granting them permission to an object.\n @param [User] user to select\n @param [String] role granting the user permission (e.g. 'Manager' | 'Depositor' | 'Viewer')", "For use with javascript collection selector that allows for searching for an existing collection from works relationship tab.\n Adds the collection and validates that the collection is listed in the Collection Relationship table once added.\n @param [Collection] collection to select", "For use with javascript collection selector that allows for searching for an existing collection from add to collection modal.\n Does not save the selection. The calling test is expected to click Save and validate the collection membership was added to the work.\n @param [Collection] collection to select", "Creates a display image only where FileSet is an image.\n\n @return [IIIFManifest::DisplayImage] the display image required by the manifest builder.", "Retrieve or generate the fixity check for a specific version of a file\n @param [String] file_id used to find the file within its parent object (usually \"original_file\")\n @param [String] version_uri the version to be fixity checked (or the file uri for non-versioned files)", "Check if time since the last fixity check is greater than the maximum days allowed between fixity checks\n @param [ChecksumAuditLog] latest_fixity_check the most recent fixity check", "Removes a single embargo", "Updates a batch of embargos", "Write the workflow roles and state so one can see where the document moves to next\n @param [Hash] solr_document the solr document to add the field to", "Give workflow responsibilites to the provided agents for the given role\n @param [Sipity::Role] role\n @param [Array] agents", "Find any workflow_responsibilities held by agents not in the allowed_agents\n and remove them\n @param [Sipity::Role] role\n @param [Array] allowed_agents", "Present the attribute as an HTML table row or dl row.\n\n @param [Hash] options\n @option options [Symbol] :render_as use an alternate renderer\n (e.g., :linked or :linked_attribute to use LinkedAttributeRenderer)\n @option options [String] :search_field If the method_name of the attribute is different than\n how the attribute name should appear on the search URL,\n you can explicitly set the URL's search field name\n @option options [String] :label The default label for the field if no translation is found\n @option options [TrueClass, FalseClass] :include_empty should we display a row if there are no values?\n @option options [String] :work_type name of work type class (e.g., \"GenericWork\")", "We're overiding the default indexer in order to index the RDF labels. In order\n for this to be called, you must specify at least one default indexer on the property.\n @param [Hash] solr_doc\n @param [String] solr_field_key\n @param [Hash] field_info\n @param [ActiveTriples::Resource, String] val", "Grab the labels for controlled properties from the remote sources", "Use this method to append a string value from a controlled vocabulary field\n to the solr document. It just puts a copy into the corresponding label field\n @param [Hash] solr_doc\n @param [String] solr_field_key\n @param [Hash] field_info\n @param [String] val", "includes the depositor_facet to get information on deposits.\n use caution when combining this with other searches as it sets the rows to\n zero to just get the facet information\n @param solr_parameters the current solr parameters", "Display user profile", "Query solr using POST so that the query doesn't get too large for a URI", "Adds a value to the end of a list identified by key", "Roll up messages for an operation and all of its children", "Mark this operation as a FAILURE. If this is a child operation, roll up to\n the parent any failures.\n\n @param [String, nil] message record any failure message\n @see Hyrax::Operation::FAILURE\n @see #rollup_status\n @note This will run any registered :failure callbacks\n @todo Where are these callbacks defined? Document this", "Sets the operation status to PENDING\n @param [#class, #job_id] job - The job associated with this operation\n @see Hyrax::Operation::PENDING", "Renders a JSON response with a list of files in this admin set.\n This is used by the edit form to populate the thumbnail_id dropdown", "In the context of a Valkyrie resource, prefer to use the id if it\n is provided and fallback to the first of the alternate_ids. If all else fails\n then the id hasn't been minted and shouldn't yet be set.\n @return [String]", "Add attributes from resource which aren't AF properties into af_object", "For the Managed Collections tab, determine the label to use for the level of access the user has for this admin set.\n Checks from most permissive to most restrictive.\n @return String the access label (e.g. Manage, Deposit, View)", "Return the Global Identifier for this collection type.\n @return [String] Global Identifier (gid) for this collection_type (e.g. gid://internal/hyrax-collectiontype/3)", "Override release_date getter to return a dynamically calculated date of release\n based one release requirements. Returns embargo date when release_max_embargo?==true.\n Returns today's date when release_no_delay?==true.\n @see Hyrax::AdminSetService for usage", "Grant all users with read or edit access permission to download", "We check based on the depositor, because the depositor may not have edit\n access to the work if it went through a mediated deposit workflow that\n removes edit access for the depositor.", "Returns true if the current user is the depositor of the specified work\n @param document_id [String] the id of the document.", "Returns an array of characterization values truncated to 250 characters limited\n to the maximum number of configured values.\n @param [Symbol] term found in the characterization_metadata hash\n @return [Array] of truncated values", "Returns an array of characterization values truncated to 250 characters that are in\n excess of the maximum number of configured values.\n @param [Symbol] term found in the characterization_metadata hash\n @return [Array] of truncated values", "Retrieve search results of the given object type\n\n Permissions: (for people search only) r_network\n\n @note People Search API is a part of the Vetted API Access Program. You\n must apply and get approval before using this API\n\n @see http://developer.linkedin.com/documents/people-search-api People Search\n @see http://developer.linkedin.com/documents/job-search-api Job Search\n @see http://developer.linkedin.com/documents/company-search Company Search\n\n @param [Hash] options search input fields\n @param [String] type type of object to return ('people', 'job' or 'company')\n @return [LinkedIn::Mash]", "Convert the 'timestamp' field from a string to a Time object\n\n @return [Time]", "this skips manifests sometimes because it doesn't look at file\n contents and can't establish from only regexes that the thing\n is a manifest. We exclude rather than include ambiguous filenames\n because this API is used by libraries.io and we don't want to\n download all .xml files from GitHub.", "Returns the object in the form of hash\n @return [Hash] Returns the object in the form of hash", "Outputs non-array value in the form of hash\n For object, use to_hash. Otherwise, just return the value\n @param [Object] value Any valid value\n @return [Hash] Returns the value in the form of hash", "Extract batch_token from Link header if present\n @param [Hash] headers hash with response headers\n @return [String] batch_token or nil if no token is present", "ListCashDrawerShifts\n Provides the details for all of a location's cash drawer shifts during a date range. The date range you specify cannot exceed 90 days.\n @param location_id The ID of the location to list cash drawer shifts for.\n @param [Hash] opts the optional parameters\n @option opts [String] :order The order in which cash drawer shifts are listed in the response, based on their created_at field. Default value: ASC\n @option opts [String] :begin_time The beginning of the requested reporting period, in ISO 8601 format. Default value: The current time minus 90 days.\n @option opts [String] :end_time The beginning of the requested reporting period, in ISO 8601 format. Default value: The current time.\n @return [Array]", "RetrieveCashDrawerShift\n Provides the details for a single cash drawer shift, including all events that occurred during the shift.\n @param location_id The ID of the location to list cash drawer shifts for.\n @param shift_id The shift's ID.\n @param [Hash] opts the optional parameters\n @return [V1CashDrawerShift]", "RetrieveEmployee\n Provides the details for a single employee.\n @param employee_id The employee's ID.\n @param [Hash] opts the optional parameters\n @return [V1Employee]", "RetrieveEmployeeRole\n Provides the details for a single employee role.\n @param role_id The role's ID.\n @param [Hash] opts the optional parameters\n @return [V1EmployeeRole]", "UpdateEmployeeRole\n Modifies the details of an employee role.\n @param role_id The ID of the role to modify.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1EmployeeRole]", "UpdateTimecard\n Modifies the details of a timecard with an `API_EDIT` event for the timecard. Updating an active timecard with a `clockout_time` clocks the employee out.\n @param timecard_id TThe ID of the timecard to modify.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Timecard]", "CreateCustomerCard\n Adds a card on file to an existing customer. As with charges, calls to `CreateCustomerCard` are idempotent. Multiple calls with the same card nonce return the same card record that was created with the provided nonce during the _first_ call. Cards on file are automatically updated on a monthly basis to confirm they are still valid and can be charged.\n @param customer_id The ID of the customer to link the card on file to.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [CreateCustomerCardResponse]", "DeleteCustomer\n Deletes a customer from a business, along with any linked cards on file. When two profiles are merged into a single profile, that profile is assigned a new `customer_id`. You must use the new `customer_id` to delete merged profiles.\n @param customer_id The ID of the customer to delete.\n @param [Hash] opts the optional parameters\n @return [DeleteCustomerResponse]", "DeleteCustomerCard\n Removes a card on file from a customer.\n @param customer_id The ID of the customer that the card on file belongs to.\n @param card_id The ID of the card on file to delete.\n @param [Hash] opts the optional parameters\n @return [DeleteCustomerCardResponse]", "RetrieveCustomer\n Returns details for a single customer.\n @param customer_id The ID of the customer to retrieve.\n @param [Hash] opts the optional parameters\n @return [RetrieveCustomerResponse]", "SearchCustomers\n Searches the customer profiles associated with a Square account. Calling SearchCustomers without an explicit query parameter returns all customer profiles ordered alphabetically based on `given_name` and `family_name`.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [SearchCustomersResponse]", "AdjustInventory\n Adjusts an item variation's current available inventory.\n @param location_id The ID of the item's associated location.\n @param variation_id The ID of the variation to adjust inventory information for.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1InventoryEntry]", "ApplyFee\n Associates a fee with an item, meaning the fee is automatically applied to the item in Square Register.\n @param location_id The ID of the fee's associated location.\n @param item_id The ID of the item to add the fee to.\n @param fee_id The ID of the fee to apply.\n @param [Hash] opts the optional parameters\n @return [V1Item]", "ApplyModifierList\n Associates a modifier list with an item, meaning modifier options from the list can be applied to the item.\n @param location_id The ID of the item's associated location.\n @param modifier_list_id The ID of the modifier list to apply.\n @param item_id The ID of the item to add the modifier list to.\n @param [Hash] opts the optional parameters\n @return [V1Item]", "CreateCategory\n Creates an item category.\n @param location_id The ID of the location to create an item for.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Category]", "CreateDiscount\n Creates a discount.\n @param location_id The ID of the location to create an item for.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Discount]", "CreateItem\n Creates an item and at least one variation for it. Item-related entities include fields you can use to associate them with entities in a non-Square system. When you create an item-related entity, you can optionally specify its `id`. This value must be unique among all IDs ever specified for the account, including those specified by other applications. You can never reuse an entity ID. If you do not specify an ID, Square generates one for the entity. Item variations have a `user_data` string that lets you associate arbitrary metadata with the variation. The string cannot exceed 255 characters.\n @param location_id The ID of the location to create an item for.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Item]", "CreateModifierList\n Creates an item modifier list and at least one modifier option for it.\n @param location_id The ID of the location to create a modifier list for.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1ModifierList]", "CreateModifierOption\n Creates an item modifier option and adds it to a modifier list.\n @param location_id The ID of the item's associated location.\n @param modifier_list_id The ID of the modifier list to edit.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1ModifierOption]", "CreatePage\n Creates a Favorites page in Square Register.\n @param location_id The ID of the location to create an item for.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Page]", "CreateVariation\n Creates an item variation for an existing item.\n @param location_id The ID of the item's associated location.\n @param item_id The item's ID.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Variation]", "ListCategories\n Lists all of a location's item categories.\n @param location_id The ID of the location to list categories for.\n @param [Hash] opts the optional parameters\n @return [Array]", "ListDiscounts\n Lists all of a location's discounts.\n @param location_id The ID of the location to list categories for.\n @param [Hash] opts the optional parameters\n @return [Array]", "ListInventory\n Provides inventory information for all of a merchant's inventory-enabled item variations.\n @param location_id The ID of the item's associated location.\n @param [Hash] opts the optional parameters\n @option opts [Integer] :limit The maximum number of inventory entries to return in a single response. This value cannot exceed 1000.\n @option opts [String] :batch_token A pagination cursor to retrieve the next set of results for your original query to the endpoint.\n @return [Array]", "ListItems\n Provides summary information for all of a location's items.\n @param location_id The ID of the location to list items for.\n @param [Hash] opts the optional parameters\n @option opts [String] :batch_token A pagination cursor to retrieve the next set of results for your original query to the endpoint.\n @return [Array]", "ListModifierLists\n Lists all of a location's modifier lists.\n @param location_id The ID of the location to list modifier lists for.\n @param [Hash] opts the optional parameters\n @return [Array]", "ListPages\n Lists all of a location's Favorites pages in Square Register.\n @param location_id The ID of the location to list Favorites pages for.\n @param [Hash] opts the optional parameters\n @return [Array]", "RemoveFee\n Removes a fee assocation from an item, meaning the fee is no longer automatically applied to the item in Square Register.\n @param location_id The ID of the fee's associated location.\n @param item_id The ID of the item to add the fee to.\n @param fee_id The ID of the fee to apply.\n @param [Hash] opts the optional parameters\n @return [V1Item]", "RemoveModifierList\n Removes a modifier list association from an item, meaning modifier options from the list can no longer be applied to the item.\n @param location_id The ID of the item's associated location.\n @param modifier_list_id The ID of the modifier list to remove.\n @param item_id The ID of the item to remove the modifier list from.\n @param [Hash] opts the optional parameters\n @return [V1Item]", "RetrieveItem\n Provides the details for a single item, including associated modifier lists and fees.\n @param location_id The ID of the item's associated location.\n @param item_id The item's ID.\n @param [Hash] opts the optional parameters\n @return [V1Item]", "RetrieveModifierList\n Provides the details for a single modifier list.\n @param location_id The ID of the item's associated location.\n @param modifier_list_id The modifier list's ID.\n @param [Hash] opts the optional parameters\n @return [V1ModifierList]", "UpdateCategory\n Modifies the details of an existing item category.\n @param location_id The ID of the category's associated location.\n @param category_id The ID of the category to edit.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Category]", "UpdateDiscount\n Modifies the details of an existing discount.\n @param location_id The ID of the category's associated location.\n @param discount_id The ID of the discount to edit.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Discount]", "UpdateItem\n Modifies the core details of an existing item.\n @param location_id The ID of the item's associated location.\n @param item_id The ID of the item to modify.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Item]", "UpdateModifierList\n Modifies the details of an existing item modifier list.\n @param location_id The ID of the item's associated location.\n @param modifier_list_id The ID of the modifier list to edit.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1ModifierList]", "UpdateModifierOption\n Modifies the details of an existing item modifier option.\n @param location_id The ID of the item's associated location.\n @param modifier_list_id The ID of the modifier list to edit.\n @param modifier_option_id The ID of the modifier list to edit.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1ModifierOption]", "UpdatePage\n Modifies the details of a Favorites page in Square Register.\n @param location_id The ID of the Favorites page's associated location\n @param page_id The ID of the page to modify.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Page]", "UpdatePageCell\n Modifies a cell of a Favorites page in Square Register.\n @param location_id The ID of the Favorites page's associated location.\n @param page_id The ID of the page the cell belongs to.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Page]", "UpdateVariation\n Modifies the details of an existing item variation.\n @param location_id The ID of the item's associated location.\n @param item_id The ID of the item to modify.\n @param variation_id The ID of the variation to modify.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [V1Variation]", "DeleteBreakType\n Deletes an existing `BreakType`. A `BreakType` can be deleted even if it is referenced from a `Shift`.\n @param id UUID for the `BreakType` being deleted.\n @param [Hash] opts the optional parameters\n @return [DeleteBreakTypeResponse]", "DeleteShift\n Deletes a `Shift`.\n @param id UUID for the `Shift` being deleted.\n @param [Hash] opts the optional parameters\n @return [DeleteShiftResponse]", "GetBreakType\n Returns a single `BreakType` specified by id.\n @param id UUID for the `BreakType` being retrieved.\n @param [Hash] opts the optional parameters\n @return [GetBreakTypeResponse]", "GetEmployeeWage\n Returns a single `EmployeeWage` specified by id.\n @param id UUID for the `EmployeeWage` being retrieved.\n @param [Hash] opts the optional parameters\n @return [GetEmployeeWageResponse]", "GetShift\n Returns a single `Shift` specified by id.\n @param id UUID for the `Shift` being retrieved.\n @param [Hash] opts the optional parameters\n @return [GetShiftResponse]", "UpdateBreakType\n Updates an existing `BreakType`.\n @param id UUID for the `BreakType` being updated.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [UpdateBreakTypeResponse]", "UpdateShift\n Updates an existing `Shift`. When adding a `Break` to a `Shift`, any earlier `Breaks` in the `Shift` have the `end_at` property set to a valid RFC-3339 datetime string. When closing a `Shift`, all `Break` instances in the shift must be complete with `end_at` set on each `Break`.\n @param id ID of the object being updated.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [UpdateShiftResponse]", "UpdateWorkweekConfig\n Updates a `WorkweekConfig`.\n @param id UUID for the `WorkweekConfig` object being updated.\n @param body An object containing the fields to POST for the request. See the corresponding object definition for field details.\n @param [Hash] opts the optional parameters\n @return [UpdateWorkweekConfigResponse]", "RetrieveTransaction\n Retrieves details for a single transaction.\n @param location_id The ID of the transaction's associated location.\n @param transaction_id The ID of the transaction to retrieve.\n @param [Hash] opts the optional parameters\n @return [RetrieveTransactionResponse]", "ListBankAccounts\n Provides non-confidential details for all of a location's associated bank accounts. This endpoint does not provide full bank account numbers, and there is no way to obtain a full bank account number with the Connect API.\n @param location_id The ID of the location to list bank accounts for.\n @param [Hash] opts the optional parameters\n @return [Array]", "ListOrders\n Provides summary information for a merchant's online store orders.\n @param location_id The ID of the location to list online store orders for.\n @param [Hash] opts the optional parameters\n @option opts [String] :order TThe order in which payments are listed in the response.\n @option opts [Integer] :limit The maximum number of payments to return in a single response. This value cannot exceed 200.\n @option opts [String] :batch_token A pagination cursor to retrieve the next set of results for your original query to the endpoint.\n @return [Array]", "RetrieveBankAccount\n Provides non-confidential details for a merchant's associated bank account. This endpoint does not provide full bank account numbers, and there is no way to obtain a full bank account number with the Connect API.\n @param location_id The ID of the bank account's associated location.\n @param bank_account_id The bank account's Square-issued ID. You obtain this value from Settlement objects returned.\n @param [Hash] opts the optional parameters\n @return [V1BankAccount]", "RetrieveOrder\n Provides comprehensive information for a single online store order, including the order's history.\n @param location_id The ID of the order's associated location.\n @param order_id The order's Square-issued ID. You obtain this value from Order objects returned by the List Orders endpoint\n @param [Hash] opts the optional parameters\n @return [V1Order]", "RetrievePayment\n Provides comprehensive information for a single payment.\n @param location_id The ID of the payment's associated location.\n @param payment_id The Square-issued payment ID. payment_id comes from Payment objects returned by the List Payments endpoint, Settlement objects returned by the List Settlements endpoint, or Refund objects returned by the List Refunds endpoint.\n @param [Hash] opts the optional parameters\n @return [V1Payment]", "View helper for rendering many activities", "Adds or redefines a parameter\n @param [Symbol] name\n @param [#call, nil] type (nil)\n @option opts [Proc] :default\n @option opts [Boolean] :optional\n @option opts [Symbol] :as\n @option opts [true, false, :protected, :public, :private] :reader\n @return [self] itself", "Human-readable representation of configured params and options\n @return [String]", "Returns a version of the module with custom settings\n @option settings [Boolean] :undefined\n If unassigned params and options should be treated different from nil\n @return [Dry::Initializer]", "Returns mixin module to be included to target class by hand\n @return [Module]\n @yield proc defining params and options", "class AndroidElements\n Android only.\n Returns a string containing interesting elements.\n The text, content description, and id are returned.\n @param class_name [String] the class name to filter on.\n if false (default) then all classes will be inspected\n @return [String]", "Intended for use with console.\n Inspects and prints the current page.\n Will return XHTML for Web contexts because of a quirk with Nokogiri.\n @option class [Symbol] the class name to filter on. case insensitive include match.\n if nil (default) then all classes will be inspected\n @return [void]", "Find the element of type class_name at matching index.\n @param class_name [String] the class name to find\n @param index [Integer] the index\n @return [Element] the found element of type class_name", "Returns a hash of the driver attributes", "Returns the server's version info\n\n @example\n {\n \"build\" => {\n \"version\" => \"0.18.1\",\n \"revision\" => \"d242ebcfd92046a974347ccc3a28f0e898595198\"\n }\n }\n\n @return [Hash]", "Creates a new global driver and quits the old one if it exists.\n You can customise http_client as the following\n\n Read http://www.rubydoc.info/github/appium/ruby_lib_core/Appium/Core/Device to understand more what the driver\n can call instance methods.\n\n @example\n\n require 'rubygems'\n require 'appium_lib'\n\n # platformName takes a string or a symbol.\n # Start iOS driver\n opts = {\n caps: {\n platformName: :ios,\n app: '/path/to/MyiOS.app'\n },\n appium_lib: {\n wait_timeout: 30\n }\n }\n appium_driver = Appium::Driver.new(opts) #=> return an Appium::Driver instance\n appium_driver.start_driver #=> return an Appium::Core::Base::Driver\n\n @option http_client_ops [Hash] :http_client Custom HTTP Client\n @option http_client_ops [Hash] :open_timeout Custom open timeout for http client.\n @option http_client_ops [Hash] :read_timeout Custom read timeout for http client.\n @return [Selenium::WebDriver] the new global driver", "To ignore error for Espresso Driver", "Returns existence of element.\n\n Example:\n\n exists { button('sign in') } ? puts('true') : puts('false')\n\n @param [Integer] pre_check The amount in seconds to set the\n wait to before checking existence\n @param [Integer] post_check The amount in seconds to set the\n wait to after checking existence\n @yield The block to call\n @return [Boolean]", "Find the last TextField.\n @return [TextField]", "Converts pixel values to window relative values\n\n @example\n\n px_to_window_rel x: 50, y: 150 #=> #", "Search strings.xml's values for target.\n @param target [String] the target to search for in strings.xml values\n @return [Array]", "Search strings.xml's keys for target.\n @param target [String] the target to search for in strings.xml keys\n @return [Array]", "backward compatibility\n Find the first button that contains value or by index.\n @param value [String, Integer] the value to exactly match.\n If int then the button at that index is returned.\n @return [BUTTON]", "Find the last button.\n @return [BUTTON]", "Find the first UIAStaticText|XCUIElementTypeStaticText that contains value or by index.\n @param value [String, Integer] the value to find.\n If int then the UIAStaticText|XCUIElementTypeStaticText at that index is returned.\n @return [UIA_STATIC_TEXT|XCUIELEMENT_TYPE_STATIC_TEXT]", "Scroll to the first element containing target text or description.\n @param text [String] the text or resourceId to search for in the text value and content description\n @param scrollable_index [Integer] the index for scrollable views.\n @return [Element] the element scrolled to", "Prints a string of interesting elements to the console.\n\n @example\n ```ruby\n page class: :UIAButton # filter on buttons\n page class: :UIAButton, window: 1\n ```\n\n @option visible [Symbol] visible value to filter on\n @option class [Symbol] class name to filter on\n\n @return [void]", "Get the element of type class_name at matching index.\n @param class_name [String] the class name to find\n @param index [Integer] the index\n @return [Element]", "predicate - the predicate to evaluate on the main app\n\n visible - if true, only visible elements are returned. default true", "Check every interval seconds to see if yield returns a truthy value.\n Note this isn't a strict boolean true, any truthy value is accepted.\n false and nil are considered failures.\n Give up after timeout seconds.\n\n Wait code from the selenium Ruby gem\n https://github.com/SeleniumHQ/selenium/blob/cf501dda3f0ed12233de51ce8170c0e8090f0c20/rb/lib/selenium/webdriver/common/wait.rb\n\n If only a number is provided then it's treated as the timeout value.\n\n @param [Hash|Numeric] opts Options. If the value is _Numeric_, the value is set as `{ timeout: value }`\n @option opts [Numeric] :timeout Seconds to wait before timing out. Set default by `appium_wait_timeout` (30).\n @option opts [Numeric] :interval Seconds to sleep between polls. Set default by `appium_wait_interval` (0.5).\n @option opts [String] :message Exception message if timed out.\n @option opts [Array, Exception] :ignore Exceptions to ignore while polling (default: Exception)\n\n @example\n\n wait_true(timeout: 20, interval: 0.2, message: 'custom message') { button_exact('Back') }.click\n wait_true(20) { button_exact('Back') }.click", "Find the first EditText that contains value or by index.\n @param value [String, Integer] the text to match exactly.\n If int then the EditText at that index is returned.\n @return [EDIT_TEXT]", "Find the first TextView that contains value or by index.\n @param value [String, Integer] the value to find.\n If int then the TextView at that index is returned.\n @return [TextView]", "Find the first UIAButton|XCUIElementTypeButton that contains value or by index.\n @param value [String, Integer] the value to exactly match.\n If int then the UIAButton|XCUIElementTypeButton at that index is returned.\n @return [UIA_BUTTON|XCUIELEMENT_TYPE_BUTTON]", "Handles extracting elements from the entry", "specifically handles extracting the preconditions for the population criteria", "extracts out any measure observation definitons, creating from them the proper criteria to generate a precondition", "generates the value given in an expression based on the number of criteria it references.", "Get the conjunction code, ALL_TRUE or AT_LEAST_ONE_TRUE\n @return [String] conjunction code", "Check whether the temporal reference should be marked as inclusive", "Check whether the length of stay should be inclusive.", "Check if are only AnyValue elements for low and high", "If a precondition references a population, remove it", "Extracts the measure observations, will return true if one exists", "Builds populations based an a predfined set of expected populations", "Generate the stratifications of populations, if any exist", "Method to generate the criteria defining a population", "if the data criteria is derived from another criteria, then we want to grab the properties from the derived criteria\n this is typically the case with Occurrence A, Occurrence B type data criteria", "source are things like exceptions or exclusions, target are IPP, or denom\n we want to find any denoms or IPPs that do not have exceptions or exclusions", "create a copy of each submeasre adding on the new values of the given type\n skip the unpaired values. Unpaired values are denominators without exclusions or populations without exceptions", "Handles setup of the base values of the document, defined here as ones that are either\n obtained from the xml directly or with limited parsing", "Extracts the code used by a particular attribute", "Extracts the value used by a particular attribute", "For specific occurrence data criteria, make sure the source data criteria reference points\n to the correct source data criteria.", "Set the value and code_list_xpath using the template mapping held in the ValueSetHelper class", "Apply some elements from the reference_criteria to the derived specific occurrence", "grouping data criteria are used to allow a single reference off of a temporal reference or subset operator\n grouping data criteria can reference either regular data criteria as children, or other grouping data criteria", "pull the children data criteria out of a set of preconditions", "this method creates V1 data criteria for the measurement period. These data criteria can be\n referenced properly within the restrictions", "Generate a list of child criterias", "Extracts all subset operators contained in the entry xml", "Preconditions can have nil conjunctions as part of a DATEDIFF, we want to remove these and warn", "Get the source data criteria that are specific occurrences\n @return [Array] an array of HQMF::DataCriteria describing the data elements used by the measure that are specific occurrences", "Get specific attributes by code.\n @param [String] code the attribute code\n @param [String] code_system the attribute code system\n @return [Array#Attribute] the matching attributes, raises an Exception if not found", "patient characteristics data criteria such as GENDER require looking at the codes to determine if the\n measure is interested in Males or Females. This process is awkward, and thus is done as a separate\n step after the document has been converted.", "Given a template id, modify the variables inside this data criteria to reflect the template", "Extracts information from a reference for a specific", "Apply additional information to a specific occurrence's elements from the criteria it references.", "If there is no entry type, extract the entry type from what it references, and extract additional information for\n specific occurrences. If there are no outbound references, print an error and mark it as variable.", "Create grouper data criteria for encapsulating variable data criteria\n and update document data criteria list and references map", "Check elements that do not already exist; else, if they do, check if those elements are the same\n in a different, potentially matching, data criteria", "Handle setting the specific and source instance variables with a given occurrence identifier", "Handles elments that can be extracted directly from the xml. Utilises the \"BaseExtractions\" class.", "Duplicates information from a child element to this data criteria if none exits.\n If the duplication requires that come values should be overwritten, do so only in the function calling this.", "Generate the models of the field values", "Generate the title and description used when producing the model", "class << self", "The URL for this Chef Zero server. If the given host is an IPV6 address,\n it is escaped in brackets according to RFC-2732.\n\n @see http://www.ietf.org/rfc/rfc2732.txt RFC-2732\n\n @return [String]", "Start a Chef Zero server in a forked process. This method returns the PID\n to the forked process.\n\n @param [Fixnum] wait\n the number of seconds to wait for the server to start\n\n @return [Thread]\n the thread the background process is running in", "Gracefully stop the Chef Zero server.\n\n @param [Fixnum] wait\n the number of seconds to wait before raising force-terminating the\n server", "Serializes `data` to JSON and returns an Array with the\n response code, HTTP headers and JSON body.\n\n @param [Fixnum] response_code HTTP response code\n @param [Hash] data The data for the response body as a Hash\n @param [Hash] options\n @option options [Hash] :headers (see #already_json_response)\n @option options [Boolean] :pretty (true) Pretty-format the JSON\n @option options [Fixnum] :request_version (see #already_json_response)\n @option options [Fixnum] :response_version (see #already_json_response)\n\n @return (see #already_json_response)", "Returns an Array with the response code, HTTP headers, and JSON body.\n\n @param [Fixnum] response_code The HTTP response code\n @param [String] json_text The JSON body for the response\n @param [Hash] options\n @option options [Hash] :headers ({}) HTTP headers (may override default headers)\n @option options [Fixnum] :request_version (0) Request API version\n @option options [Fixnum] :response_version (0) Response API version\n\n @return [Array(Fixnum, Hash{String => String}, String)]", "To be called from inside rest endpoints", "Processes SASL connection params and returns a hash with symbol keys or a nil", "Map states to symbols", "Async fetch results from an async execute", "Pull rows from the query result", "Raises an exception if given operation result is a failure", "this will clean up when we officially deprecate", "produces a printf formatter line for an array of items\n if an individual line item is an array, it will create columns\n that are lined-up\n\n line_formatter([\"foo\", \"barbaz\"]) # => \"%-6s\"\n line_formatter([\"foo\", \"barbaz\"], [\"bar\", \"qux\"]) # => \"%-3s %-6s\"", "creates a new StrVal object\n @option options [Array] :data\n @option options [String] :tag_name\n Creates the val objects for this data set. I am not overly confident this is going to play nicely with time and data types.\n @param [Array] values An array of cells or values.", "The relationships for this pivot table.\n @return [Relationships]", "Sets the color for the data bars.\n @param [Color|String] v The color object, or rgb string value to apply", "Serialize this object to an xml string\n @param [String] str\n @return [String]", "Serialize your workbook to disk as an xlsx document.\n\n @param [String] output The name of the file you want to serialize your package to\n @param [Boolean] confirm_valid Validate the package prior to serialization.\n @return [Boolean] False if confirm_valid and validation errors exist. True if the package was serialized\n @note A tremendous amount of effort has gone into ensuring that you cannot create invalid xlsx documents.\n confirm_valid should be used in the rare case that you cannot open the serialized file.\n @see Package#validate\n @example\n # This is how easy it is to create a valid xlsx file. Of course you might want to add a sheet or two, and maybe some data, styles and charts.\n # Take a look at the README for an example of how to do it!\n\n #serialize to a file\n p = Axlsx::Package.new\n # ......add cool stuff to your workbook......\n p.serialize(\"example.xlsx\")\n\n # Serialize to a stream\n s = p.to_stream()\n File.open('example_streamed.xlsx', 'w') { |f| f.write(s.read) }", "Serialize your workbook to a StringIO instance\n @param [Boolean] confirm_valid Validate the package prior to serialization.\n @return [StringIO|Boolean] False if confirm_valid and validation errors exist. rewound string IO if not.", "Writes the package parts to a zip archive.\n @param [Zip::OutputStream] zip\n @return [Zip::OutputStream]", "The parts of a package\n @return [Array] An array of hashes that define the entry, document and schema for each part of the package.\n @private", "Performs xsd validation for a signle document\n\n @param [String] schema path to the xsd schema to be used in validation.\n @param [String] doc The xml text to be validated\n @return [Array] An array of all validation errors encountered.\n @private", "Appends override objects for drawings, charts, and sheets as they exist in your workbook to the default content types.\n @return [ContentType]\n @private", "Creates the minimum content types for generating a valid xlsx document.\n @return [ContentType]\n @private", "Creates the relationships required for a valid xlsx document\n @return [Relationships]\n @private", "sets or updates a hyperlink for this image.\n @param [String] v The href value for the hyper link\n @option options @see Hyperlink#initialize All options available to the Hyperlink class apply - however href will be overridden with the v parameter value.", "noop if not using a two cell anchor\n @param [Integer] x The column\n @param [Integer] y The row\n @return [Marker]", "Changes the anchor to a one cell anchor.", "changes the anchor type to a two cell anchor", "refactoring of swapping code, law of demeter be damned!", "creates a new ColorScale object.\n @see Cfvo\n @see Color\n @example\n color_scale = Axlsx::ColorScale.new({:type => :num, :val => 0.55, :color => 'fff7696c'})\n adds a new cfvo / color pair to the color scale and returns a hash containing\n a reference to the newly created cfvo and color objects so you can alter the default properties.\n @return [Hash] a hash with :cfvo and :color keys referencing the newly added objects.\n @param [Hash] options options for the new cfvo and color objects\n @option [Symbol] type The type of cfvo you to add\n @option [Any] val The value of the cfvo to add\n @option [String] The rgb color for the cfvo", "Serialize this color_scale object data to an xml string\n @param [String] str\n @return [String]", "There has got to be cleaner way of merging these arrays.", "Adds an axis to the collection\n @param [Symbol] name The name of the axis\n @param [Axis] axis_class The axis class to generate", "Creates a new Shared Strings Table agains an array of cells\n @param [Array] cells This is an array of all of the cells in the workbook\n @param [Symbol] xml_space The xml:space behavior for the shared string table.\n Serializes the object\n @param [String] str\n @return [String]", "Interate over all of the cells in the array.\n if our unique cells array does not contain a sharable cell,\n add the cell to our unique cells array and set the ssti attribute on the index of this cell in the shared strings table\n if a sharable cell already exists in our unique_cells array, set the ssti attribute of the cell and move on.\n @return [Array] unique cells", "seralize the collection of hyperlinks\n @return [String]", "A quick helper to retrive a worksheet by name\n @param [String] name The name of the sheet you are looking for\n @return [Worksheet] The sheet found, or nil", "inserts a worksheet into this workbook at the position specified.\n It the index specified is out of range, the worksheet will be added to the end of the\n worksheets collection\n @return [Worksheet]\n @param index The zero based position to insert the newly created worksheet\n @param [Hash] options Options to pass into the worksheed during initialization.\n @option options [String] name The name of the worksheet\n @option options [Hash] page_margins The page margins for the worksheet", "The workbook relationships. This is managed automatically by the workbook\n @return [Relationships]", "returns a range of cells in a worksheet\n @param [String] cell_def The excel style reference defining the worksheet and cells. The range must specify the sheet to\n retrieve the cells from. e.g. range('Sheet1!A1:B2') will return an array of four cells [A1, A2, B1, B2] while range('Sheet1!A1') will return a single Cell.\n @return [Cell, Array]", "Serialize the workbook\n @param [String] str\n @return [String]", "Set some or all margins at once.\n @param [Hash] margins the margins to set (possible keys are :left, :right, :top, :bottom, :header and :footer).", "shortcut to set the column, row position for this marker\n @param col the column for the marker, a Cell object or a string reference like \"B7\"\n or an Array.\n @param row the row of the marker. This is ignored if the col parameter is a Cell or\n String or Array.", "handles multiple inputs for setting the position of a marker\n @see Chart#start_at", "Creates a new Comments object\n @param [Worksheet] worksheet The sheet that these comments belong to.\n Adds a new comment to the worksheet that owns these comments.\n @note the author, text and ref options are required\n @option options [String] author The name of the author for this comment\n @option options [String] text The text for this comment\n @option options [Stirng|Cell] ref The cell that this comment is attached to.", "Tries to work out the width of the longest line in the run\n @param [Array] widtharray this array is populated with the widths of each line in the run.\n @return [Array]", "Serializes the RichTextRun\n @param [String] str\n @return [String]", "Returns the width of a string according to the current style\n This is still not perfect...\n - scaling is not linear as font sizes increase", "we scale the font size if bold style is applied to either the style font or\n the cell itself. Yes, it is a bit of a hack, but it is much better than using\n imagemagick and loading metrics for every character.", "validates that the value provided is between 0.0 and 1.0", "Serialize the contenty type to xml", "serialize the conditional formattings", "Initalize the simple typed list of value objects\n I am keeping this private for now as I am not sure what impact changes to the required two cfvo objects will do.", "Creates a byte string for this storage\n @return [String]", "Sets the col_id attribute for this filter column.\n @param [Integer | Cell] column_index The zero based index of the column to which this filter applies.\n When you specify a cell, the column index will be read off the cell\n @return [Integer]", "Apply the filters for this column\n @param [Array] row A row from a worksheet that needs to be\n filtered.", "Serialize the sheet data\n @param [String] str the string this objects serializaton will be concacted to.\n @return [String]", "creates the DefinedNames object\n Serialize to xml\n @param [String] str\n @return [String]", "Add a ConditionalFormattingRule. If a hash of options is passed\n in create a rule on the fly.\n @param [ConditionalFormattingRule|Hash] rule A rule to use, or the options necessary to create one.\n @see ConditionalFormattingRule#initialize", "Serializes the conditional formatting element\n @example Conditional Formatting XML looks like:\n \n \n 0.5 \n \n \n @param [String] str\n @return [String]", "Specify the degree of label rotation to apply to labels\n default true", "The title object for the chart.\n @param [String, Cell] v\n @return [Title]", "Initalizes page margin, setup and print options\n @param [Hash] options Options passed in from the initializer", "Add conditional formatting to this worksheet.\n\n @param [String] cells The range to apply the formatting to\n @param [Array|Hash] rules An array of hashes (or just one) to create Conditional formatting rules from.\n @example This would format column A whenever it is FALSE.\n # for a longer example, see examples/example_conditional_formatting.rb (link below)\n worksheet.add_conditional_formatting( \"A1:A1048576\", { :type => :cellIs, :operator => :equal, :formula => \"FALSE\", :dxfId => 1, :priority => 1 }\n\n @see ConditionalFormattingRule#initialize\n @see file:examples/example_conditional_formatting.rb", "Add data validation to this worksheet.\n\n @param [String] cells The cells the validation will apply to.\n @param [hash] data_validation options defining the validation to apply.\n @see examples/data_validation.rb for an example", "Adds a chart to this worksheets drawing. This is the recommended way to create charts for your worksheet. This method wraps the complexity of dealing with ooxml drawing, anchors, markers graphic frames chart objects and all the other dirty details.\n @param [Class] chart_type\n @option options [Array] start_at\n @option options [Array] end_at\n @option options [Cell, String] title\n @option options [Boolean] show_legend\n @option options [Integer] style\n @note each chart type also specifies additional options\n @see Chart\n @see Pie3DChart\n @see Bar3DChart\n @see Line3DChart\n @see README for examples", "This is a helper method that Lets you specify a fixed width for multiple columns in a worksheet in one go.\n Note that you must call column_widths AFTER adding data, otherwise the width will not be set successfully.\n Setting a fixed column width to nil will revert the behaviour back to calculating the width for you on the next call to add_row.\n @example This would set the first and third column widhts but leave the second column in autofit state.\n ws.column_widths 7.2, nil, 3\n @note For updating only a single column it is probably easier to just set the width of the ws.column_info[col_index].width directly\n @param [Integer|Float|nil] widths", "Set the style for cells in a specific column\n @param [Integer] index the index of the column\n @param [Integer] style the cellXfs index\n @param [Hash] options\n @option [Integer] :row_offset only cells after this column will be updated.\n @note You can also specify the style for specific columns in the call to add_row by using an array for the :styles option\n @see Worksheet#add_row\n @see README.md for an example", "Set the style for cells in a specific row\n @param [Integer] index or range of indexes in the table\n @param [Integer] style the cellXfs index\n @param [Hash] options the options used when applying the style\n @option [Integer] :col_offset only cells after this column will be updated.\n @note You can also specify the style in the add_row call\n @see Worksheet#add_row\n @see README.md for an example", "Returns a sheet node serialization for this sheet in the workbook.", "Serializes the worksheet object to an xml string\n This intentionally does not use nokogiri for performance reasons\n @return [String]", "The worksheet relationships. This is managed automatically by the worksheet\n @return [Relationships]", "returns the column and row index for a named based cell\n @param [String] name The cell or cell range to return. \"A1\" will return the first cell of the first row.\n @return [Cell]", "shortcut level to specify the outline level for a series of rows\n Oulining is what lets you add collapse and expand to a data set.\n @param [Integer] start_index The zero based index of the first row of outlining.\n @param [Integer] end_index The zero based index of the last row to be outlined\n @param [integer] level The level of outline to apply\n @param [Integer] collapsed The initial collapsed state of the outline group", "shortcut level to specify the outline level for a series of columns\n Oulining is what lets you add collapse and expand to a data set.\n @param [Integer] start_index The zero based index of the first column of outlining.\n @param [Integer] end_index The zero based index of the last column to be outlined\n @param [integer] level The level of outline to apply\n @param [Integer] collapsed The initial collapsed state of the outline group", "Serializes the row\n @param [Integer] r_index The row index, 0 based.\n @param [String] str The string this rows xml will be appended to.\n @return [String]", "Adds a single cell to the row based on the data provided and updates the worksheet's autofit data.\n @return [Cell]", "sets the color for every cell in this row", "sets the style for every cell in this row", "Converts values, types, and style options into cells and associates them with this row.\n A new cell is created for each item in the values array.\n If value option is defined and is a symbol it is applied to all the cells created.\n If the value option is an array, cell types are applied by index for each cell\n If the style option is defined and is an Integer, it is applied to all cells created.\n If the style option is an array, style is applied by index for each cell.\n @option options [Array] values\n @option options [Array, Symbol] types\n @option options [Array, Integer] style", "Creates a new Drawing object\n @param [Worksheet] worksheet The worksheet that owns this drawing\n Adds an image to the chart If th end_at option is specified we create a two cell anchor. By default we use a one cell anchor.\n @note The recommended way to manage images is to use Worksheet.add_image. Please refer to that method for documentation.\n @see Worksheet#add_image\n @return [Pic]", "Adds a chart to the drawing.\n @note The recommended way to manage charts is to use Worksheet.add_chart. Please refer to that method for documentation.\n @see Worksheet#add_chart", "An array of charts that are associated with this drawing's anchors\n @return [Array]", "An array of hyperlink objects associated with this drawings images\n @return [Array]", "An array of image objects that are associated with this drawing's anchors\n @return [Array]", "The drawing's relationships.\n @return [Relationships]", "Serialize the object\n @param [String] str serialized output will be appended to this object if provided.\n @return [String]", "Creates a new pie chart object\n @param [GraphicFrame] frame The workbook that owns this chart.\n @option options [Cell, String] title\n @option options [Boolean] show_legend\n @option options [Symbol] grouping\n @option options [String] gap_depth\n @option options [Integer] rot_x\n @option options [String] h_percent\n @option options [Integer] rot_y\n @option options [String] depth_percent\n @option options [Boolean] r_ang_ax\n @option options [Integer] perspective\n @see Chart\n @see View3D\n Serializes the object\n @param [String] str\n @return [String]", "creates the book views object\n Serialize to xml\n @param [String] str\n @return [String]", "updates the width for this col based on the cells autowidth and\n an optionally specified fixed width\n @param [Cell] cell The cell to use in updating this col's width\n @param [Integer] fixed_width If this is specified the width is set\n to this value and the cell's attributes are ignored.\n @param [Boolean] use_autowidth If this is false, the cell's\n autowidth value will be ignored.", "parse convert and assign node text to symbol", "parse, convert and assign note text to integer", "parse, convert and assign node text to float", "return node text based on xpath", "adds a chart to the drawing object\n @param [Class] chart_type The type of chart to add\n @param [Hash] options Options to pass on to the drawing and chart\n @see Worksheet#add_chart", "Adds a protected range\n @param [Array|String] cells A string range reference or array of cells that will be protected", "Serializes the protected ranges\n @param [String] str\n @return [String]", "Adds a filter column. This is the recommended way to create and manage filter columns for your autofilter.\n In addition to the require id and type parameters, options will be passed to the filter column during instantiation.\n @param [String] col_id Zero-based index indicating the AutoFilter column to which this filter information applies.\n @param [Symbol] filter_type A symbol representing one of the supported filter types.\n @param [Hash] options a hash of options to pass into the generated filter\n @return [FilterColumn]", "actually performs the filtering of rows who's cells do not\n match the filter.", "delete the item from the list\n @param [Any] v The item to be deleted.\n @raise [ArgumentError] if the item's index is protected by locking\n @return [Any] The item deleted", "positional assignment. Adds the item at the index specified\n @param [Integer] index\n @param [Any] v\n @raise [ArgumentError] if the index is protected by locking\n @raise [ArgumentError] if the item is not one of the allowed types", "creates a XML tag with serialized attributes\n @see SerializedAttributes#serialized_attributes", "serializes the instance values of the defining object based on the\n list of serializable attributes.\n @param [String] str The string instance to append this\n serialization to.\n @param [Hash] additional_attributes An option key value hash for\n defining values that are not serializable attributes list.", "A hash of instance variables that have been declared with\n seraialized_attributes and are not nil.\n This requires ruby 1.9.3 or higher", "serialized instance values at text nodes on a camelized element of the\n attribute name. You may pass in a block for evaluation against non nil\n values. We use an array for element attributes becuase misordering will\n break the xml and 1.8.7 does not support ordered hashes.\n @param [String] str The string instance to which serialized data is appended\n @param [Array] additional_attributes An array of additional attribute names.\n @return [String] The serialized output.", "serializes the data labels\n @return [String]", "The node name to use in serialization. As LineChart is used as the\n base class for Liine3DChart we need to be sure to serialize the\n chart based on the actual class type and not a fixed node name.\n @return [String]", "Serialize the app.xml document\n @return [String]", "Merges all the cells in a range created between this cell and the cell or string name for a cell provided\n @see worksheet.merge_cells\n @param [Cell, String] target The last cell, or str ref for the cell in the merge range", "Attempts to determine the correct width for this cell's content\n @return [Float]", "Determines the cell type based on the cell value.\n @note This is only used when a cell is created but no :type option is specified, the following rules apply:\n 1. If the value is an instance of Date, the type is set to :date\n 2. If the value is an instance of Time, the type is set to :time\n 3. If the value is an instance of TrueClass or FalseClass, the type is set to :boolean\n 4. :float and :integer types are determined by regular expression matching.\n 5. Anything that does not meet either of the above is determined to be :string.\n @return [Symbol] The determined type", "Cast the value into this cells data type.\n @note\n About Time - Time in OOXML is *different* from what you might expect. The history as to why is interesting, but you can safely assume that if you are generating docs on a mac, you will want to specify Workbook.1904 as true when using time typed values.\n @see Axlsx#date1904", "Tells us if the row of the cell provided should be filterd as it\n does not meet any of the specified filter_items or\n date_group_items restrictions.\n @param [Cell] cell The cell to test against items\n TODO implement this for date filters as well!", "Serialize the object to xml", "Date group items are date group filter items where you specify the\n date_group and a value for that option as part of the auto_filter\n @note This can be specified, but will not be applied to the date\n values in your workbook at this time.", "Creates a password hash for a given password\n @return [String]", "Creates the val objects for this data set. I am not overly confident this is going to play nicely with time and data types.\n @param [Array] values An array of cells or values.", "The name of the Table.\n @param [String, Cell] v\n @return [Title]", "Serializes the conditional formatting rule\n @param [String] str\n @return [String]", "Sets the cell location of this hyperlink in the worksheet\n @param [String|Cell] cell_reference The string reference or cell that defines where this hyperlink shows in the worksheet.", "serializes the core.xml document\n @return [String]", "creates a new MergedCells object\n @param [Worksheet] worksheet\n adds cells to the merged cells collection\n @param [Array||String] cells The cells to add to the merged cells\n collection. This can be an array of actual cells or a string style\n range like 'A1:C1'", "SEARCH GEOCODING PARAMS \n\n :q => required, full text search param)\n :limit => force limit number of results returned by raw API\n (default = 5) note : only first result is taken\n in account in geocoder\n\n :autocomplete => pass 0 to disable autocomplete treatment of :q\n (default = 1)\n\n :lat => force filter results around specific lat/lon\n\n :lon => force filter results around specific lat/lon\n\n :type => force filter the returned result type\n (check results for a list of accepted types)\n\n :postcode => force filter results on a specific city post code\n\n :citycode => force filter results on a specific city UUID INSEE code\n\n For up to date doc (in french only) : https://adresse.data.gouv.fr/api/", "REVERSE GEOCODING PARAMS \n\n :lat => required\n\n :lon => required\n\n :type => force returned results type\n (check results for a list of accepted types)", "Convert an \"underscore\" version of a name into a \"class\" version.", "Return the name of the configured service, or raise an exception.", "Read from the Cache.", "Write to the Cache.", "Return the error but also considering its name. This is used\n when errors for a hidden field need to be shown.\n\n == Examples\n\n f.full_error :token #=> Token is invalid ", "Extract the model names from the object_name mess, ignoring numeric and\n explicit child indexes.\n\n Example:\n\n route[blocks_attributes][0][blocks_learning_object_attributes][1][foo_attributes]\n [\"route\", \"blocks\", \"blocks_learning_object\", \"foo\"]", "The action to be used in lookup.", "Find an input based on the attribute name.", "Checks if the file of given path is a valid ELF file.\n\n @param [String] path Path to target file.\n @return [Boolean] If the file is an ELF or not.\n @example\n Helper.valid_elf_file?('/etc/passwd')\n #=> false\n Helper.valid_elf_file?('/lib64/ld-linux-x86-64.so.2')\n #=> true", "Get the Build ID of target ELF.\n @param [String] path Absolute file path.\n @return [String] Target build id.\n @example\n Helper.build_id_of('/lib/x86_64-linux-gnu/libc-2.23.so')\n #=> '60131540dadc6796cab33388349e6e4e68692053'", "Wrap string with color codes for pretty inspect.\n @param [String] str Contents to colorize.\n @param [Symbol] sev Specify which kind of color to use, valid symbols are defined in {.COLOR_CODE}.\n @return [String] String wrapped with color codes.", "Get request.\n @param [String] url The url.\n @return [String]\n The request response body.\n If the response is +302 Found+, returns the location in header.", "Fetch the ELF archiecture of +file+.\n @param [String] file The target ELF filename.\n @return [Symbol]\n Currently supports amd64, i386, arm, aarch64, and mips.\n @example\n Helper.architecture('/bin/cat')\n #=> :amd64", "Find objdump that supports architecture +arch+.\n @param [String] arch\n @return [String?]\n @example\n Helper.find_objdump(:amd64)\n #=> '/usr/bin/objdump'\n Helper.find_objdump(:aarch64)\n #=> '/usr/bin/aarch64-linux-gnu-objdump'", "Checks if the register is a stack-related pointer.\n @param [String] reg\n Register's name.\n @return [Boolean]", "Show the message of ask user to update gem.\n @return [void]", "Main method of CLI.\n @param [Array] argv\n Command line arguments.\n @return [Boolean]\n Whether the command execute successfully.\n @example\n CLI.work(%w[--help])\n # usage message\n #=> true\n CLI.work(%w[--version])\n # version message\n #=> true\n @example\n CLI.work([])\n # usage message\n #=> false\n @example\n CLI.work(%w[-b b417c0ba7cc5cf06d1d1bed6652cedb9253c60d0 -r])\n # 324293 324386 1090444\n #=> true", "Decides how to display fetched gadgets according to options.\n @param [Array] gadgets\n @param [String] libc_file\n @return [Boolean]", "Displays libc information given BuildID.\n @param [String] id\n @return [Boolean]\n +false+ is returned if no information found.\n @example\n CLI.info_build_id('b417c')\n # [OneGadget] Information of b417c:\n # spec/data/libc-2.27-b417c0ba7cc5cf06d1d1bed6652cedb9253c60d0.so\n \n # Advanced Micro Devices X86-64\n \n # GNU C Library (Ubuntu GLIBC 2.27-3ubuntu1) stable release version 2.27.\n # Copyright (C) 2018 Free Software Foundation, Inc.\n # This is free software; see the source for copying conditions.\n # There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A\n # PARTICULAR PURPOSE.\n # Compiled by GNU CC version 7.3.0.\n # libc ABIs: UNIQUE IFUNC\n # For bug reporting instructions, please see:\n # .\n #=> true", "The option parser.\n @return [OptionParser]", "Writes gadgets to stdout.\n @param [Array] gadgets\n @param [Boolean] raw\n In raw mode, only the offset of gadgets are printed.\n @return [true]", "Turns on logging\n\n class Foo\n include HTTParty\n logger Logger.new('http_logger'), :info, :apache\n end", "Allows setting http proxy information to be used\n\n class Foo\n include HTTParty\n http_proxy 'http://foo.com', 80, 'user', 'pass'\n end", "Allows setting default parameters to be appended to each request.\n Great for api keys and such.\n\n class Foo\n include HTTParty\n default_params api_key: 'secret', another: 'foo'\n end", "Allows setting HTTP headers to be used for each request.\n\n class Foo\n include HTTParty\n headers 'Accept' => 'text/html'\n end", "Allows setting a custom connection_adapter for the http connections\n\n @example\n class Foo\n include HTTParty\n connection_adapter Proc.new {|uri, options| ... }\n end\n\n @example provide optional configuration for your connection_adapter\n class Foo\n include HTTParty\n connection_adapter Proc.new {|uri, options| ... }, {foo: :bar}\n end\n\n @see HTTParty::ConnectionAdapter", "Allows making a get request to a url.\n\n class Foo\n include HTTParty\n end\n\n # Simple get with full url\n Foo.get('http://foo.com/resource.json')\n\n # Simple get with full url and query parameters\n # ie: http://foo.com/resource.json?limit=10\n Foo.get('http://foo.com/resource.json', query: {limit: 10})", "Allows making a post request to a url.\n\n class Foo\n include HTTParty\n end\n\n # Simple post with full url and setting the body\n Foo.post('http://foo.com/resources', body: {bar: 'baz'})\n\n # Simple post with full url using :query option,\n # which appends the parameters to the URI.\n Foo.post('http://foo.com/resources', query: {bar: 'baz'})", "Perform a PATCH request to a path", "Perform a PUT request to a path", "Perform a DELETE request to a path", "Perform a MOVE request to a path", "Perform a COPY request to a path", "Perform a HEAD request to a path", "Perform an OPTIONS request to a path", "Perform a MKCOL request to a path", "Returns a new array with the concatenated results of running block once for every element in enumerable.\n If no block is given, an enumerator is returned instead.\n\n @param enumerable [Enumerable]\n @return [Array, Enumerator]", "Returns a new array with the results of running block once for every element in enumerable.\n If no block is given, an enumerator is returned instead.\n\n @param enumerable [Enumerable]\n @return [Array, Enumerator]", "Converts query string to a hash\n\n @param query_string [String] The query string of a URL.\n @return [Hash] The query string converted to a hash (with symbol keys).\n @example Convert query string to a hash\n query_string_to_hash(\"foo=bar&baz=qux\") #=> {:foo=>\"bar\", :baz=>\"qux\"}", "Time when the object was created on Twitter\n\n @return [Time]", "JSON representation of the Access Token instance.\n\n @return [Hash] hash with token data", "Check whether the given plain text secret matches our stored secret\n\n @param input [#to_s] Plain secret provided by user\n (any object that responds to `#to_s`)\n\n @return [true] Whether the given secret matches the stored secret\n of this application.", "Determine whether +reuse_access_token+ and a non-restorable\n +token_secret_strategy+ have both been activated.\n\n In that case, disable reuse_access_token value and warn the user.", "Allow SSL context to be configured via settings, for Ruby >= 1.9\n Just returns openssl verify mode for Ruby 1.8.x", "Returns the attachment by filename or at index.\n\n mail.attachments['test.png'] = File.read('test.png')\n mail.attachments['test.jpg'] = File.read('test.jpg')\n\n mail.attachments['test.png'].filename #=> 'test.png'\n mail.attachments[1].filename #=> 'test.jpg'", "Find emails in a POP3 mailbox. Without any options, the 5 last received emails are returned.\n\n Possible options:\n what: last or first emails. The default is :first.\n order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.\n count: number of emails to retrieve. The default value is 10. A value of 1 returns an\n instance of Message, not an array of Message instances.\n delete_after_find: flag for whether to delete each retreived email after find. Default\n is false. Use #find_and_delete if you would like this to default to true.", "Delete all emails from a POP3 server", "Returns the address string of all the addresses in the address list", "Returns the formatted string of all the addresses in the address list", "Returns the display name of all the addresses in the address list", "Returns a list of decoded group addresses", "Returns a list of encoded group addresses", "Send the message via SMTP.\n The from and to attributes are optional. If not set, they are retrieve from the Message.", "Various special cases from random emails found that I am not going to change\n the parser for", "If the string supplied has PHRASE unsafe characters in it, will return the string quoted\n in double quotes, otherwise returns the string unmodified", "If the string supplied has TOKEN unsafe characters in it, will return the string quoted\n in double quotes, otherwise returns the string unmodified", "Capitalizes a string that is joined by hyphens correctly.\n\n Example:\n\n string = 'resent-from-field'\n capitalize_field( string ) #=> 'Resent-From-Field'", "Takes an underscored word and turns it into a class name\n\n Example:\n\n constantize(\"hello\") #=> \"Hello\"\n constantize(\"hello-there\") #=> \"HelloThere\"\n constantize(\"hello-there-mate\") #=> \"HelloThereMate\"", "Returns true if the object is considered blank.\n A blank includes things like '', ' ', nil,\n and arrays and hashes that have nothing in them.\n\n This logic is mostly shared with ActiveSupport's blank?", "Find emails in a IMAP mailbox. Without any options, the 10 last received emails are returned.\n\n Possible options:\n mailbox: mailbox to search the email(s) in. The default is 'INBOX'.\n what: last or first emails. The default is :first.\n order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.\n count: number of emails to retrieve. The default value is 10. A value of 1 returns an\n instance of Message, not an array of Message instances.\n read_only: will ensure that no writes are made to the inbox during the session. Specifically, if this is\n set to true, the code will use the EXAMINE command to retrieve the mail. If set to false, which\n is the default, a SELECT command will be used to retrieve the mail\n This is helpful when you don't want your messages to be set to read automatically. Default is false.\n delete_after_find: flag for whether to delete each retreived email after find. Default\n is false. Use #find_and_delete if you would like this to default to true.\n keys: are passed as criteria to the SEARCH command. They can either be a string holding the entire search string,\n or a single-dimension array of search keywords and arguments. Refer to [IMAP] section 6.4.4 for a full list\n The default is 'ALL'\n search_charset: charset to pass to IMAP server search. Omitted by default. Example: 'UTF-8' or 'ASCII'.", "Delete all emails from a IMAP mailbox", "Start an IMAP session and ensures that it will be closed in any case.", "3.6. Field definitions\n\n It is important to note that the header fields are not guaranteed to\n be in a particular order. They may appear in any order, and they\n have been known to be reordered occasionally when transported over\n the Internet. However, for the purposes of this standard, header\n fields SHOULD NOT be reordered when a message is transported or\n transformed. More importantly, the trace header fields and resent\n header fields MUST NOT be reordered, and SHOULD be kept in blocks\n prepended to the message. See sections 3.6.6 and 3.6.7 for more\n information.\n\n Populates the fields container with Field objects in the order it\n receives them in.\n\n Acceps an array of field string values, for example:\n\n h = Header.new\n h.fields = ['From: mikel@me.com', 'To: bob@you.com']", "Sets the FIRST matching field in the header to passed value, or deletes\n the FIRST field matched from the header if passed nil\n\n Example:\n\n h = Header.new\n h.fields = ['To: mikel@me.com', 'X-Mail-SPAM: 15', 'X-Mail-SPAM: 20']\n h['To'] = 'bob@you.com'\n h['To'] #=> 'bob@you.com'\n h['X-Mail-SPAM'] = '10000'\n h['X-Mail-SPAM'] # => ['15', '20', '10000']\n h['X-Mail-SPAM'] = nil\n h['X-Mail-SPAM'] # => nil", "Returns the default value of the field requested as a symbol.\n\n Each header field has a :default method which returns the most common use case for\n that field, for example, the date field types will return a DateTime object when\n sent :default, the subject, or unstructured fields will return a decoded string of\n their value, the address field types will return a single addr_spec or an array of\n addr_specs if there is more than one.", "Allows you to add an arbitrary header\n\n Example:\n\n mail['foo'] = '1234'\n mail['foo'].to_s #=> '1234'", "Method Missing in this implementation allows you to set any of the\n standard fields directly as you would the \"to\", \"subject\" etc.\n\n Those fields used most often (to, subject et al) are given their\n own method for ease of documentation and also to avoid the hook\n call to method missing.\n\n This will only catch the known fields listed in:\n\n Mail::Field::KNOWN_FIELDS\n\n as per RFC 2822, any ruby string or method name could pretty much\n be a field name, so we don't want to just catch ANYTHING sent to\n a message object and interpret it as a header.\n\n This method provides all three types of header call to set, read\n and explicitly set with the = operator\n\n Examples:\n\n mail.comments = 'These are some comments'\n mail.comments #=> 'These are some comments'\n\n mail.comments 'These are other comments'\n mail.comments #=> 'These are other comments'\n\n\n mail.date = 'Tue, 1 Jul 2003 10:52:37 +0200'\n mail.date.to_s #=> 'Tue, 1 Jul 2003 10:52:37 +0200'\n\n mail.date 'Tue, 1 Jul 2003 10:52:37 +0200'\n mail.date.to_s #=> 'Tue, 1 Jul 2003 10:52:37 +0200'\n\n\n mail.resent_msg_id = '<1234@resent_msg_id.lindsaar.net>'\n mail.resent_msg_id #=> '<1234@resent_msg_id.lindsaar.net>'\n\n mail.resent_msg_id '<4567@resent_msg_id.lindsaar.net>'\n mail.resent_msg_id #=> '<4567@resent_msg_id.lindsaar.net>'", "Adds a content type and charset if the body is US-ASCII\n\n Otherwise raises a warning", "Adds a part to the parts list or creates the part list", "Allows you to add a part in block form to an existing mail message object\n\n Example:\n\n mail = Mail.new do\n part :content_type => \"multipart/alternative\", :content_disposition => \"inline\" do |p|\n p.part :content_type => \"text/plain\", :body => \"test text\\nline #2\"\n p.part :content_type => \"text/html\", :body => \"test HTML \\nline #2\"\n end\n end", "Adds a file to the message. You have two options with this method, you can\n just pass in the absolute path to the file you want and Mail will read the file,\n get the filename from the path you pass in and guess the MIME media type, or you\n can pass in the filename as a string, and pass in the file content as a blob.\n\n Example:\n\n m = Mail.new\n m.add_file('/path/to/filename.png')\n\n m = Mail.new\n m.add_file(:filename => 'filename.png', :content => File.read('/path/to/file.jpg'))\n\n Note also that if you add a file to an existing message, Mail will convert that message\n to a MIME multipart email, moving whatever plain text body you had into its own text\n plain part.\n\n Example:\n\n m = Mail.new do\n body 'this is some text'\n end\n m.multipart? #=> false\n m.add_file('/path/to/filename.png')\n m.multipart? #=> true\n m.parts.first.content_type.content_type #=> 'text/plain'\n m.parts.last.content_type.content_type #=> 'image/png'\n\n See also #attachments", "Encodes the message, calls encode on all its parts, gets an email message\n ready to send", "Outputs an encoded string representation of the mail message including\n all headers, attachments, etc. This is an encoded email in US-ASCII,\n so it is able to be directly sent to an email server.", "see comments to body=. We take data and process it lazily", "Returns an array of comments that are in the email, or nil if there\n are no comments\n\n a = Address.new('Mikel Lindsaar (My email address) ')\n a.comments #=> ['My email address']\n\n b = Address.new('Mikel Lindsaar ')\n b.comments #=> nil", "Get all emails.\n\n Possible options:\n order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.", "Find emails in the mailbox, and then deletes them. Without any options, the\n five last received emails are returned.\n\n Possible options:\n what: last or first emails. The default is :first.\n order: order of emails returned. Possible values are :asc or :desc. Default value is :asc.\n count: number of emails to retrieve. The default value is 10. A value of 1 returns an\n instance of Message, not an array of Message instances.\n delete_after_find: flag for whether to delete each retreived email after find. Default\n is true. Call #find if you would like this to default to false.", "Insert the field in sorted order.\n\n Heavily based on bisect.insort from Python, which is:\n Copyright (C) 2001-2013 Python Software Foundation.\n Licensed under \n From ", "Updates all of the template catalogs and returns their filepaths.\n If there is a Rambafile in the current directory, it also updates all of the catalogs specified there.\n\n @return [Array] An array of filepaths to downloaded catalogs", "Clones a template catalog from a remote repository\n\n @param name [String] The name of the template catalog\n @param url [String] The url of the repository\n\n @return [Pathname] A filepath to the downloaded catalog", "Provides the appropriate strategy for a given template type", "Browses a given catalog and returns a template path\n\n @param catalog_path [Pathname] A path to a catalog\n @param template_name [String] A name of the template\n\n @return [Pathname] A path to a template, if found", "This method parses Rambafile, serializes templates hashes into model objects and install them", "Clears all of the currently installed templates", "Clones remote template catalogs to the local directory", "Create a XCScheme either from scratch or using an existing file\n\n @param [String] file_path\n The path of the existing .xcscheme file. If nil will create an empty scheme\n\n Convenience method to quickly add app and test targets to a new scheme.\n\n It will add the runnable_target to the Build, Launch and Profile actions\n and the test_target to the Build and Test actions\n\n @param [Xcodeproj::Project::Object::PBXAbstractTarget] runnable_target\n The target to use for the 'Run', 'Profile' and 'Analyze' actions\n\n @param [Xcodeproj::Project::Object::PBXAbstractTarget] test_target\n The target to use for the 'Test' action\n\n @param [Boolean] launch_target\n Determines if the runnable_target is launchable.", "Sets a runnable target to be the target of the launch action of the scheme.\n\n @param [Xcodeproj::Project::Object::AbstractTarget] build_target\n A target used by scheme in the launch step.", "Serializes the current state of the object to a \".xcscheme\" file.\n\n @param [String, Pathname] project_path\n The path where the \".xcscheme\" file should be stored.\n\n @param [String] name\n The name of the scheme, to have \".xcscheme\" appended.\n\n @param [Boolean] shared\n true => if the scheme must be a shared scheme (default value)\n false => if the scheme must be a user scheme\n\n @return [void]\n\n @example Saving a scheme\n scheme.save_as('path/to/Project.xcodeproj') #=> true", "Initializes the instance with the project stored in the `path` attribute.", "Converts the objects tree to a hash substituting the hash\n of the referenced to their UUID reference. As a consequence the hash of\n an object might appear multiple times and the information about their\n uniqueness is lost.\n\n This method is designed to work in conjunction with {Hash#recursive_diff}\n to provide a complete, yet readable, diff of two projects *not* affected\n by differences in UUIDs.\n\n @return [Hash] a hash representation of the project different from the\n plist one.", "Pre-generates the given number of UUIDs. Useful for optimizing\n performance when the rough number of objects that will be created is\n known in advance.\n\n @param [Integer] count\n the number of UUIDs that should be generated.\n\n @note This method might generated a minor number of uniques UUIDs than\n the given count, because some might be duplicated a thus will be\n discarded.\n\n @return [void]", "Returns the file reference for the given absolute path.\n\n @param [#to_s] absolute_path\n The absolute path of the file whose reference is needed.\n\n @return [PBXFileReference] The file reference.\n @return [Nil] If no file reference could be found.", "Checks the native target for any targets in the project\n that are dependent on the native target and would be\n embedded in it at build time\n\n @param [PBXNativeTarget] native target to check for\n embedded targets\n\n\n @return [Array] A list of all targets that\n are embedded in the passed in target", "Returns the native targets, in which the embedded target is\n embedded. This works by traversing the targets to find those\n where the target is a dependency.\n\n @param [PBXNativeTarget] native target that might be embedded\n in another target\n\n @return [Array] the native targets that host the\n embedded target", "Creates a new resource bundles target and adds it to the project.\n\n The target is configured for the given platform and its file reference it\n is added to the {products_group}.\n\n The target is pre-populated with common build settings\n\n @param [String] name\n the name of the resources bundle.\n\n @param [Symbol] platform\n the platform of the resources bundle. Can be `:ios` or `:osx`.\n\n @return [PBXNativeTarget] the target.", "Adds a new build configuration to the project and populates its with\n default settings according to the provided type.\n\n @param [String] name\n The name of the build configuration.\n\n @param [Symbol] type\n The type of the build configuration used to populate the build\n settings, must be :debug or :release.\n\n @return [XCBuildConfiguration] The new build configuration.", "Writes the serialized representation of the internal data to the given\n path.\n\n @param [Pathname] pathname\n The file where the data should be written to.\n\n @return [void]", "Returns a hash from the string representation of an Xcconfig file.\n\n @param [String] string\n The string representation of an xcconfig file.\n\n @return [Hash] the hash containing the xcconfig data.", "Merges the given attributes hash while ensuring values are not duplicated.\n\n @param [Hash] attributes\n The attributes hash to merge into @attributes.\n\n @return [void]", "Returns the key and the value described by the given line of an xcconfig.\n\n @param [String] line\n the line to process.\n\n @return [Array] A tuple where the first entry is the key and the second\n entry is the value.", "Generates test cases to compare two settings hashes.\n\n @param [Hash{String => String}] produced\n the produced build settings.\n\n @param [Hash{String => String}] expected\n the expected build settings.\n\n @param [#to_s] params\n the parameters used to construct the produced build settings.", "Load settings from fixtures\n\n @param [String] path\n the directory, where the fixture set is located.\n\n @param [Symbol] type\n the type, where the specific\n\n @param [Hash{String => String}]\n the build settings", "Saves the workspace at the given `xcworkspace` path.\n\n @param [String] path\n the path where to save the project.\n\n @return [void]", "Load all schemes from project\n\n @param [String] project_full_path\n project full path\n\n @return [void]", "Return container content.", "Return own toc content.", "called from strategy", "Take YAML +file+ and update parameter hash.", "Update parameters by merging from new parameter hash +config+.", "Write mimetype file to IO object +wobj+.", "Write opf file to IO object +wobj+.", "Write ncx file to IO object +wobj+. +indentarray+ defines prefix\n string for each level.", "Write container file to IO object +wobj+.", "Write colophon file to IO object +wobj+.", "Write own toc file to IO object +wobj+.", "Return ncx content. +indentarray+ has prefix marks for each level.", "Produce EPUB file +epubfile+.\n +basedir+ points the directory has contents.\n +tmpdir+ defines temporary directory.", "index -> italic", "load YAML files\n\n `inherit: [3.yml, 6.yml]` in 7.yml; `inherit: [1.yml, 2.yml]` in 3.yml; `inherit: [4.yml, 5.yml]` in 6.yml\n => 7.yml > 6.yml > 5.yml > 4.yml > 3.yml > 2.yml > 1.yml", "Complement other parameters by using file parameter.", "Choose an alternative, add a participant, and save the alternative choice on the user. This\n method is guaranteed to only run once, and will skip the alternative choosing process if run\n a second time.", "Set default program_name in performance_schema.session_connect_attrs\n and performance_schema.session_account_connect_attrs", "In MySQL 5.5+ error messages are always constructed server-side as UTF-8\n then returned in the encoding set by the `character_set_results` system\n variable.\n\n See http://dev.mysql.com/doc/refman/5.5/en/charset-errors.html for\n more context.\n\n Before MySQL 5.5 error message template strings are in whatever encoding\n is associated with the error message language.\n See http://dev.mysql.com/doc/refman/5.1/en/error-message-language.html\n for more information.\n\n The issue is that the user-data inserted in the message could potentially\n be in any encoding MySQL supports and is insert into the latin1, euckr or\n koi8r string raw. Meaning there's a high probability the string will be\n corrupt encoding-wise.\n\n See http://dev.mysql.com/doc/refman/5.1/en/charset-errors.html for\n more information.\n\n So in an attempt to make sure the error message string is always in a valid\n encoding, we'll assume UTF-8 and clean the string of anything that's not a\n valid UTF-8 character.\n\n Returns a valid UTF-8 string.", "Custom describe block that sets metadata to enable the rest of RAD\n\n resource \"Orders\", :meta => :data do\n # ...\n end\n\n Params:\n +args+:: Glob of RSpec's `describe` arguments\n +block+:: Block to pass into describe", "Defines a new sub configuration\n\n Automatically sets the `filter` to the group name, and the `docs_dir` to\n a subfolder of the parent's `doc_dir` named the group name.\n\n RspecApiDocumentation.configure do |config|\n config.docs_dir = \"doc/api\"\n config.define_group(:public) do |config|\n # Default values\n config.docs_dir = \"doc/api/public\"\n config.filter = :public\n end\n end\n\n Params:\n +name+:: String name of the group\n +block+:: Block configuration block", "Must be called after the backtrace cleaner.", "Rails relies on backtrace cleaner to set the application root directory\n filter. The problem is that the backtrace cleaner is initialized before\n this gem. This ensures that the value of `root` used by the filter\n is correct.", "Mass assigns attributes on the model.\n\n This is a version of +update_attributes+ that takes some extra options\n for internal use.\n\n ==== Attributes\n\n * +values+ - Hash of values to use to update the current attributes of\n the object.\n * +opts+ - Options for +StripeObject+ like an API key that will be reused\n on subsequent API calls.\n\n ==== Options\n\n * +:dirty+ - Whether values should be initiated as \"dirty\" (unsaved) and\n which applies only to new StripeObjects being initiated under this\n StripeObject. Defaults to true.", "Returns a hash of empty values for all the values that are in the given\n StripeObject.", "Iterates through each resource in all pages, making additional fetches to\n the API as necessary.\n\n Note that this method will make as many API calls as necessary to fetch\n all resources. For more granular control, please see +each+ and\n +next_page+.", "Formats a plugin \"app info\" hash into a string that we can tack onto the\n end of a User-Agent string where it'll be fairly prominent in places like\n the Dashboard. Note that this formatting has been implemented to match\n other libraries, and shouldn't be changed without universal consensus.", "Attempts to look at a response's error code and return an OAuth error if\n one matches. Will return `nil` if the code isn't recognized.", "Format ActiveRecord instance object.\n\n NOTE: by default only instance attributes (i.e. columns) are shown. To format\n ActiveRecord instance as regular object showing its instance variables and\n accessors use :raw => true option:\n\n ap record, :raw => true\n\n------------------------------------------------------------------------------", "Format Ripple instance object.\n\n NOTE: by default only instance attributes are shown. To format a Ripple document instance\n as a regular object showing its instance variables and accessors use :raw => true option:\n\n ap document, :raw => true\n\n------------------------------------------------------------------------------", "Format MongoMapper instance object.\n\n NOTE: by default only instance attributes (i.e. keys) are shown. To format\n MongoMapper instance as regular object showing its instance variables and\n accessors use :raw => true option:\n\n ap record, :raw => true\n\n------------------------------------------------------------------------------", "Use HTML colors and add default \"debug_dump\" class to the resulting HTML.", "Returns list of ancestors, starting from parent until root.\n\n subchild1.ancestors # => [child1, root]", "Returns all children and children of children", "if passed nil will use default seed classes", "Writing to the seed file. Takes in file handler and array of hashes with\n `header` and `content` keys", "Collecting fragment data and writing attachment files to disk", "Importing translations for given page. They look like `content.locale.html`", "Constructing frag attributes hash that can be assigned to page or translation\n also returning list of frag identifiers so we can destroy old ones", "Preparing fragment attachments. Returns hashes with file data for\n ActiveStorage and a list of ids of old attachements to destroy", "Same as cms_fragment_content but with cms tags expanded and rendered. Use\n it only if you know you got more stuff in the fragment content other than\n text because this is a potentially expensive call.", "Same as cms_snippet_content but cms tags will be expanded. Note that there\n is no page context, so snippet cannot contain fragment tags.", "Wrapper to deal with Kaminari vs WillPaginate", "HTTP methods with a body", "Checks if method_name is set in the attributes hash\n and returns true when found, otherwise proxies the\n call to the superclass.", "Overrides method_missing to check the attribute hash\n for resources matching method_name and proxies the call\n to the superclass if no match is found.", "Fetches the attributes for the specified resource from JIRA unless\n the resource is already expanded and the optional force reload flag\n is not set", "Sets the attributes hash from a HTTPResponse object from JIRA if it is\n not nil or is not a json response.", "Set the current attributes from a hash. If clobber is true, any existing\n hash values will be clobbered by the new hash, otherwise the hash will\n be deeply merged into attrs. The target paramater is for internal use only\n and should not be used.", "Note that we delegate almost all methods to the result of the que_target\n method, which could be one of a few things, depending on the circumstance.\n Run the job with error handling and cleanup logic. Optionally support\n overriding the args, because it's necessary when jobs are invoked from\n ActiveJob.", "To be overridden in subclasses.", "Explicitly check for the job id in these helpers, because it won't exist\n if we're running synchronously.", "Since we use a mutex, which is not reentrant, we have to be a little\n careful to not call a method that locks the mutex when we've already\n locked it. So, as a general rule, public methods handle locking the mutex\n when necessary, while private methods handle the actual underlying data\n changes. This lets us reuse those private methods without running into\n locking issues.", "Get ips for given name\n\n First the local resolver is used. On POSIX-systems /etc/hosts is used. On\n Windows C:\\Windows\\System32\\drivers\\etc\\hosts is used.\n\n @param [String] name\n The name which should be resolved.", "Add a new mime-type for a specific extension\n\n @param [Symbol] type File extension\n @param [String] value Mime type\n @return [void]", "Activate an extension, optionally passing in options.\n This method is typically used from a project's `config.rb`.\n\n @example Activate an extension with no options\n activate :lorem\n\n @example Activate an extension, with options\n activate :minify_javascript, inline: true\n\n @example Use a block to configure extension options\n activate :minify_javascript do |opts|\n opts.ignore += ['*-test.js']\n end\n\n @param [Symbol] ext_name The name of thed extension to activate\n @param [Hash] options Options to pass to the extension\n @yield [Middleman::Configuration::ConfigurationManager] Extension options that can be modified before the extension is initialized.\n @return [void]", "Initialize the Middleman project", "Clean up missing Tilt exts", "The extension task", "Extensions are instantiated when they are activated.\n @param [Middleman::Application] app The Middleman::Application instance\n @param [Hash] options_hash The raw options hash. Subclasses should not manipulate this directly - it will be turned into {#options}.\n @yield An optional block that can be used to customize options before the extension is activated.\n @yieldparam [Middleman::Configuration::ConfigurationManager] options Extension options\n @!method before_configuration\n Respond to the `before_configuration` event.\n If a `before_configuration` method is implemented, that method will be run before `config.rb` is run.\n @note Because most extensions are activated from within `config.rb`, they *will not run* any `before_configuration` hook.\n @!method after_configuration\n Respond to the `after_configuration` event.\n If an `after_configuration` method is implemented, that method will be run before `config.rb` is run.\n @!method before_build\n Respond to the `before_build` event.\n If an `before_build` method is implemented, that method will be run before the builder runs.\n @!method after_build\n Respond to the `after_build` event.\n If an `after_build` method is implemented, that method will be run after the builder runs.\n @!method ready\n Respond to the `ready` event.\n If an `ready` method is implemented, that method will be run after the app has finished booting up.\n @!method manipulate_resource_list(resources)\n Manipulate the resource list by transforming or adding {Sitemap::Resource}s.\n Sitemap manipulation is a powerful way of interacting with a project, since it can modify each {Sitemap::Resource} or generate new {Sitemap::Resources}. This method is used in a pipeline where each sitemap manipulator is run in turn, with each one being fed the output of the previous manipulator. See the source of built-in Middleman extensions like {Middleman::Extensions::DirectoryIndexes} and {Middleman::Extensions::AssetHash} for examples of how to use this.\n @note This method *must* return the full set of resources, because its return value will be used as the new sitemap.\n @see http://middlemanapp.com/advanced/sitemap/ Sitemap Documentation\n @see Sitemap::Store\n @see Sitemap::Resource\n @param [Array] resources A list of all the resources known to the sitemap.\n @return [Array] The transformed list of resources.", "The init task", "Copied from Bundler", "Core build Thor command\n @return [void]", "Handles incoming events from the builder.\n @param [Symbol] event_type The type of event.\n @param [String] target The event contents.\n @param [String] extra The extra information.\n @return [void]", "Find empty directories in the build folder and remove them.\n @return [Boolean]", "Core response method. We process the request, check with\n the sitemap, and return the correct file, response or status\n message.\n\n @param env\n @param [Rack::Request] req\n @param [Rack::Response] res", "Halt request and return 404", "Immediately send static file", "Start the server", "Allow layouts to be wrapped in the contents of other layouts.\n\n @param [String, Symbol] layout_name\n @return [void]", "Render a path with locs, opts and contents block.\n\n @api private\n @param [Middleman::SourceFile] file The file.\n @param [Hash] locs Template locals.\n @param [Hash] opts Template options.\n @param [Proc] block A block will be evaluated to return internal contents.\n @return [String] The resulting content string.\n Contract IsA['Middleman::SourceFile'], Hash, Hash, Maybe[Proc] => String", "Glob a directory and try to keep path encoding consistent.\n\n @param [String] path The glob path.\n @return [Array]", "Recursively builds entity instances\n out of all hashes in the response object", "Decrypts a value for the attribute specified using options evaluated in the current object's scope\n\n Example\n\n class User\n attr_accessor :secret_key\n attr_encrypted :email, key: :secret_key\n\n def initialize(secret_key)\n self.secret_key = secret_key\n end\n end\n\n @user = User.new('some-secret-key')\n @user.decrypt(:email, 'SOME_ENCRYPTED_EMAIL_STRING')", "Encrypts a value for the attribute specified using options evaluated in the current object's scope\n\n Example\n\n class User\n attr_accessor :secret_key\n attr_encrypted :email, key: :secret_key\n\n def initialize(secret_key)\n self.secret_key = secret_key\n end\n end\n\n @user = User.new('some-secret-key')\n @user.encrypt(:email, 'test@example.com')", "Copies the class level hash of encrypted attributes with virtual attribute names as keys\n and their corresponding options as values to the instance", "Change color of string\n\n Examples:\n\n puts \"This is blue\".colorize(:blue)\n puts \"This is light blue\".colorize(:light_blue)\n puts \"This is also blue\".colorize(:color => :blue)\n puts \"This is light blue with red background\".colorize(:color => :light_blue, :background => :red)\n puts \"This is light blue with red background\".colorize(:light_blue ).colorize( :background => :red)\n puts \"This is blue text on red\".blue.on_red\n puts \"This is red on blue\".colorize(:red).on_blue\n puts \"This is red on blue and underline\".colorize(:red).on_blue.underline\n puts \"This is blue text on red\".blue.on_red.blink\n puts \"This is uncolorized\".blue.on_red.uncolorize", "Return true if string is colorized", "Set color from params", "Set colors from params hash", "Generate color and on_color methods", "User Code Block", "consuming a terminal may set off a series of reduces before the terminal\n is shifted", "Sequence of state transitions which would be taken when starting\n from 'state', then following the RHS of 'rule' right to the end", "traverse a directed graph\n each entry in 'bitmap' corresponds to a graph node\n after the traversal, the bitmap for each node will be the union of its\n original value, and ALL the values for all the nodes which are reachable\n from it", "Like `transition_graph`, but rather than vectors labeled with NTs, we\n have vectors labeled with the shortest series of terminals and reduce\n operations which could take us through the same transition", "sometimes a Rule is instantiated before the target is actually known\n it may be given a \"placeholder\" target first, which is later replaced\n with the real one", "If an instance of this NT comes next, then what rules could we be\n starting?", "Generates an image tag for the given attachment, adding appropriate\n classes and optionally falling back to the given fallback image if there\n is no file attached.\n\n Returns `nil` if there is no file attached and no fallback specified.\n\n @param [String] fallback The path to an image asset to be used as a fallback\n @param [Hash] options Additional options for the image tag\n @see #attachment_url\n @return [ActiveSupport::SafeBuffer, nil] The generated image tag", "Generates a hidden form field which tracks the id of the file in the cache\n before it is permanently stored.\n\n @param object_name The name of the object to generate a field for\n @param method The name of the field\n @param [Hash] options\n @option options [Object] object Set by the form builder\n @return [ActiveSupport::SafeBuffer] The generated hidden form field", "Macro which generates accessors in pure Ruby classes for assigning\n multiple attachments at once. This is primarily useful together with\n multiple file uploads. There is also an Active Record version of\n this macro.\n\n The name of the generated accessors will be the name of the association\n (represented by an attribute accessor) and the name of the attachment in\n the associated class. So if a `Post` accepts attachments for `images`, and\n the attachment in the `Image` class is named `file`, then the accessors will\n be named `images_files`.\n\n @example in associated class\n class Document\n extend Refile::Attachment\n attr_accessor :file_id\n\n attachment :file\n\n def initialize(attributes = {})\n self.file = attributes[:file]\n end\n end\n\n @example in class\n class Post\n extend Refile::Attachment\n include ActiveModel::Model\n\n attr_accessor :documents\n\n accepts_attachments_for :documents, accessor_prefix: 'documents_files', collection_class: Document\n\n def initialize(attributes = {})\n @documents = attributes[:documents] || []\n end\n end\n\n @example in form\n <%= form_for @post do |form| %>\n <%= form.attachment_field :documents_files, multiple: true %>\n <% end %>\n\n @param [Symbol] collection_name Name of the association\n @param [Class] collection_class Associated class\n @param [String] accessor_prefix Name of the generated accessors\n @param [Symbol] attachment Name of the attachment in the associated class\n @param [Boolean] append If true, new files are appended instead of replacing the entire list of associated classes.\n @return [void]", "Downloads the file to a Tempfile on disk and returns this tempfile.\n\n @example\n file = backend.upload(StringIO.new(\"hello\"))\n tempfile = file.download\n File.read(tempfile.path) # => \"hello\"\n\n @return [Tempfile] a tempfile with the file's content", "Builds a serializable hash from the response data.\n\n @return [Hash] hash that represents this response\n and can be easily serialized.\n @see Response.from_hash", "Adds a callback that will be executed around each HTTP request.\n\n @example\n VCR.configure do |c|\n c.around_http_request(lambda {|r| r.uri =~ /api.geocoder.com/}) do |request|\n # extract an address like \"1700 E Pine St, Seattle, WA\"\n # from a query like \"address=1700+E+Pine+St%2C+Seattle%2C+WA\"\n address = CGI.unescape(URI(request.uri).query.split('=').last)\n VCR.use_cassette(\"geocoding/#{address}\", &request)\n end\n end\n\n @yield the callback\n @yieldparam request [VCR::Request::FiberAware] the request that is being made\n @raise [VCR::Errors::NotSupportedError] if the fiber library cannot be loaded.\n @param filters [optional splat of #to_proc] one or more filters to apply.\n The objects provided will be converted to procs using `#to_proc`. If provided,\n the callback will only be invoked if these procs all return `true`.\n @note This method can only be used on ruby interpreters that support\n fibers (i.e. 1.9+). On 1.8 you can use separate `before_http_request` and\n `after_http_request` hooks.\n @note You _must_ call `request.proceed` or pass the request as a proc on to a\n method that yields to a block (i.e. `some_method(&request)`).\n @see #before_http_request\n @see #after_http_request", "Define a country's rules.\n\n Use the other DSL methods to define the country's rules.\n\n @param [String] country_code The country code of the country.\n @param [Phony::CountryCodes] definition Rules for this country.\n\n @return Undefined.\n\n @example Add a country with country code 27.\n country '27', # CC, followed by rules, for example fixed(2) >> ...", "National matcher & splitters.\n\n By default, a fixed length NDC\n uses a zero prefix when formatted\n with format :national.\n\n @param [Fixnum] length The length of the fixed length NDC.\n @param [Hash] options An options hash (set zero: false to not add a zero on format :national).\n\n @return NationalSplitters::Fixed A fixed length national splitter.\n\n @example France. Uses a fixed NDC of size 1.\n country '33', fixed(1) >> split(2,2,2,2)", "Add the given country to the mapping under the\n given country code.", "Splits this number into cc, ndc and locally split number parts.", "Format the number.", "Is this number plausible?", "Is the given number a vanity number?", "Split off the country and the cc, and also return the national number part.", "A number is split with the code handlers as given in the initializer.\n\n Note: If the ndc is nil, it will not return it.\n\n @return [Trunk, String (ndc), Array (national pieces)]", "Format the number, given the national part of it.", "Removes 0s from partially normalized numbers\n such as 410443643533.\n\n Example:\n 410443643533 -> 41443643533\n\n In some cases it doesn't, like Italy.", "Tests for plausibility of this national number.", "Merge the other criteria into this one.\n\n @example Merge another criteria into this criteria.\n criteria.merge(Person.where(name: \"bob\"))\n\n @param [ Criteria ] other The criteria to merge in.\n\n @return [ Criteria ] The merged criteria.\n\n @since 3.0.0", "Overriden to include _type in the fields.\n\n @example Limit the fields returned from the database.\n Band.only(:name)\n\n @param [ Array ] args The names of the fields.\n\n @return [ Criteria ] The cloned criteria.\n\n @since 1.0.0", "Set the read preference for the criteria.\n\n @example Set the read preference.\n criteria.read(mode: :primary_preferred)\n\n @param [ Hash ] value The mode preference.\n\n @return [ Criteria ] The cloned criteria.\n\n @since 5.0.0", "Returns true if criteria responds to the given method.\n\n @example Does the criteria respond to the method?\n crtiteria.respond_to?(:each)\n\n @param [ Symbol ] name The name of the class method on the +Document+.\n @param [ true, false ] include_private Whether to include privates.\n\n @return [ true, false ] If the criteria responds to the method.", "Are documents in the query missing, and are we configured to raise an\n error?\n\n @api private\n\n @example Check for missing documents.\n criteria.check_for_missing_documents!([], [ 1 ])\n\n @param [ Array ] result The result.\n @param [ Array ] ids The ids.\n\n @raise [ Errors::DocumentNotFound ] If none are found and raising an\n error.\n\n @since 3.0.0", "Clone or dup the current +Criteria+. This will return a new criteria with\n the selector, options, klass, embedded options, etc intact.\n\n @api private\n\n @example Clone a criteria.\n criteria.clone\n\n @example Dup a criteria.\n criteria.dup\n\n @param [ Criteria ] other The criteria getting cloned.\n\n @return [ nil ] nil.\n\n @since 1.0.0", "Get the selector for type selection.\n\n @api private\n\n @example Get a type selection hash.\n criteria.type_selection\n\n @return [ Hash ] The type selection.\n\n @since 3.0.3", "Takes the provided selector and atomic operations and replaces the\n indexes of the embedded documents with the positional operator when\n needed.\n\n @note The only time we can accurately know when to use the positional\n operator is at the exact time we are going to persist something. So\n we can tell by the selector that we are sending if it is actually\n possible to use the positional operator at all. For example, if the\n selector is: { \"_id\" => 1 }, then we could not use the positional\n operator for updating embedded documents since there would never be a\n match - we base whether we can based on the number of levels deep the\n selector goes, and if the id values are not nil.\n\n @example Process the operations.\n positionally(\n { \"_id\" => 1, \"addresses._id\" => 2 },\n { \"$set\" => { \"addresses.0.street\" => \"hobrecht\" }}\n )\n\n @param [ Hash ] selector The selector.\n @param [ Hash ] operations The update operations.\n @param [ Hash ] processed The processed update operations.\n\n @return [ Hash ] The new operations.\n\n @since 3.1.0", "Add the association to the touchable associations if the touch option was\n provided.\n\n @example Add the touchable.\n Model.define_touchable!(assoc)\n\n @param [ Association ] association The association metadata.\n\n @return [ Class ] The model class.\n\n @since 3.0.0", "Gets the default Mongoid logger - stdout.\n\n @api private\n\n @example Get the default logger.\n Loggable.default_logger\n\n @return [ Logger ] The default logger.\n\n @since 3.0.0", "When cloning, if the document has localized fields we need to ensure they\n are properly processed in the clone.\n\n @api private\n\n @example Process localized attributes.\n model.process_localized_attributes(attributes)\n\n @param [ Hash ] attrs The attributes.\n\n @since 3.0.20", "Get the document selector with the defined shard keys.\n\n @example Get the selector for the shard keys.\n person.shard_key_selector\n\n @return [ Hash ] The shard key selector.\n\n @since 2.0.0", "Reloads the +Document+ attributes from the database. If the document has\n not been saved then an error will get raised if the configuration option\n was set. This can reload root documents or embedded documents.\n\n @example Reload the document.\n person.reload\n\n @raise [ Errors::DocumentNotFound ] If the document was deleted.\n\n @return [ Document ] The document, reloaded.\n\n @since 1.0.0", "Reload the root document.\n\n @example Reload the document.\n document.reload_root_document\n\n @return [ Hash ] The reloaded attributes.\n\n @since 2.3.2", "Reload the embedded document.\n\n @example Reload the document.\n document.reload_embedded_document\n\n @return [ Hash ] The reloaded attributes.\n\n @since 2.3.2", "Extract only the desired embedded document from the attributes.\n\n @example Extract the embedded document.\n document.extract_embedded_attributes(attributes)\n\n @param [ Hash ] attributes The document in the db.\n\n @return [ Hash ] The document's extracted attributes.\n\n @since 2.3.2", "Determine if an attribute is present.\n\n @example Is the attribute present?\n person.attribute_present?(\"title\")\n\n @param [ String, Symbol ] name The name of the attribute.\n\n @return [ true, false ] True if present, false if not.\n\n @since 1.0.0", "Read a value from the document attributes. If the value does not exist\n it will return nil.\n\n @example Read an attribute.\n person.read_attribute(:title)\n\n @example Read an attribute (alternate syntax.)\n person[:title]\n\n @param [ String, Symbol ] name The name of the attribute to get.\n\n @return [ Object ] The value of the attribute.\n\n @since 1.0.0", "Read a value from the attributes before type cast. If the value has not\n yet been assigned then this will return the attribute's existing value\n using read_raw_attribute.\n\n @example Read an attribute before type cast.\n person.read_attribute_before_type_cast(:price)\n\n @param [ String, Symbol ] name The name of the attribute to get.\n\n @return [ Object ] The value of the attribute before type cast, if\n available. Otherwise, the value of the attribute.\n\n @since 3.1.0", "Remove a value from the +Document+ attributes. If the value does not exist\n it will fail gracefully.\n\n @example Remove the attribute.\n person.remove_attribute(:title)\n\n @param [ String, Symbol ] name The name of the attribute to remove.\n\n @raise [ Errors::ReadonlyAttribute ] If the field cannot be removed due\n to being flagged as reaodnly.\n\n @since 1.0.0", "Write a single attribute to the document attribute hash. This will\n also fire the before and after update callbacks, and perform any\n necessary typecasting.\n\n @example Write the attribute.\n person.write_attribute(:title, \"Mr.\")\n\n @example Write the attribute (alternate syntax.)\n person[:title] = \"Mr.\"\n\n @param [ String, Symbol ] name The name of the attribute to update.\n @param [ Object ] value The value to set for the attribute.\n\n @since 1.0.0", "Determine if the attribute is missing from the document, due to loading\n it from the database with missing fields.\n\n @example Is the attribute missing?\n document.attribute_missing?(\"test\")\n\n @param [ String ] name The name of the attribute.\n\n @return [ true, false ] If the attribute is missing.\n\n @since 4.0.0", "Return the typecasted value for a field.\n\n @example Get the value typecasted.\n person.typed_value_for(:title, :sir)\n\n @param [ String, Symbol ] key The field name.\n @param [ Object ] value The uncast value.\n\n @return [ Object ] The cast value.\n\n @since 1.0.0", "Validates an attribute value. This provides validation checking if\n the value is valid for given a field.\n For now, only Hash and Array fields are validated.\n\n @param [ String, Symbol ] access The name of the attribute to validate.\n @param [ Object ] value The to be validated.\n\n @since 3.0.10", "Builds a new +Document+ from the supplied attributes.\n\n @example Build the document.\n Mongoid::Factory.build(Person, { \"name\" => \"Durran\" })\n\n @param [ Class ] klass The class to instantiate from if _type is not present.\n @param [ Hash ] attributes The document attributes.\n\n @return [ Document ] The instantiated document.", "Builds a new +Document+ from the supplied attributes loaded from the\n database.\n\n If a criteria object is given, it is used in two ways:\n 1. If the criteria has a list of fields specified via #only,\n only those fields are populated in the returned document.\n 2. If the criteria has a referencing association (i.e., this document\n is being instantiated as an association of another document),\n the other document is also populated in the returned document's\n reverse association, if one exists.\n\n @example Build the document.\n Mongoid::Factory.from_db(Person, { \"name\" => \"Durran\" })\n\n @param [ Class ] klass The class to instantiate from if _type is not present.\n @param [ Hash ] attributes The document attributes.\n @param [ Criteria ] criteria Optional criteria object.\n @param [ Hash ] selected_fields Fields which were retrieved via\n #only. If selected_fields are specified, fields not listed in it\n will not be accessible in the returned document.\n\n @return [ Document ] The instantiated document.", "Add the document as an atomic pull.\n\n @example Add the atomic pull.\n person.add_atomic_pull(address)\n\n @param [ Document ] document The embedded document to pull.\n\n @since 2.2.0", "Add an atomic unset for the document.\n\n @example Add an atomic unset.\n document.add_atomic_unset(doc)\n\n @param [ Document ] document The child document.\n\n @return [ Array ] The children.\n\n @since 3.0.0", "Get all the atomic updates that need to happen for the current\n +Document+. This includes all changes that need to happen in the\n entire hierarchy that exists below where the save call was made.\n\n @note MongoDB does not allow \"conflicting modifications\" to be\n performed in a single operation. Conflicting modifications are\n detected by the 'haveConflictingMod' function in MongoDB.\n Examination of the code suggests that two modifications (a $set\n and a $push with $each, for example) conflict if:\n (1) the key paths being modified are equal.\n (2) one key path is a prefix of the other.\n So a $set of 'addresses.0.street' will conflict with a $push and $each\n to 'addresses', and we will need to split our update into two\n pieces. We do not, however, attempt to match MongoDB's logic\n exactly. Instead, we assume that two updates conflict if the\n first component of the two key paths matches.\n\n @example Get the updates that need to occur.\n person.atomic_updates(children)\n\n @return [ Hash ] The updates and their modifiers.\n\n @since 2.1.0", "Get all the attributes that need to be pulled.\n\n @example Get the pulls.\n person.atomic_pulls\n\n @return [ Array ] The $pullAll operations.\n\n @since 2.2.0", "Get all the attributes that need to be unset.\n\n @example Get the unsets.\n person.atomic_unsets\n\n @return [ Array ] The $unset operations.\n\n @since 2.2.0", "Generates the atomic updates in the correct order.\n\n @example Generate the updates.\n model.generate_atomic_updates(mods, doc)\n\n @param [ Modifiers ] mods The atomic modifications.\n @param [ Document ] doc The document to update for.\n\n @since 2.2.0", "Initialize the persistence context object.\n\n @example Create a new persistence context.\n PersistenceContext.new(model, collection: 'other')\n\n @param [ Object ] object The class or model instance for which a persistence context\n should be created.\n @param [ Hash ] opts The persistence context options.\n\n @since 6.0.0\n Get the collection for this persistence context.\n\n @example Get the collection for this persistence context.\n context.collection\n\n @param [ Object ] parent The parent object whose collection name is used\n instead of this persistence context's collection name.\n\n @return [ Mongo::Collection ] The collection for this persistence\n context.\n\n @since 6.0.0", "Get the client for this persistence context.\n\n @example Get the client for this persistence context.\n context.client\n\n @return [ Mongo::Client ] The client for this persistence\n context.\n\n @since 6.0.0", "Get all the changes for the document.\n\n @example Get all the changes.\n model.changes\n\n @return [ Hash ] The changes.\n\n @since 2.4.0", "Call this method after save, so the changes can be properly switched.\n\n This will unset the memoized children array, set new record to\n false, set the document as validated, and move the dirty changes.\n\n @example Move the changes to previous.\n person.move_changes\n\n @since 2.1.0", "Get the old and new value for the provided attribute.\n\n @example Get the attribute change.\n model.attribute_change(\"name\")\n\n @param [ String ] attr The name of the attribute.\n\n @return [ Array ] The old and new values.\n\n @since 2.1.0", "Determine if a specific attribute has changed.\n\n @example Has the attribute changed?\n model.attribute_changed?(\"name\")\n\n @param [ String ] attr The name of the attribute.\n\n @return [ true, false ] Whether the attribute has changed.\n\n @since 2.1.6", "Get whether or not the field has a different value from the default.\n\n @example Is the field different from the default?\n model.attribute_changed_from_default?\n\n @param [ String ] attr The name of the attribute.\n\n @return [ true, false ] If the attribute differs.\n\n @since 3.0.0", "Get the previous value for the attribute.\n\n @example Get the previous value.\n model.attribute_was(\"name\")\n\n @param [ String ] attr The attribute name.\n\n @since 2.4.0", "Flag an attribute as going to change.\n\n @example Flag the attribute.\n model.attribute_will_change!(\"name\")\n\n @param [ String ] attr The name of the attribute.\n\n @return [ Object ] The old value.\n\n @since 2.3.0", "Set the attribute back to its old value.\n\n @example Reset the attribute.\n model.reset_attribute!(\"name\")\n\n @param [ String ] attr The name of the attribute.\n\n @return [ Object ] The old value.\n\n @since 2.4.0", "Use the application configuration to get every model and require it, so\n that indexing and inheritance work in both development and production\n with the same results.\n\n @example Load all the application models.\n Rails::Mongoid.load_models(app)\n\n @param [ Application ] app The rails application.", "I don't want to mock out kernel for unit testing purposes, so added this\n method as a convenience.\n\n @example Load the model.\n Mongoid.load_model(\"/mongoid/behavior\")\n\n @param [ String ] file The base filename.\n\n @since 2.0.0.rc.3", "Applies a single default value for the given name.\n\n @example Apply a single default.\n model.apply_default(\"name\")\n\n @param [ String ] name The name of the field.\n\n @since 2.4.0", "Post process the persistence operation.\n\n @api private\n\n @example Post process the persistence operation.\n document.post_process_persist(true)\n\n @param [ Object ] result The result of the operation.\n @param [ Hash ] options The options.\n\n @return [ true ] true.\n\n @since 4.0.0", "Process the atomic operations - this handles the common behavior of\n iterating through each op, getting the aliased field name, and removing\n appropriate dirty changes.\n\n @api private\n\n @example Process the atomic operations.\n document.process_atomic_operations(pulls) do |field, value|\n ...\n end\n\n @param [ Hash ] operations The atomic operations.\n\n @return [ Hash ] The operations.\n\n @since 4.0.0", "If we are in an atomically block, add the operations to the delayed group,\n otherwise persist immediately.\n\n @api private\n\n @example Persist immediately or delay the operations.\n document.persist_or_delay_atomic_operation(ops)\n\n @param [ Hash ] operation The operation.\n\n @since 4.0.0", "Persist the atomic operations.\n\n @api private\n\n @example Persist the atomic operations.\n persist_atomic_operations(ops)\n\n @param [ Hash ] operations The atomic operations.\n\n @since 4.0.0", "Gets the document as a serializable hash, used by ActiveModel's JSON\n serializer.\n\n @example Get the serializable hash.\n document.serializable_hash\n\n @example Get the serializable hash with options.\n document.serializable_hash(:include => :addresses)\n\n @param [ Hash ] options The options to pass.\n\n @option options [ Symbol ] :include What associations to include.\n @option options [ Symbol ] :only Limit the fields to only these.\n @option options [ Symbol ] :except Dont include these fields.\n @option options [ Symbol ] :methods What methods to include.\n\n @return [ Hash ] The document, ready to be serialized.\n\n @since 2.0.0.rc.6", "Get the names of all fields that will be serialized.\n\n @api private\n\n @example Get all the field names.\n document.send(:field_names)\n\n @return [ Array ] The names of the fields.\n\n @since 3.0.0", "Serialize a single attribute. Handles associations, fields, and dynamic\n attributes.\n\n @api private\n\n @example Serialize the attribute.\n document.serialize_attribute({}, \"id\" , [ \"id\" ])\n\n @param [ Hash ] attrs The attributes.\n @param [ String ] name The attribute name.\n @param [ Array ] names The names of all attributes.\n @param [ Hash ] options The options.\n\n @return [ Object ] The attribute.\n\n @since 3.0.0", "For each of the provided include options, get the association needed and\n provide it in the hash.\n\n @example Serialize the included associations.\n document.serialize_relations({}, :include => :addresses)\n\n @param [ Hash ] attributes The attributes to serialize.\n @param [ Hash ] options The serialization options.\n\n @option options [ Symbol ] :include What associations to include\n @option options [ Symbol ] :only Limit the fields to only these.\n @option options [ Symbol ] :except Dont include these fields.\n\n @since 2.0.0.rc.6", "Since the inclusions can be a hash, symbol, or array of symbols, this is\n provided as a convenience to parse out the names.\n\n @example Get the association names.\n document.relation_names(:include => [ :addresses ])\n\n @param [ Hash, Symbol, Array ] inclusions The inclusions.\n\n @return [ Array ] The names of the included associations.\n\n @since 2.0.0.rc.6", "Since the inclusions can be a hash, symbol, or array of symbols, this is\n provided as a convenience to parse out the options.\n\n @example Get the association options.\n document.relation_names(:include => [ :addresses ])\n\n @param [ Hash, Symbol, Array ] inclusions The inclusions.\n @param [ Hash ] options The options.\n @param [ Symbol ] name The name of the association.\n\n @return [ Hash ] The options for the association.\n\n @since 2.0.0.rc.6", "Get the current Mongoid scope.\n\n @example Get the scope.\n Threaded.current_scope(klass)\n Threaded.current_scope\n\n @param [ Klass ] klass The class type of the scope.\n\n @return [ Criteria ] The scope.\n\n @since 5.0.0", "Set the current Mongoid scope. Safe for multi-model scope chaining.\n\n @example Set the scope.\n Threaded.current_scope(scope, klass)\n\n @param [ Criteria ] scope The current scope.\n @param [ Class ] klass The current model class.\n\n @return [ Criteria ] The scope.\n\n @since 5.0.1", "Apply the default scoping to the attributes of the document, as long as\n they are not complex queries.\n\n @api private\n\n @example Apply the default scoping.\n document.apply_default_scoping\n\n @return [ true, false ] If default scoping was applied.\n\n @since 4.0.0", "Overrides the default ActiveModel behavior since we need to handle\n validations of associations slightly different than just calling the\n getter.\n\n @example Read the value.\n person.read_attribute_for_validation(:addresses)\n\n @param [ Symbol ] attr The name of the field or association.\n\n @return [ Object ] The value of the field or the association.\n\n @since 2.0.0.rc.1", "Collect all the children of this document.\n\n @example Collect all the children.\n document.collect_children\n\n @return [ Array ] The children.\n\n @since 2.4.0", "Remove a child document from this parent. If an embeds one then set to\n nil, otherwise remove from the embeds many.\n\n This is called from the +RemoveEmbedded+ persistence command.\n\n @example Remove the child.\n document.remove_child(child)\n\n @param [ Document ] child The child (embedded) document to remove.\n\n @since 2.0.0.beta.1", "After children are persisted we can call this to move all their changes\n and flag them as persisted in one call.\n\n @example Reset the children.\n document.reset_persisted_children\n\n @return [ Array ] The children.\n\n @since 2.1.0", "Returns an instance of the specified class with the attributes,\n errors, and embedded documents of the current document.\n\n @example Return a subclass document as a superclass instance.\n manager.becomes(Person)\n\n @raise [ ArgumentError ] If the class doesn't include Mongoid::Document\n\n @param [ Class ] klass The class to become.\n\n @return [ Document ] An instance of the specified class.\n\n @since 2.0.0", "Convenience method for iterating through the loaded associations and\n reloading them.\n\n @example Reload the associations.\n document.reload_relations\n\n @return [ Hash ] The association metadata.\n\n @since 2.1.6", "Get an array of inspected fields for the document.\n\n @api private\n\n @example Inspect the defined fields.\n document.inspect_fields\n\n @return [ String ] An array of pretty printed field values.\n\n @since 1.0.0", "Run the callbacks for the document. This overrides active support's\n functionality to cascade callbacks to embedded documents that have been\n flagged as such.\n\n @example Run the callbacks.\n run_callbacks :save do\n save!\n end\n\n @param [ Symbol ] kind The type of callback to execute.\n @param [ Array ] args Any options.\n\n @return [ Document ] The document\n\n @since 2.3.0", "Get all the child embedded documents that are flagged as cascadable.\n\n @example Get all the cascading children.\n document.cascadable_children(:update)\n\n @param [ Symbol ] kind The type of callback.\n\n @return [ Array ] The children.\n\n @since 2.3.0", "Determine if the child should fire the callback.\n\n @example Should the child fire the callback?\n document.cascadable_child?(:update, doc)\n\n @param [ Symbol ] kind The type of callback.\n @param [ Document ] child The child document.\n\n @return [ true, false ] If the child should fire the callback.\n\n @since 2.3.0", "Connect to the provided database name on the default client.\n\n @note Use only in development or test environments for convenience.\n\n @example Set the database to connect to.\n config.connect_to(\"mongoid_test\")\n\n @param [ String ] name The database name.\n\n @since 3.0.0", "Load the settings from a compliant mongoid.yml file. This can be used for\n easy setup with frameworks other than Rails.\n\n @example Configure Mongoid.\n Mongoid.load!(\"/path/to/mongoid.yml\")\n\n @param [ String ] path The path to the file.\n @param [ String, Symbol ] environment The environment to load.\n\n @since 2.0.1", "Register a model in the application with Mongoid.\n\n @example Register a model.\n config.register_model(Band)\n\n @param [ Class ] klass The model to register.\n\n @since 3.1.0", "From a hash of settings, load all the configuration.\n\n @example Load the configuration.\n config.load_configuration(settings)\n\n @param [ Hash ] settings The configuration settings.\n\n @since 3.1.0", "Truncate all data in all collections, but not the indexes.\n\n @example Truncate all collection data.\n Mongoid::Config.truncate!\n\n @note This will be slower than purge!\n\n @return [ true ] true.\n\n @since 2.0.2", "Set the configuration options. Will validate each one individually.\n\n @example Set the options.\n config.options = { raise_not_found_error: true }\n\n @param [ Hash ] options The configuration options.\n\n @since 3.0.0", "Responds to unauthorized requests in a manner fitting the request format.\n `js`, `json`, and `xml` requests will receive a 401 with no body. All\n other formats will be redirected appropriately and can optionally have the\n flash message set.\n\n When redirecting, the originally requested url will be stored in the\n session (`session[:return_to]`), allowing it to be used as a redirect url\n once the user has successfully signed in.\n\n If there is a signed in user, the request will be redirected according to\n the value returned from {#url_after_denied_access_when_signed_in}.\n\n If there is no signed in user, the request will be redirected according to\n the value returned from {#url_after_denied_access_when_signed_out}.\n For the exact redirect behavior, see {#redirect_request}.\n\n @param [String] flash_message", "Reads previously existing sessions from a cookie and maintains the cookie\n on each response.", "Send the user a file.\n @param file [File] The file to send to the user\n @param caption [String] The caption of the file being sent\n @param filename [String] Overrides the filename of the uploaded file\n @param spoiler [true, false] Whether or not this file should appear as a spoiler.\n @return [Message] the message sent to this user.\n @example Send a file from disk\n user.send_file(File.open('rubytaco.png', 'r'))", "Set the user's presence data\n @note for internal use only\n @!visibility private", "Checks whether this user can do the particular action, regardless of whether it has the permission defined,\n through for example being the server owner or having the Manage Roles permission\n @param action [Symbol] The permission that should be checked. See also {Permissions::FLAGS} for a list.\n @param channel [Channel, nil] If channel overrides should be checked too, this channel specifies where the overrides should be checked.\n @example Check if the bot can send messages to a specific channel in a server.\n bot_profile = bot.profile.on(event.server)\n can_send_messages = bot_profile.permission?(:send_messages, channel)\n @return [true, false] whether or not this user has the permission.", "Sets this channels parent category\n @param channel [Channel, #resolve_id] the target category channel\n @raise [ArgumentError] if the target channel isn't a category", "Sorts this channel's position to follow another channel.\n @param other [Channel, #resolve_id, nil] The channel below which this channel should be sorted. If the given\n channel is a category, this channel will be sorted at the top of that category. If it is `nil`, the channel will\n be sorted at the top of the channel list.\n @param lock_permissions [true, false] Whether the channel's permissions should be synced to the category's", "Sets whether this channel is NSFW\n @param nsfw [true, false]\n @raise [ArguementError] if value isn't one of true, false", "Sends a temporary message to this channel.\n @param content [String] The content to send. Should not be longer than 2000 characters or it will result in an error.\n @param timeout [Float] The amount of time in seconds after which the message sent will be deleted.\n @param tts [true, false] Whether or not this message should be sent using Discord text-to-speech.\n @param embed [Hash, Discordrb::Webhooks::Embed, nil] The rich embed to append to this message.", "Convenience method to send a message with an embed.\n @example Send a message with an embed\n channel.send_embed do |embed|\n embed.title = 'The Ruby logo'\n embed.image = Discordrb::Webhooks::EmbedImage.new(url: 'https://www.ruby-lang.org/images/header-ruby-logo.png')\n end\n @param message [String] The message that should be sent along with the embed. If this is the empty string, only the embed will be shown.\n @param embed [Discordrb::Webhooks::Embed, nil] The embed to start the building process with, or nil if one should be created anew.\n @yield [embed] Yields the embed to allow for easy building inside a block.\n @yieldparam embed [Discordrb::Webhooks::Embed] The embed from the parameters, or a new one.\n @return [Message] The resulting message.", "Sends a file to this channel. If it is an image, it will be embedded.\n @param file [File] The file to send. There's no clear size limit for this, you'll have to attempt it for yourself (most non-image files are fine, large images may fail to embed)\n @param caption [string] The caption for the file.\n @param tts [true, false] Whether or not this file's caption should be sent using Discord text-to-speech.\n @param filename [String] Overrides the filename of the uploaded file\n @param spoiler [true, false] Whether or not this file should appear as a spoiler.\n @example Send a file from disk\n channel.send_file(File.open('rubytaco.png', 'r'))", "Deletes a permission overwrite for this channel\n @param target [Member, User, Role, Profile, Recipient, #resolve_id] What permission overwrite to delete\n @param reason [String] The reason the for the overwrite deletion.", "Updates the cached data from another channel.\n @note For internal use only\n @!visibility private", "The list of users currently in this channel. For a voice channel, it will return all the members currently\n in that channel. For a text channel, it will return all online members that have permission to read it.\n @return [Array] the users in this channel", "Retrieves some of this channel's message history.\n @param amount [Integer] How many messages to retrieve. This must be less than or equal to 100, if it is higher\n than 100 it will be treated as 100 on Discord's side.\n @param before_id [Integer] The ID of the most recent message the retrieval should start at, or nil if it should\n start at the current message.\n @param after_id [Integer] The ID of the oldest message the retrieval should start at, or nil if it should start\n as soon as possible with the specified amount.\n @param around_id [Integer] The ID of the message retrieval should start from, reading in both directions\n @example Count the number of messages in the last 50 messages that contain the letter 'e'.\n message_count = channel.history(50).count {|message| message.content.include? \"e\"}\n @example Get the last 10 messages before the provided message.\n last_ten_messages = channel.history(10, message.id)\n @return [Array] the retrieved messages.", "Retrieves message history, but only message IDs for use with prune.\n @note For internal use only\n @!visibility private", "Returns a single message from this channel's history by ID.\n @param message_id [Integer] The ID of the message to retrieve.\n @return [Message, nil] the retrieved message, or `nil` if it couldn't be found.", "Requests all pinned messages in a channel.\n @return [Array] the received messages.", "Delete the last N messages on this channel.\n @param amount [Integer] The amount of message history to consider for pruning. Must be a value between 2 and 100 (Discord limitation)\n @param strict [true, false] Whether an error should be raised when a message is reached that is too old to be bulk\n deleted. If this is false only a warning message will be output to the console.\n @raise [ArgumentError] if the amount of messages is not a value between 2 and 100\n @yield [message] Yields each message in this channels history for filtering the messages to delete\n @example Pruning messages from a specific user ID\n channel.prune(100) { |m| m.author.id == 83283213010599936 }\n @return [Integer] The amount of messages that were successfully deleted", "Deletes a collection of messages\n @param messages [Array] the messages (or message IDs) to delete. Total must be an amount between 2 and 100 (Discord limitation)\n @param strict [true, false] Whether an error should be raised when a message is reached that is too old to be bulk\n deleted. If this is false only a warning message will be output to the console.\n @raise [ArgumentError] if the amount of messages is not a value between 2 and 100\n @return [Integer] The amount of messages that were successfully deleted", "Creates a new invite to this channel.\n @param max_age [Integer] How many seconds this invite should last.\n @param max_uses [Integer] How many times this invite should be able to be used.\n @param temporary [true, false] Whether membership should be temporary (kicked after going offline).\n @param unique [true, false] If true, Discord will always send a unique invite instead of possibly re-using a similar one\n @param reason [String] The reason the for the creation of this invite.\n @return [Invite] the created invite.", "Creates a Group channel\n @param user_ids [Array] Array of user IDs to add to the new group channel (Excluding\n the recipient of the PM channel).\n @return [Channel] the created channel.", "Adds a user to a group channel.\n @param user_ids [Array<#resolve_id>, #resolve_id] User ID or array of user IDs to add to the group channel.\n @return [Channel] the group channel.", "Removes a user from a group channel.\n @param user_ids [Array<#resolve_id>, #resolve_id] User ID or array of user IDs to remove from the group channel.\n @return [Channel] the group channel.", "Requests a list of Webhooks on the channel.\n @return [Array] webhooks on the channel.", "Requests a list of Invites to the channel.\n @return [Array] invites to the channel.", "Adds a recipient to a group channel.\n @param recipient [Recipient] the recipient to add to the group\n @raise [ArgumentError] if tried to add a non-recipient\n @note For internal use only\n @!visibility private", "Removes a recipient from a group channel.\n @param recipient [Recipient] the recipient to remove from the group\n @raise [ArgumentError] if tried to remove a non-recipient\n @note For internal use only\n @!visibility private", "Deletes a list of messages on this channel using bulk delete.", "Adds all event handlers from another container into this one. Existing event handlers will be overwritten.\n @param container [Module] A module that `extend`s {EventContainer} from which the handlers will be added.", "Updates the webhook if you need to edit more than 1 attribute.\n @param data [Hash] the data to update.\n @option data [String, #read, nil] :avatar The new avatar, in base64-encoded JPG format, or nil to delete the avatar.\n @option data [Channel, String, Integer, #resolve_id] :channel The channel the webhook should use.\n @option data [String] :name The webhook's new name.\n @option data [String] :reason The reason for the webhook changes.", "Deletes the webhook.\n @param reason [String] The reason the invite is being deleted.", "Sets the colour of the bar to the side of the embed to something new.\n @param value [Integer, String, {Integer, Integer, Integer}, #to_i, nil] The colour in decimal, hexadecimal, R/G/B decimal, or nil to clear the embeds colour\n form.", "Convenience method to add a field to the embed without having to create one manually.\n @see EmbedField\n @example Add a field to an embed, conveniently\n embed.add_field(name: 'A field', value: \"The field's content\")\n @param name [String] The field's name\n @param value [String] The field's value\n @param inline [true, false] Whether the field should be inlined", "Create a new LightBot. This does no networking yet, all networking is done by the methods on this class.\n @param token [String] The token that should be used to authenticate to Discord. Can be an OAuth token or a regular\n user account token.\n @return [LightProfile] the details of the user this bot is connected to.", "Gets the connections associated with this account.\n @return [Array] this account's connections.", "Finds an emoji by its name.\n @param name [String] The emoji name that should be resolved.\n @return [GlobalEmoji, nil] the emoji identified by the name, or `nil` if it couldn't be found.", "The bot's OAuth application.\n @return [Application, nil] The bot's application info. Returns `nil` if bot is not a bot account.", "Makes the bot join an invite to a server.\n @param invite [String, Invite] The invite to join. For possible formats see {#resolve_invite_code}.", "Sends a text message to a channel given its ID and the message's content.\n @param channel [Channel, Integer, #resolve_id] The channel to send something to.\n @param content [String] The text that should be sent as a message. It is limited to 2000 characters (Discord imposed).\n @param tts [true, false] Whether or not this message should be sent using Discord text-to-speech.\n @param embed [Hash, Discordrb::Webhooks::Embed, nil] The rich embed to append to this message.\n @return [Message] The message that was sent.", "Sends a text message to a channel given its ID and the message's content,\n then deletes it after the specified timeout in seconds.\n @param channel [Channel, Integer, #resolve_id] The channel to send something to.\n @param content [String] The text that should be sent as a message. It is limited to 2000 characters (Discord imposed).\n @param timeout [Float] The amount of time in seconds after which the message sent will be deleted.\n @param tts [true, false] Whether or not this message should be sent using Discord text-to-speech.\n @param embed [Hash, Discordrb::Webhooks::Embed, nil] The rich embed to append to this message.", "Sends a file to a channel. If it is an image, it will automatically be embedded.\n @note This executes in a blocking way, so if you're sending long files, be wary of delays.\n @param channel [Channel, Integer, #resolve_id] The channel to send something to.\n @param file [File] The file that should be sent.\n @param caption [string] The caption for the file.\n @param tts [true, false] Whether or not this file's caption should be sent using Discord text-to-speech.\n @param filename [String] Overrides the filename of the uploaded file\n @param spoiler [true, false] Whether or not this file should appear as a spoiler.\n @example Send a file from disk\n bot.send_file(83281822225530880, File.open('rubytaco.png', 'r'))", "Creates a server on Discord with a specified name and a region.\n @note Discord's API doesn't directly return the server when creating it, so this method\n waits until the data has been received via the websocket. This may make the execution take a while.\n @param name [String] The name the new server should have. Doesn't have to be alphanumeric.\n @param region [Symbol] The region where the server should be created, for example 'eu-central' or 'hongkong'.\n @return [Server] The server that was created.", "Changes information about your OAuth application\n @param name [String] What your application should be called.\n @param redirect_uris [Array] URIs that Discord should redirect your users to after authorizing.\n @param description [String] A string that describes what your application does.\n @param icon [String, nil] A data URI for your icon image (for example a base 64 encoded image), or nil if no icon\n should be set or changed.", "Gets the users, channels, roles and emoji from a string.\n @param mentions [String] The mentions, which should look like `<@12314873129>`, `<#123456789>`, `<@&123456789>` or `<:name:126328:>`.\n @param server [Server, nil] The server of the associated mentions. (recommended for role parsing, to speed things up)\n @return [Array] The array of users, channels, roles and emoji identified by the mentions, or `nil` if none exists.", "Updates presence status.\n @param status [String] The status the bot should show up as. Can be `online`, `dnd`, `idle`, or `invisible`\n @param activity [String, nil] The name of the activity to be played/watched/listened to/stream name on the stream.\n @param url [String, nil] The Twitch URL to display as a stream. nil for no stream.\n @param since [Integer] When this status was set.\n @param afk [true, false] Whether the bot is AFK.\n @param activity_type [Integer] The type of activity status to display. Can be 0 (Playing), 1 (Streaming), 2 (Listening), 3 (Watching)\n @see Gateway#send_status_update", "Awaits an event, blocking the current thread until a response is received.\n @param type [Class] The event class that should be listened for.\n @option attributes [Numeric] :timeout the amount of time to wait for a response before returning `nil`. Waits forever if omitted.\n @return [Event, nil] The event object that was triggered, or `nil` if a `timeout` was set and no event was raised in time.\n @raise [ArgumentError] if `timeout` is given and is not a positive numeric value", "Makes the bot leave any groups with no recipients remaining", "Internal handler for VOICE_STATE_UPDATE", "Internal handler for VOICE_SERVER_UPDATE", "Internal handler for CHANNEL_CREATE", "Internal handler for CHANNEL_UPDATE", "Internal handler for CHANNEL_DELETE", "Internal handler for CHANNEL_RECIPIENT_ADD", "Internal handler for GUILD_MEMBER_ADD", "Internal handler for GUILD_MEMBER_UPDATE", "Internal handler for GUILD_MEMBER_DELETE", "Internal handler for GUILD_ROLE_UPDATE", "Internal handler for GUILD_ROLE_CREATE", "Internal handler for GUILD_ROLE_DELETE", "Internal handler for GUILD_EMOJIS_UPDATE", "Returns or caches the available voice regions", "Gets a channel given its ID. This queries the internal channel cache, and if the channel doesn't\n exist in there, it will get the data from Discord.\n @param id [Integer] The channel ID for which to search for.\n @param server [Server] The server for which to search the channel for. If this isn't specified, it will be\n inferred using the API\n @return [Channel] The channel identified by the ID.", "Gets a user by its ID.\n @note This can only resolve users known by the bot (i.e. that share a server with the bot).\n @param id [Integer] The user ID that should be resolved.\n @return [User, nil] The user identified by the ID, or `nil` if it couldn't be found.", "Gets a server by its ID.\n @note This can only resolve servers the bot is currently in.\n @param id [Integer] The server ID that should be resolved.\n @return [Server, nil] The server identified by the ID, or `nil` if it couldn't be found.", "Gets a member by both IDs, or `Server` and user ID.\n @param server_or_id [Server, Integer] The `Server` or server ID for which a member should be resolved\n @param user_id [Integer] The ID of the user that should be resolved\n @return [Member, nil] The member identified by the IDs, or `nil` if none could be found", "Ensures a given user object is cached and if not, cache it from the given data hash.\n @param data [Hash] A data hash representing a user.\n @return [User] the user represented by the data hash.", "Ensures a given server object is cached and if not, cache it from the given data hash.\n @param data [Hash] A data hash representing a server.\n @return [Server] the server represented by the data hash.", "Ensures a given channel object is cached and if not, cache it from the given data hash.\n @param data [Hash] A data hash representing a channel.\n @param server [Server, nil] The server the channel is on, if known.\n @return [Channel] the channel represented by the data hash.", "Gets information about an invite.\n @param invite [String, Invite] The invite to join. For possible formats see {#resolve_invite_code}.\n @return [Invite] The invite with information about the given invite URL.", "Finds a channel given its name and optionally the name of the server it is in.\n @param channel_name [String] The channel to search for.\n @param server_name [String] The server to search for, or `nil` if only the channel should be searched for.\n @param type [Integer, nil] The type of channel to search for (0: text, 1: private, 2: voice, 3: group), or `nil` if any type of\n channel should be searched for\n @return [Array] The array of channels that were found. May be empty if none were found.", "Finds a user given its username or username & discriminator.\n @overload find_user(username)\n Find all cached users with a certain username.\n @param username [String] The username to look for.\n @return [Array] The array of users that were found. May be empty if none were found.\n @overload find_user(username, discrim)\n Find a cached user with a certain username and discriminator.\n Find a user by name and discriminator\n @param username [String] The username to look for.\n @param discrim [String] The user's discriminator\n @return [User, nil] The user that was found, or `nil` if none was found\n @note This method only searches through users that have been cached. Users that have not yet been cached\n by the bot but still share a connection with the user (mutual server) will not be found.\n @example Find users by name\n bot.find_user('z64') #=> Array\n @example Find a user by name and discriminator\n bot.find_user('z64', '2639') #=> User", "Edits this message to have the specified content instead.\n You can only edit your own messages.\n @param new_content [String] the new content the message should have.\n @param new_embed [Hash, Discordrb::Webhooks::Embed, nil] The new embed the message should have. If `nil` the message will be changed to have no embed.\n @return [Message] the resulting message.", "Reacts to a message.\n @param reaction [String, #to_reaction] the unicode emoji or {Emoji}", "Returns the list of users who reacted with a certain reaction.\n @param reaction [String, #to_reaction] the unicode emoji or {Emoji}\n @param limit [Integer] the limit of how many users to retrieve. `nil` will return all users\n @example Get all the users that reacted with a thumbsup.\n thumbs_up_reactions = message.reacted_with(\"\\u{1F44D}\")\n @return [Array] the users who used this reaction", "Deletes a reaction made by a user on this message.\n @param user [User, #resolve_id] the user who used this reaction\n @param reaction [String, #to_reaction] the reaction to remove", "Deletes this client's reaction on this message.\n @param reaction [String, #to_reaction] the reaction to remove", "Process user objects given by the request\n @note For internal use only\n @!visibility private", "Process webhook objects given by the request\n @note For internal use only\n @!visibility private", "Divides the command chain into chain arguments and command chain, then executes them both.\n @param event [CommandEvent] The event to execute the command with.\n @return [String] the result of the command chain execution.", "Updates the data cache from another Role object\n @note For internal use only\n @!visibility private", "Updates the data cache from a hash containing data\n @note For internal use only\n @!visibility private", "Changes this role's permissions to a fixed bitfield. This allows setting multiple permissions at once with just\n one API call.\n\n Information on how this bitfield is structured can be found at\n https://discordapp.com/developers/docs/topics/permissions.\n @example Remove all permissions from a role\n role.packed = 0\n @param packed [Integer] A bitfield with the desired permissions value.\n @param update_perms [true, false] Whether the internal data should also be updated. This should always be true\n when calling externally.", "Moves this role above another role in the list.\n @param other [Role, #resolve_id, nil] The role above which this role should be moved. If it is `nil`,\n the role will be moved above the @everyone role.\n @return [Integer] the new position of this role", "Bulk sets a member's roles.\n @param role [Role, Array] The role(s) to set.\n @param reason [String] The reason the user's roles are being changed.", "Adds and removes roles from a member.\n @param add [Role, Array] The role(s) to add.\n @param remove [Role, Array] The role(s) to remove.\n @param reason [String] The reason the user's roles are being changed.\n @example Remove the 'Member' role from a user, and add the 'Muted' role to them.\n to_add = server.roles.find {|role| role.name == 'Muted'}\n to_remove = server.roles.find {|role| role.name == 'Member'}\n member.modify_roles(to_add, to_remove)", "Adds one or more roles to this member.\n @param role [Role, Array, #resolve_id] The role(s) to add.\n @param reason [String] The reason the user's roles are being changed.", "Removes one or more roles from this member.\n @param role [Role, Array] The role(s) to remove.\n @param reason [String] The reason the user's roles are being changed.", "Sets or resets this member's nickname. Requires the Change Nickname permission for the bot itself and Manage\n Nicknames for other users.\n @param nick [String, nil] The string to set the nickname to, or nil if it should be reset.\n @param reason [String] The reason the user's nickname is being changed.", "Update this member's roles\n @note For internal use only.\n @!visibility private", "Executes a particular command on the bot. Mostly useful for internal stuff, but one can never know.\n @param name [Symbol] The command to execute.\n @param event [CommandEvent] The event to pass to the command.\n @param arguments [Array] The arguments to pass to the command.\n @param chained [true, false] Whether or not it should be executed as part of a command chain. If this is false,\n commands that have chain_usable set to false will not work.\n @param check_permissions [true, false] Whether permission parameters such as `required_permission` or\n `permission_level` should be checked.\n @return [String, nil] the command's result, if there is any.", "Executes a command in a simple manner, without command chains or permissions.\n @param chain [String] The command with its arguments separated by spaces.\n @param event [CommandEvent] The event to pass to the command.\n @return [String, nil] the command's result, if there is any.", "Check if a user has permission to do something\n @param user [User] The user to check\n @param level [Integer] The minimum permission level the user should have (inclusive)\n @param server [Server] The server on which to check\n @return [true, false] whether or not the user has the given permission", "Internal handler for MESSAGE_CREATE that is overwritten to allow for command handling", "Check whether a message should trigger command execution, and if it does, return the raw chain", "Stops the current playback entirely.\n @param wait_for_confirmation [true, false] Whether the method should wait for confirmation from the playback\n method that the playback has actually stopped.", "Plays a stream of audio data in the DCA format. This format has the advantage that no recoding has to be\n done - the file contains the data exactly as Discord needs it.\n @note DCA playback will not be affected by the volume modifier ({#volume}) because the modifier operates on raw\n PCM, not opus data. Modifying the volume of DCA data would involve decoding it, multiplying the samples and\n re-encoding it, which defeats its entire purpose (no recoding).\n @see https://github.com/bwmarrin/dca\n @see #play", "Plays the data from the @io stream as Discord requires it", "Create a new webhook\n @param url [String] The URL to post messages to.\n @param id [Integer] The webhook's ID. Will only be used if `url` is not\n set.\n @param token [String] The webhook's authorisation token. Will only be used\n if `url` is not set.\n Executes the webhook this client points to with the given data.\n @param builder [Builder, nil] The builder to start out with, or nil if one should be created anew.\n @param wait [true, false] Whether Discord should wait for the message to be successfully received by clients, or\n whether it should return immediately after sending the message.\n @yield [builder] Gives the builder to the block to add additional steps, or to do the entire building process.\n @yieldparam builder [Builder] The builder given as a parameter which is used as the initial step to start from.\n @example Execute the webhook with an already existing builder\n builder = Discordrb::Webhooks::Builder.new # ...\n client.execute(builder)\n @example Execute the webhook by building a new message\n client.execute do |builder|\n builder.content = 'Testing'\n builder.username = 'discordrb'\n builder.add_embed do |embed|\n embed.timestamp = Time.now\n embed.title = 'Testing'\n embed.image = Discordrb::Webhooks::EmbedImage.new(url: 'https://i.imgur.com/PcMltU7.jpg')\n end\n end\n @return [RestClient::Response] the response returned by Discord.", "Makes a new await. For internal use only.\n @!visibility private\n Checks whether the await can be triggered by the given event, and if it can, execute the block\n and return its result along with this await's key.\n @param event [Event] An event to check for.\n @return [Array] This await's key and whether or not it should be deleted. If there was no match, both are nil.", "Drains the currently saved message into a result string. This prepends it before that string, clears the saved\n message and returns the concatenation.\n @param result [String] The result string to drain into.\n @return [String] a string formed by concatenating the saved message and the argument.", "Attaches a file to the message event and converts the message into\n a caption.\n @param file [File] The file to be attached\n @param filename [String] Overrides the filename of the uploaded file\n @param spoiler [true, false] Whether or not this file should appear as a spoiler.", "Gets a role on this server based on its ID.\n @param id [Integer, String, #resolve_id] The role ID to look for.", "Gets a member on this server based on user ID\n @param id [Integer] The user ID to look for\n @param request [true, false] Whether the member should be requested from Discord if it's not cached", "Returns the amount of members that are candidates for pruning\n @param days [Integer] the number of days to consider for inactivity\n @return [Integer] number of members to be removed\n @raise [ArgumentError] if days is not between 1 and 30 (inclusive)", "Removes a role from the role cache\n @note For internal use only\n @!visibility private", "Updates the positions of all roles on the server\n @note For internal use only\n @!visibility private", "Updates a member's voice state\n @note For internal use only\n @!visibility private", "Creates a role on this server which can then be modified. It will be initialized\n with the regular role defaults the client uses unless specified, i.e. name is \"new role\",\n permissions are the default, colour is the default etc.\n @param name [String] Name of the role to create\n @param colour [Integer, ColourRGB, #combined] The roles colour\n @param hoist [true, false]\n @param mentionable [true, false]\n @param permissions [Integer, Array, Permissions, #bits] The permissions to write to the new role.\n @param reason [String] The reason the for the creation of this role.\n @return [Role] the created role.", "Adds a new custom emoji on this server.\n @param name [String] The name of emoji to create.\n @param image [String, #read] A base64 encoded string with the image data, or an object that responds to `#read`, such as `File`.\n @param roles [Array] An array of roles, or role IDs to be whitelisted for this emoji.\n @param reason [String] The reason the for the creation of this emoji.\n @return [Emoji] The emoji that has been added.", "Delete a custom emoji on this server\n @param emoji [Emoji, Integer, String] The emoji or emoji ID to be deleted.\n @param reason [String] The reason the for the deletion of this emoji.", "Bans a user from this server.\n @param user [User, #resolve_id] The user to ban.\n @param message_days [Integer] How many days worth of messages sent by the user should be deleted.\n @param reason [String] The reason the user is being banned.", "Unbans a previously banned user from this server.\n @param user [User, #resolve_id] The user to unban.\n @param reason [String] The reason the user is being unbanned.", "Kicks a user from this server.\n @param user [User, #resolve_id] The user to kick.\n @param reason [String] The reason the user is being kicked.", "Forcibly moves a user into a different voice channel. Only works if the bot has the permission needed.\n @param user [User, #resolve_id] The user to move.\n @param channel [Channel, #resolve_id] The voice channel to move into.", "Sets the server's icon.\n @param icon [String, #read] The new icon, in base64-encoded JPG format.", "Sets the verification level of the server\n @param level [Integer, Symbol] The verification level from 0-4 or Symbol (see {VERIFICATION_LEVELS})", "Sets the default message notification level\n @param notification_level [Integer, Symbol] The default message notificiation 0-1 or Symbol (see {NOTIFICATION_LEVELS})", "Sets the server content filter.\n @param filter_level [Integer, Symbol] The content filter from 0-2 or Symbol (see {FILTER_LEVELS})", "Requests a list of Webhooks on the server.\n @return [Array] webhooks on the server.", "Requests a list of Invites to the server.\n @return [Array] invites to the server.", "Processes a GUILD_MEMBERS_CHUNK packet, specifically the members field\n @note For internal use only\n @!visibility private", "Adjusts the volume of a given buffer of s16le PCM data.\n @param buf [String] An unencoded PCM (s16le) buffer.\n @param mult [Float] The volume multiplier, 1 for same volume.\n @return [String] The buffer with adjusted volume, s16le again", "Adds a new command to the container.\n @param name [Symbol, Array] The name of the command to add, or an array of multiple names for the command\n @param attributes [Hash] The attributes to initialize the command with.\n @option attributes [Integer] :permission_level The minimum permission level that can use this command, inclusive.\n See {CommandBot#set_user_permission} and {CommandBot#set_role_permission}.\n @option attributes [String, false] :permission_message Message to display when a user does not have sufficient\n permissions to execute a command. %name% in the message will be replaced with the name of the command. Disable\n the message by setting this option to false.\n @option attributes [Array] :required_permissions Discord action permissions (e.g. `:kick_members`) that\n should be required to use this command. See {Discordrb::Permissions::FLAGS} for a list.\n @option attributes [Array, Array<#resolve_id>] :required_roles Roles that user must have to use this command\n (user must have all of them).\n @option attributes [Array, Array<#resolve_id>] :allowed_roles Roles that user should have to use this command\n (user should have at least one of them).\n @option attributes [Array] :channels The channels that this command can be used on. An\n empty array indicates it can be used on any channel. Supersedes the command bot attribute.\n @option attributes [true, false] :chain_usable Whether this command is able to be used inside of a command chain\n or sub-chain. Typically used for administrative commands that shouldn't be done carelessly.\n @option attributes [true, false] :help_available Whether this command is visible in the help command. See the\n :help_command attribute of {CommandBot#initialize}.\n @option attributes [String] :description A short description of what this command does. Will be shown in the help\n command if the user asks for it.\n @option attributes [String] :usage A short description of how this command should be used. Will be displayed in\n the help command or if the user uses it wrong.\n @option attributes [Array] :arg_types An array of argument classes which will be used for type-checking.\n Hard-coded for some native classes, but can be used with any class that implements static\n method `from_argument`.\n @option attributes [Integer] :min_args The minimum number of arguments this command should have. If a user\n attempts to call the command with fewer arguments, the usage information will be displayed, if it exists.\n @option attributes [Integer] :max_args The maximum number of arguments the command should have.\n @option attributes [String] :rate_limit_message The message that should be displayed if the command hits a rate\n limit. None if unspecified or nil. %time% in the message will be replaced with the time in seconds when the\n command will be available again.\n @option attributes [Symbol] :bucket The rate limit bucket that should be used for rate limiting. No rate limiting\n will be done if unspecified or nil.\n @option attributes [String, #call] :rescue A string to respond with, or a block to be called in the event an exception\n is raised internally. If given a String, `%exception%` will be substituted with the exception's `#message`. If given\n a `Proc`, it will be passed the `CommandEvent` along with the `Exception`.\n @yield The block is executed when the command is executed.\n @yieldparam event [CommandEvent] The event of the message that contained the command.\n @note `LocalJumpError`s are rescued from internally, giving bots the opportunity to use `return` or `break` in\n their blocks without propagating an exception.\n @return [Command] The command that was added.\n @deprecated The command name argument will no longer support arrays in the next release.\n Use the `aliases` attribute instead.", "Changes the bot's avatar.\n @param avatar [String, #read] A JPG file to be used as the avatar, either\n something readable (e.g. File Object) or as a data URL.", "Creates a new UDP connection. Only creates a socket as the discovery reply may come before the data is\n initialized.\n Initializes the UDP socket with data obtained from opcode 2.\n @param endpoint [String] The voice endpoint to connect to.\n @param port [Integer] The port to connect to.\n @param ssrc [Integer] The Super Secret Relay Code (SSRC). Discord uses this to identify different voice users\n on the same endpoint.", "Waits for a UDP discovery reply, and returns the sent data.\n @return [Array(String, Integer)] the IP and port received from the discovery reply.", "Makes an audio packet from a buffer and sends it to Discord.\n @param buf [String] The audio data to send, must be exactly one Opus frame\n @param sequence [Integer] The packet sequence number, incremented by one for subsequent packets\n @param time [Integer] When this packet should be played back, in no particular unit (essentially just the\n sequence number multiplied by 960)", "Encrypts audio data using RbNaCl\n @param header [String] The header of the packet, to be used as the nonce\n @param buf [String] The encoded audio data to be encrypted\n @return [String] the audio data, encrypted", "Performs a rate limit request.\n @param key [Symbol] Which bucket to perform the request for.\n @param thing [#resolve_id, Integer, Symbol] What should be rate-limited.\n @param increment (see Bucket#rate_limited?)\n @see Bucket#rate_limited?\n @return [Integer, false] How much time to wait or false if the request succeeded.", "Makes a new bucket\n @param limit [Integer, nil] How many requests the user may perform in the given time_span, or nil if there should be no limit.\n @param time_span [Integer, nil] The time span after which the request count is reset, in seconds, or nil if the bucket should never be reset. (If this is nil, limit should be nil too)\n @param delay [Integer, nil] The delay for which the user has to wait after performing a request, in seconds, or nil if the user shouldn't have to wait.\n Cleans the bucket, removing all elements that aren't necessary anymore\n @param rate_limit_time [Time] The time to base the cleaning on, only useful for testing.", "Performs a rate limiting request\n @param thing [#resolve_id, Integer, Symbol] The particular thing that should be rate-limited (usually a user/channel, but you can also choose arbitrary integers or symbols)\n @param rate_limit_time [Time] The time to base the rate limiting on, only useful for testing.\n @param increment [Integer] How much to increment the rate-limit counter. Default is 1.\n @return [Integer, false] the waiting time until the next request, in seconds, or false if the request succeeded", "Connect to the gateway server in a separate thread", "Sends a custom packet over the connection. This can be useful to implement future yet unimplemented functionality\n or for testing. You probably shouldn't use this unless you know what you're doing.\n @param opcode [Integer] The opcode the packet should be sent as. Can be one of {Opcodes} or a custom value if\n necessary.\n @param packet [Object] Some arbitrary JSON-serialisable data that should be sent as the `d` field.", "Create and connect a socket using a URI", "Gets the target schema of a link. This is normally just the standard\n response schema, but we allow some legacy behavior for hyper-schema links\n tagged with rel=instances to instead use the schema of their parent\n resource.", "A single name according to gender parameter", "Mobile prefixes are in the 015x, 016x, 017x ranges", "Runs `identify` on the current image, and raises an error if it doesn't\n pass.\n\n @raise [MiniMagick::Invalid]", "This is used to change the format of the image. That is, from \"tiff to\n jpg\" or something like that. Once you run it, the instance is pointing to\n a new file with a new extension!\n\n *DANGER*: This renames the file that the instance is pointing to. So, if\n you manually opened the file with Image.new(file_path)... Then that file\n is DELETED! If you used Image.open(file) then you are OK. The original\n file will still be there. But, any changes to it might not be...\n\n Formatting an animation into a non-animated type will result in\n ImageMagick creating multiple pages (starting with 0). You can choose\n which page you want to manipulate. We default to the first page.\n\n If you would like to convert between animated formats, pass nil as your\n page and ImageMagick will copy all of the pages.\n\n @param format [String] The target format... Like 'jpg', 'gif', 'tiff' etc.\n @param page [Integer] If this is an animated gif, say which 'page' you\n want with an integer. Default 0 will convert only the first page; 'nil'\n will convert all pages.\n @param read_opts [Hash] Any read options to be passed to ImageMagick\n for example: image.format('jpg', page, {density: '300'})\n @yield [MiniMagick::Tool::Convert] It optionally yields the command,\n if you want to add something.\n @return [self]", "Runs `identify` on itself. Accepts an optional block for adding more\n options to `identify`.\n\n @example\n image = MiniMagick::Image.open(\"image.jpg\")\n image.identify do |b|\n b.verbose\n end # runs `identify -verbose image.jpg`\n @return [String] Output from `identify`\n @yield [MiniMagick::Tool::Identify]", "Redact sensitive info from provided data", "Splits a header value +str+ according to HTTP specification.", "Escapes HTTP reserved and unwise characters in +str+", "Unescapes HTTP reserved and unwise characters in +str+", "Unescape form encoded values in +str+", "Sends the supplied request to the destination host.\n @yield [chunk] @see Response#self.parse\n @param [Hash] params One or more optional params, override defaults set in Connection.new\n @option params [String] :body text to be sent over a socket\n @option params [Hash] :headers The default headers to supply in a request\n @option params [String] :path appears after 'scheme://host:port/'\n @option params [Hash] :query appended to the 'scheme://host:port/path/' in the form of '?key=value'", "Sends the supplied requests to the destination host using pipelining.\n @pipeline_params [Array] pipeline_params An array of one or more optional params, override defaults set in Connection.new, see #request for details", "Sends the supplied requests to the destination host using pipelining in\n batches of @limit [Numeric] requests. This is your soft file descriptor\n limit by default, typically 256.\n @pipeline_params [Array] pipeline_params An array of one or more optional params, override defaults set in Connection.new, see #request for details", "Start the aruba console\n\n rubocop:disable Metrics/MethodLength", "Make deep dup copy of configuration", "Define or run before-hook\n\n @param [Symbol, String] name\n The name of the hook\n\n @param [Proc] context\n The context a hook should run in. This is a runtime only option.\n\n @param [Array] args\n Arguments for the run of hook. This is a runtime only option.\n\n @yield\n The code block which should be run. This is a configure time only option", "Broadcast an event\n\n @param [Object] event\n An object of registered event class. This object is passed to the event\n handler.", "The path to the directory which contains fixtures\n You might want to overwrite this method to place your data else where.\n\n @return [ArubaPath]\n The directory to where your fixtures are stored", "Create files etc.", "Create store\n Add new hook\n\n @param [String, Symbol] label\n The name of the hook\n\n @param [Proc] block\n The block which should be run for the hook", "Find all files for which the block yields.", "Find unique keys in redis\n\n @param [String] pattern a pattern to scan for in redis\n @param [Integer] count the maximum number of keys to delete\n @return [Array] an array with active unique keys", "Find unique keys with ttl\n @param [String] pattern a pattern to scan for in redis\n @param [Integer] count the maximum number of keys to delete\n @return [Hash] a hash with active unique keys and corresponding ttl", "Deletes unique keys from redis\n\n @param [String] pattern a pattern to scan for in redis\n @param [Integer] count the maximum number of keys to delete\n @return [Integer] the number of keys deleted", "Unlocks a job.\n @param [Hash] item a Sidekiq job hash", "Deletes a lock regardless of if it was locked or not.\n\n This is good for situations when a job is locked by another item\n @param [Hash] item a Sidekiq job hash", "Call a lua script with the provided file_name\n\n @note this method is recursive if we need to load a lua script\n that wasn't previously loaded.\n\n @param [Symbol] file_name the name of the lua script\n @param [Sidekiq::RedisConnection, ConnectionPool] redis_pool the redis connection\n @param [Hash] options arguments to pass to the script file\n @option options [Array] :keys the array of keys to pass to the script\n @option options [Array] :argv the array of arguments to pass to the script\n\n @return value from script", "Execute the script file\n\n @param [Symbol] file_name the name of the lua script\n @param [Sidekiq::RedisConnection, ConnectionPool] redis_pool the redis connection\n @param [Hash] options arguments to pass to the script file\n @option options [Array] :keys the array of keys to pass to the script\n @option options [Array] :argv the array of arguments to pass to the script\n\n @return value from script (evalsha)", "Return sha of already loaded lua script or load it and return the sha\n\n @param [Sidekiq::RedisConnection] conn the redis connection\n @param [Symbol] file_name the name of the lua script\n @return [String] sha of the script file\n\n @return [String] the sha of the script", "Handle errors to allow retrying errors that need retrying\n\n @param [Redis::CommandError] ex exception to handle\n @param [Symbol] file_name the name of the lua script\n\n @return [void]\n\n @yieldreturn [void] yields back to the caller when NOSCRIPT is raised", "Deletes the lock regardless of if it has a ttl set", "Create a lock for the item\n\n @param [Integer] timeout the number of seconds to wait for a lock.\n\n @return [String] the Sidekiq job_id (jid)", "Removes the lock keys from Redis\n\n @param [String] token the token to unlock (defaults to jid)\n\n @return [false] unless locked?\n @return [String] Sidekiq job_id (jid) if successful", "Creates a connection to redis\n @return [Sidekiq::RedisConnection, ConnectionPool] a connection to redis", "Return unique digests matching pattern\n\n @param [String] pattern a pattern to match with\n @param [Integer] count the maximum number to match\n @return [Array] with unique digests", "Paginate unique digests\n\n @param [String] pattern a pattern to match with\n @param [Integer] cursor the maximum number to match\n @param [Integer] page_size the current cursor position\n\n @return [Array