File: ARCHITECTURE.md

package info (click to toggle)
ccache 4.12.2-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid
  • size: 5,188 kB
  • sloc: cpp: 47,282; asm: 28,570; sh: 8,674; ansic: 5,357; python: 685; perl: 68; makefile: 23
file content (38 lines) | stat: -rw-r--r-- 1,400 bytes parent folder | download | duplicates (2)
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
# Ccache architecture

## Code structure

### Top-level directories

* `ci`: Utility scripts used in CI.
* `cmake`: CMake scripts.
* `doc`: Documentation.
* `dockerfiles`: Dockerfiles that specify different environments of interest for
  ccache.
* `misc`: Miscellaneous utility scripts, example files, etc.
* `src`: Source code. See below.
* `test`: Integration test suite which tests the ccache binary in different
  scenarios.
* `unittest`: Unit test suite which typically tests individual functions.

### Subdirectories of `src`

* `ccache`: Ccache source code.
* `third_party`: Bundled third party code.

### Subdirectories of `src/ccache`

This section describes the directory structure that the project aims to
transform the `src/ccache` directory into in the long run to make the code base
easier to understand and work with. In other words, this is work in progress.

* `compiler`: Knowledge about things like compiler options, compiler behavior,
  preprocessor output format, etc. Ideally this code should in the future be
  refactored into compiler-specific frontends, such as GCC, Clang, NVCC, MSVC,
  etc.
* `core`: Everything not part of other directories.
* `storage`: Storage backends.
* `storage/local`: Code for the local storage backend.
* `storage/remote`: Code for remote storage backends.
* `util`: Generic utility functionality that does not depend on ccache-specific
  things.