File: pipeline.h

package info (click to toggle)
chromium 138.0.7204.157-1
  • links: PTS, VCS
  • area: main
  • in suites: trixie
  • size: 6,071,864 kB
  • sloc: cpp: 34,936,859; ansic: 7,176,967; javascript: 4,110,704; python: 1,419,953; asm: 946,768; xml: 739,967; pascal: 187,324; sh: 89,623; perl: 88,663; objc: 79,944; sql: 50,304; cs: 41,786; fortran: 24,137; makefile: 21,806; php: 13,980; tcl: 13,166; yacc: 8,925; ruby: 7,485; awk: 3,720; lisp: 3,096; lex: 1,327; ada: 727; jsp: 228; sed: 36
file content (70 lines) | stat: -rw-r--r-- 2,918 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
// Copyright 2024 The Chromium Authors
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef COMPONENTS_UPDATE_CLIENT_PIPELINE_H_
#define COMPONENTS_UPDATE_CLIENT_PIPELINE_H_

#include <cstdint>
#include <string>

#include "base/functional/callback_forward.h"
#include "base/memory/scoped_refptr.h"
#include "base/types/expected.h"
#include "base/values.h"
#include "components/crx_file/crx_verifier.h"
#include "components/update_client/crx_downloader.h"
#include "components/update_client/protocol_parser.h"
#include "components/update_client/update_client.h"
#include "components/update_client/update_client_errors.h"

namespace base {
class FilePath;
}

namespace update_client {

class Configurator;
class CrxCache;

using PipelineStartCallback = base::OnceCallback<base::OnceClosure(
    base::OnceCallback<void(const CategorizedError&)>)>;

// Creates a pipeline of operations to update an item, and returns a callback
// that starts the pipeline as a parameter of `callback`. The pipeline callback
// in turn takes as an argument a completion callback to invoke when done, and
// returns a cancellation callback. The completion callback will be invoked on
// the same sequence that the pipeline is started on, and the cancellation
// callback must only be called on that same sequence. If `result` indicates a
// server error, returns instead a CategorizedError with
// ErrorCategory::kUpdateCheck. If `result` indicates no-update, returns
// instead a CategorizedError with ErrorCategory::kNone. As the pipeline
// executes operations, it calls `state_tracker` to record the ComponentState
// to expose to observers. It also calls `event_adder` to record events to be
// sent to the update server, and `diff_outcome_recorder` to record the outcome
// of the differential update (if any).
void MakePipeline(
    scoped_refptr<Configurator> config,
    base::RepeatingCallback<int64_t(const base::FilePath&)> get_available_space,
    bool is_foreground,
    const std::string& session_id,
    scoped_refptr<CrxCache> crx_cache,
    crx_file::VerifierFormat crx_format,
    const std::string& id,
    const std::vector<uint8_t>& pk_hash,
    const std::string& install_data_index,
    scoped_refptr<CrxInstaller> installer,
    base::RepeatingCallback<void(ComponentState)> state_tracker,
    base::RepeatingCallback<void(base::Value::Dict)> event_adder,
    CrxDownloader::ProgressCallback download_progress_callback,
    CrxInstaller::ProgressCallback install_progress_callback,
    base::RepeatingCallback<void(const CrxInstaller::Result&)>
        install_complete_callback,
    scoped_refptr<ActionHandler> action_handler,
    const ProtocolParser::App& result,
    base::OnceCallback<void(
        base::expected<PipelineStartCallback, CategorizedError>)> callback);

}  // namespace update_client

#endif  // COMPONENTS_UPDATE_CLIENT_PIPELINE_H_