Skip to content

Commit

Permalink
Refactor: Remove unused submodules and scripts, fix testing issues (#56)
Browse files Browse the repository at this point in the history
Remove scripts to get volatility on github and base this project on the package
  • Loading branch information
Ston14 authored Aug 19, 2024
1 parent 5c72865 commit ed7dcfa
Show file tree
Hide file tree
Showing 11 changed files with 805 additions and 523 deletions.
2 changes: 1 addition & 1 deletion .github/workflows/dev.yml
Original file line number Diff line number Diff line change
Expand Up @@ -84,4 +84,4 @@ jobs:
user: __token__
password: ${{ secrets.TEST_PYPI_API_TOKEN }}
repository-url: https://test.pypi.org/legacy/
skip-existing: true
skip-existing: true
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -116,3 +116,5 @@ cython_debug/

# Local Dev
main.py

tests/config.py
3 changes: 0 additions & 3 deletions .gitmodules

This file was deleted.

10 changes: 0 additions & 10 deletions build_submodules.py

This file was deleted.

76 changes: 64 additions & 12 deletions docs/Usage/installation.md
Original file line number Diff line number Diff line change
@@ -1,27 +1,79 @@
## Organisation
## Quick Installation Guide

## Quick installation
This guide provides instructions for installing `pydfirram` from various sources and using all plugins available in the `volatility3` repository.

### Prerequisites

Ensure you have the following installed:

- Python
- Poetry (for dev)
- Poetry (for development)
- pip

### From source
On a standard Linux distribution :
```shell
git clone https://github.com/pydfir/pydfirram
poetry shell
poetry install
```
### From pip stable
### Installation Methods

#### From Source

To install `pydfirram` from the source on a standard Linux distribution, follow these steps:

1. Clone the repository:
```shell
git clone https://github.com/pydfir/pydfirram
```

2. Navigate into the project directory:
```shell
cd pydfirram
```

3. Create a virtual environment and activate it using Poetry:
```shell
poetry shell
```

4. Install the dependencies:
```shell
poetry install
```

#### From pip (Stable)

To install the stable version of `pydfirram` from pip, use the following command:

```shell
pip install pydfirram
```
### From pip dev

#### From pip (Development)

To install the development version of `pydfirram` from the TestPyPI repository, use the following command:

```bash
pip install -i https://test.pypi.org/simple/ pydfirram
```

#### Using All Plugins

To use all plugins available in the `volatility3` repository, follow these steps:

1. Install `pydfirram`:
```bash
pip install pydfirram
```

2. Clone the `volatility3` repository:
```bash
git clone https://github.com/volatilityfoundation/volatility3
```

3. Navigate into the `volatility3` directory:
```bash
cd volatility3
```

4. Install the plugins:
```bash
pip install .
```

This setup ensures that you have access to all the plugins provided by the `volatility3` repository.
29 changes: 28 additions & 1 deletion docs/reference/reference.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,31 @@
<!-- This part of the project documentation focuses on
an **information-oriented** approach. Use it as a
reference for the technical implementation of the
`calculator` project code. -->
`calculator` project code. -->

## Index of References

This index provides a structured overview of the various reference documentation pages for the project, using the Diátaxis framework. Each page focuses on different components and functionalities of the project.

### Documentation Pages

#### [Base](base.md)
This page details the foundational elements of the project. It includes core classes, functions, and their interactions.

#### [Handler](handler.md)
The handler documentation covers the management of different processes within the project. It outlines the implementation and usage of handlers in various scenarios.

#### [Reference](reference.md)
The reference page serves as a comprehensive guide to all modules, classes, and functions in the project. It is an exhaustive resource for understanding the project's API and architecture.

#### [Renderer](renderer.md)
This section explains the rendering process, detailing how data is transformed and presented. It includes examples and best practices for implementing renderers.

#### [Test](test.md)
The test documentation provides guidelines on how to write and run tests for the project. It includes details on testing frameworks, test coverage, and sample test cases.

#### [Utils](utils.md)
This page describes the utility functions and helper modules available in the project. It covers common patterns and reusable components that assist in project development.

#### [Windows](windows.md)
The windows documentation focuses on platform-specific considerations and implementations for Windows. It includes installation instructions, troubleshooting tips, and performance optimizations.
Loading

0 comments on commit ed7dcfa

Please sign in to comment.