Home›Services›Scope script

Measure before we quote

How long a migration or a security project takes depends on your numbers: how many repositories, pipelines, languages and releases you have. This script counts them on your side. You read the report, send it to us, and we come back with a fixed price and dates.

Free Read-only · GET requests only Counts only · no code, no names

What it counts

For GitLab, GitHub or a folder of local clones:

What it does not do

How to run it

Use a token with read-only scopes: on GitLab read_api and read_repository; on GitHub a fine-grained token with read access to contents and metadata. The token is read from an environment variable and never written anywhere.

Download and check

curl -O https://dvs.hk/scope/dvs-scope.py
sha256sum dvs-scope.py
# expected: 403e8575ba6a110baaa871076f85a97b73e011e1e25c3b8c7180d3a47c012a51  (version 1.0.0)

GitLab (self-managed or gitlab.com)

export DVS_SCOPE_TOKEN=...      # read_api + read_repository
python3 dvs-scope.py gitlab --url https://gitlab.example.com
python3 dvs-scope.py gitlab --url https://gitlab.example.com --group platform   # one group only

GitHub

export DVS_SCOPE_TOKEN=...
python3 dvs-scope.py github --org your-org

Local clones (no API, no token)

python3 dvs-scope.py local ~/src

Useful options

--no-content        do not read any file contents
--max-projects 50   try it on the first 50 projects
--ca-file ca.pem    internal server with your own CA
--names             include project names (off by default)

Which numbers set the price

What we look at in the report for each service:

ServiceNumbers that matter most
CRA supply-chain controlsProducts in scope (from your counsel), repositories that produce releases, ecosystems, maintained release lines, existing SBOM and signing
DevSecOps Pipeline · Snyk / SonarQube exitActive projects with CI, ecosystems, scanners already in use
Nexus / Artifactory → open registryEcosystems, projects that pull from the registry, GitLab packages and container repositories; plus a screenshot of the registry's own storage page
Bitnami exitProjects that mention Bitnami, Helm charts, Dockerfiles
Terraform → OpenTofu · IaC pipelinesRepositories with Terraform or Terragrunt, Terraform Cloud and Atlantis mentions
Vault → OpenBao · Redis → Valkey · MinIOProjects that use them; the server side comes from a short command output or screenshot

Can't run a script?

Some teams can't run outside code, or the platform is air-gapped. Then send screenshots or short command output instead — blur names if you like:

Questions teams ask

Is this the assessment?

No. The report gives us counts, so we can price the work. A paid assessment looks at how things are actually configured and gives you written findings.

Why does it need read_repository?

To list files and read CI and build files locally for tool names. With --no-content it only lists file names, and tool detection is skipped.

How long does it take?

About 30 read requests per project. A small instance takes seconds; a few thousand projects can take an hour. Try --max-projects or --group first.

What do you do with the report?

We use it to scope and price the work for you, and nothing else. Without --names it contains no project, group or host names.

Services that start with a measurement

Send us the report

Attach the JSON file to an email, or bring it to a 30-minute call. We reply with a price and dates.

Pick a 30-minute slot Opens our booking calendar in a new tab · or write to info@dvs.hk
Book a 30-minute call