Add more tests

flawz is a Terminal User Interface (TUI) for browsing the security vulnerabilities (also known as CVEs).

As default it uses the vulnerability database (NVD) from NIST and provides search and listing functionalities in the terminal with different theming options.

For example, to view details on the notorious xz vulnerability:

flawz --feeds 2024 --query xz

Table of Contents

Installation
Usage
Key bindings
Examples
Themes
Support
Contributing
License
Copyright

Installation

Packaging status

Cargo

flawz can be installed from crates.io using cargo if Rust is installed.

cargo install flawz

The minimum supported Rust version (MSRV) is 1.74.1.

Arch Linux

flawz can be installed from the official repositories using pacman:

pacman -S flawz

Alpine Linux

flawz is available for Alpine Edge. It can be installed via apk after enabling the testing repository.

apk add flawz

Homebrew

flawz is available for macOS via Homebrew. It can be installed using brew

brew install flawz

Nixpkgs

flawz is available for Nix via nixpkgs-unstable channel. To make it available in the environment, simply run:

nix-channel --add https://nixos.org/channels/nixpkgs-unstable
nix-channel --update nixpkgs
nix-env -iA nixpkgs.flawz

On NixOS:

nix-channel --add https://nixos.org/channels/nixos-unstable
nix-channel --update nixos
nix-env -iA nixos.flawz

Alternatively, if you're using the new experimental CLI, you can use the following:

nix run nixpkgs#flawz

NetBSD

flawz is available from the official repositories. To install it, simply run:

pkgin install flawz

Binary releases

See the available binaries for different targets from the releases page.

Build from source

Clone the repository.

git clone https://github.com/orhun/flawz && cd flawz/

Build.

CARGO_TARGET_DIR=target cargo build --release

Binary will be located at target/release/flawz.

Usage

flawz [OPTIONS]

Options:

  --url <URL>           A URL where NIST CVE 1.1 feeds can be found [env: URL=] [default:
                        https://nvd.nist.gov/feeds/json/cve/1.1/]
-f, --feeds [<FEEDS>...]  List of feeds that are going to be synced [env: FEEDS=] [default: 2002:2024 recent
                        modified]
-d, --db <DB>             Path to the SQLite database used to store the synced CVE data [env: DB=]
-u, --force-update        Always fetch feeds
-o, --offline             Do not fetch feeds
-q, --query <QUERY>       Start with a search query [env: QUERY=]
-t, --theme <THEME>       Set the theme [default: dracula] [possible values: dracula, nord, one-dark,
                        solarized-dark]
-h, --help                Print help (see more with '--help')
-V, --version             Print version

Key bindings

Key	Action	Description
`k` / `Up`	Scroll Up	Scroll up the list
`j` / `Down`	Scroll Down	Scroll down the list
`Enter`	Select	View the selected CVE details
`/`	Search	Search for a CVE
`Space`	Open	Open the first CVE reference in the browser
`q`	Quit	Set computer on fire

Examples

To start with a specific search query:

flawz --query "buffer overflow"

You can use the --feeds option to sync specific years of feeds:

flawz --feeds 2010:2015 recent

Additionally, you can use the following flags:

--force-update: Always fetch feeds, even if they are already up to date.
--offline: Run without fetching feeds (useful if you have already synced the data):

For example, you can use the following command to search for a specific vulnerability from 2014:

flawz -q "CVE-2014-0160" -f 2014 --force-update

Themes

Start flawz with --theme option to set a custom theme, e.g. --theme nord.

Dracula (default)

Nord

One Dark

Solarized Dark

Support

If you find flawz and/or other projects on my GitHub useful, consider supporting me on GitHub Sponsors! 💖

Contributing

See our Contribution Guide and please follow the Code of Conduct in all your interactions with the project.

License

Licensed under either of Apache License Version 2.0 or The MIT License at your option.

🦀 ノ( º _ º ノ) - respect crables!

	let items = items
	.into_iter()
	.filter(\|cve\| {
	query.is_empty()
	\|\| cve.id.to_lowercase().contains(&query)
	\|\| cve
	.description
	.clone()
	.unwrap_or_default()
	.to_lowercase()
	.contains(&query)
	})
	.collect();

	/// Built-in theme.
	#[derive(Debug, Clone, PartialEq, ValueEnum, Default)]
	pub enum BuiltinTheme {
	/// Dracula.
	#[default]
	Dracula,
	/// Nord.
	Nord,
	/// One Dark.
	OneDark,
	/// Solarized Dark.
	SolarizedDark,
	}

	/// <https://draculatheme.com/contribute>
	fn dracula_theme() -> Option<Theme> {
	Some(Theme {
	background: Style::default()
	.bg(Color::from_str("#282A36").ok()?)
	.fg(Color::from_str("#F8F8F2").ok()?),
	dim: Style::default()
	.bg(Color::from_str("#282A36").ok()?)
	.fg(Color::from_str("#44475A").ok()?),
	foreground: Style::default().fg(Color::from_str("#F8F8F2").ok()?),
	header: Style::default()
	.bg(Color::from_str("#BD93F9").ok()?)
	.fg(Color::from_str("#282A36").ok()?),
	footer: Style::default()
	.bg(Color::from_str("#282A36").ok()?)
	.fg(Color::from_str("#8BE9FD").ok()?),
	selected: Style::default()
	.bg(Color::from_str("#44475A").ok()?)
	.fg(Color::from_str("#FFB86C").ok()?),
	borders: Style::default().fg(Color::from_str("#44475A").ok()?),
	separator: Style::default().fg(Color::from_str("#6272A4").ok()?),
	highlight: Style::default().fg(Color::from_str("#F1FA8C").ok()?),
	index: Style::default().fg(Color::from_str("#BD93F9").ok()?),
	input: Style::default().fg(Color::from_str("#50FA7B").ok()?),
	input_empty: Style::default().fg(Color::from_str("#FF79C6").ok()?),
	scrollbar: Style::default().fg(Color::from_str("#6272A4").ok()?),
	})
	}

orhun / flawz Goto Github PK

flawz's Introduction

Installation

Cargo

Arch Linux

Alpine Linux

Homebrew

Nixpkgs

NetBSD

Binary releases

Build from source

Usage

Key bindings

Examples

Themes

Dracula (default)

Nord

One Dark

Solarized Dark

Support

Contributing

License

Copyright

flawz's People

Contributors

Stargazers

Watchers

Forkers

flawz's Issues

Recommend Projects

Recommend Topics

Recommend Org