File: QueryableView.h

package info (click to toggle)
watchman 4.9.0-8
  • links: PTS, VCS
  • area: main
  • in suites: sid
  • size: 9,936 kB
  • sloc: cpp: 27,450; python: 6,534; java: 3,404; php: 3,257; ansic: 2,803; javascript: 1,116; makefile: 671; ruby: 364; sh: 124; xml: 102; lisp: 4
file content (67 lines) | stat: -rw-r--r-- 2,385 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
/* Copyright 2016-present Facebook, Inc.
 * Licensed under the Apache License, Version 2.0 */
#pragma once

#include "watchman_system.h"
#include <future>
#include <vector>
#include "scm/SCM.h"
#include "watchman_perf.h"
#include "watchman_query.h"
#include "watchman_string.h"

struct watchman_file;
struct watchman_dir;
struct watchman_glob_tree;

namespace watchman {

class QueryableView : public std::enable_shared_from_this<QueryableView> {
 public:
  virtual ~QueryableView();

  /** Perform a time-based (since) query and emit results to the supplied
  * query context */
  virtual void timeGenerator(w_query* query, struct w_query_ctx* ctx) const;

  /** Walks all files with the suffix(es) configured in the query */
  virtual void suffixGenerator(w_query* query, struct w_query_ctx* ctx) const;

  /** Walks files that match the supplied set of paths */
  virtual void pathGenerator(w_query* query, struct w_query_ctx* ctx) const;

  virtual void globGenerator(w_query* query, struct w_query_ctx* ctx) const;

  virtual void allFilesGenerator(w_query* query, struct w_query_ctx* ctx) const;
  virtual ClockPosition getMostRecentRootNumberAndTickValue() const = 0;
  virtual w_string getCurrentClockString() const = 0;
  virtual uint32_t getLastAgeOutTickValue() const;
  virtual time_t getLastAgeOutTimeStamp() const;
  virtual void ageOut(w_perf_t& sample, std::chrono::seconds minAge);
  virtual bool syncToNow(std::chrono::milliseconds timeout) = 0;

  // Specialized query function that is used to test whether
  // version control files exist as part of some settling handling.
  // It should query the view and return true if any of the named
  // files current exist in the view.
  virtual bool doAnyOfTheseFilesExist(
      const std::vector<w_string>& fileNames) const = 0;

  bool isVCSOperationInProgress() const;

  // Start up any helper threads
  virtual void startThreads(const std::shared_ptr<w_root_t>& root);
  // Request that helper threads shutdown (but does not join them)
  virtual void signalThreads();
  // Request that helper threads wake up and re-evaluate their state
  virtual void wakeThreads();

  virtual const w_string& getName() const = 0;

  virtual std::shared_future<void> waitUntilReadyToQuery(
      const std::shared_ptr<w_root_t>& root) = 0;

  // Return the SCM detected for this watched root
  virtual SCM* getSCM() const = 0;
};
}