semvec/pypi-packages huggingface dataset:
jvgraph 2.1.0
CLI tool for Jivas Graph
Requires Python: >=3.12

# JIVAS Graph (JVGRAPH)

![GitHub release (latest by date)](https://img.shields.io/github/v/release/TrueSelph/jvgraph)
![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/TrueSelph/jvgraph/test-jvgraph.yaml)
![GitHub issues](https://img.shields.io/github/issues/TrueSelph/jvgraph)
![GitHub pull requests](https://img.shields.io/github/issues-pr/TrueSelph/jvgraph)
![GitHub](https://img.shields.io/github/license/TrueSelph/jvgraph)

`jvgraph` is a development tool designed to streamline development with the JIVAS platform. It allows you to view your JIVAS graph in a web browser.

## Installation

To install `jvgraph`, use `pip`:

```sh
pip install jvgraph
```

## Usage

To use `jvgraph`, you need to log in first:

```sh
jvgraph launch
```

After logging in, you can use any of the available commands. For example, to create a new action:


## 🔰 Contributing

- **🐛 [Report Issues](https://github.com/TrueSelph/jvgraph/issues)**: Submit bugs found or log feature requests for the `jvgraph` project.
- **💡 [Submit Pull Requests](https://github.com/TrueSelph/jvgraph/blob/main/CONTRIBUTING.md)**: Review open PRs, and submit your own PRs.

<details closed>
<summary>Contributing Guidelines</summary>

1. **Fork the Repository**: Start by forking the project repository to your github account.
2. **Clone Locally**: Clone the forked repository to your local machine using a git client.
   ```sh
   git clone https://github.com/TrueSelph/jvgraph
   ```
3. **Create a New Branch**: Always work on a new branch, giving it a descriptive name.
   ```sh
   git checkout -b new-feature-x
   ```
4. **Make Your Changes**: Develop and test your changes locally.
5. **Commit Your Changes**: Commit with a clear message describing your updates.
   ```sh
   git commit -m 'Implemented new feature x.'
   ```
6. **Push to github**: Push the changes to your forked repository.
   ```sh
   git push origin new-feature-x
   ```
7. **Submit a Pull Request**: Create a PR against the original project repository. Clearly describe the changes and their motivations.
8. **Review**: Once your PR is reviewed and approved, it will be merged into the main branch. Congratulations on your contribution!
</details>

<details open>
<summary>Contributor Graph</summary>
<br>
<p align="left">
    <a href="https://github.com/TrueSelph/jvgraph/graphs/contributors">
        <img src="https://contrib.rocks/image?repo=TrueSelph/jvgraph" />
   </a>
</p>
</details>

## 🎗 License

This project is protected under the Apache License 2.0. See [LICENSE](./LICENSE) for more information.
covtool 0.4.4
a multitool for manipulating coverage traces for dynamic analysis
Requires Python: <4.0,>=3.10


# covtool

a multitool for manipulating coverage traces for dynamic analysis

primarily built around the standard-ish [DrCov](https://www.ayrx.me/drcov-file-format/) coverage trace format; but supports converting other, simpler trace formats.
also supports a [custom backwards-compatible extension](./doc/drcov_spec_hits_v2.md) to the DrCov format to track block hitcounts.

## features

+ a flagship tui for inspecting traces
+ view stats about coverage traces
+ perform queries (intersection, difference, etc.) on multiple traces
+ edit traces (rebase modules, adjust offsets)
+ lift simple formats to drcov (write your own coverage tools)

## install

```sh
uv tool install covtool
```

## coverage formats

### flagship: drcov (+hits)

this is either the standard DrCov format (any version), or the custom extension to support hitcounts.

### simple formats (lifted to drcov)

you can make a file that just outputs block traces in very simple formats (one entry per line).
these get auto-detected and can be converted to drcov using the `lift` tool:

+ **module+offset**: `boombox+3a06`  
+ **address**: `14000419c` or `0x14000419c`  
+ **address+hits**: `14000419c 24`

you can lift to the standard format by specifying module names and optionally base addresses:

```sh
covtool lift input.txt -o output.drcov -M module@base_addr
```