Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Dev #57

Merged
merged 45 commits into from
Aug 19, 2024
Merged

Dev #57

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
45 commits
Select commit Hold shift + click to select a range
c903fee
Enhance documentation for the project (#41)
Ston14 Jul 2, 2024
39d1bfe
Add build docs
Jul 2, 2024
cc0b93d
Add more docs (#42)
Ston14 Jul 2, 2024
3400634
Add references (#43)
Ston14 Jul 2, 2024
7cef323
Add references
Jul 2, 2024
b0c2112
Add title
Jul 2, 2024
84e5bad
Title 2
Jul 2, 2024
6c5480f
add : mkdocs navigation references
Jul 2, 2024
a81ed48
document codes
Jul 2, 2024
da1076a
fix typo
Jul 2, 2024
738acfc
typo
Jul 2, 2024
d1bd493
fix typo
Jul 2, 2024
53a97d0
fix typo in utils
Jul 2, 2024
f2fd43f
fix docs in tutorials.md
Jul 2, 2024
0c4456c
add : How to use documentation
Jul 3, 2024
feec9b1
Add other OS documentation
Jul 3, 2024
50504a2
fix how to
Jul 3, 2024
965c4e2
fix : typo in docs
Jul 3, 2024
1567869
fix : typo
Jul 3, 2024
4af47a7
fix: typo in index
Jul 3, 2024
045a091
add : dark mode
Jul 3, 2024
79d61ab
add : colors on documentation
Jul 3, 2024
4d11ea9
fix: diataxis
Jul 3, 2024
05da208
Fix colors
Jul 3, 2024
f51db37
fix readme
Jul 3, 2024
40aa52a
Fix dumpfiles (#46)
Ston14 Jul 11, 2024
cdd3f55
fix: fix error, function without parameter return an error
Jul 12, 2024
df89499
sorry
Jul 12, 2024
1f51127
fix typing information (#47)
YannMagnin Jul 19, 2024
8d7b9d4
Fix/get plugins (#48)
Ston14 Jul 23, 2024
b9771ec
Fix: Correct dict.get() usage in TreeGrid_to_json renderer and remove…
Jul 23, 2024
8adc5aa
oops
Jul 23, 2024
1eb8a72
fix to dataframe
Jul 23, 2024
d8516d2
add test for volatility (#49)
Ston14 Jul 24, 2024
728f451
Merge branch 'master' into dev
Ston14 Jul 25, 2024
ec9ae6c
fix: poetry lock
Jul 25, 2024
a9e7c3d
fix: pytest
Jul 25, 2024
6c0bae8
Merge branch 'master' into dev
Ston14 Jul 25, 2024
78940d4
add documentation
Jul 25, 2024
42a9f17
add documentation
Jul 25, 2024
bef57d1
fix actions
Jul 25, 2024
66fa530
add references
Jul 25, 2024
7225b35
Fix dependancies (#55)
Ston14 Aug 19, 2024
97c1610
Merge branch 'master' into dev
Ston14 Aug 19, 2024
5470572
remove changelog
Aug 19, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
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
6 changes: 0 additions & 6 deletions .github/workflows/release.yml
Original file line number Diff line number Diff line change
Expand Up @@ -29,12 +29,6 @@ jobs:
steps:
- uses: actions/checkout@v3

- name: build change log
id: build_changelog
uses: mikepenz/[email protected]
env:
GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

- uses: actions/setup-python@v3
with:
python-version: ${{ matrix.python-versions }}
Expand Down
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
Loading