Skip to content

Commit ca53eef

Browse files
committed
Initial commit
0 parents  commit ca53eef

File tree

1 file changed

+49
-0
lines changed

1 file changed

+49
-0
lines changed

README.md

Lines changed: 49 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,49 @@
1+
# dissect.executable
2+
3+
A Dissect module implementing a parsers for various executable formats such as PE, ELF and Macho-O. For
4+
more information, please see [the documentation](https://docs.dissect.tools/en/latest/projects/dissect.executable/index.html).
5+
6+
## Installation
7+
8+
`dissect.executable` is available on [PyPI](https://pypi.org/project/dissect.executable/).
9+
10+
```bash
11+
pip install dissect.executable
12+
```
13+
14+
This module is also automatically installed if you install the `dissect` package.
15+
16+
## Build and test instructions
17+
18+
This project uses `tox` to build source and wheel distributions. Run the following command from the root folder to build
19+
these:
20+
21+
```bash
22+
tox -e build
23+
```
24+
25+
The build artifacts can be found in the `dist/` directory.
26+
27+
`tox` is also used to run linting and unit tests in a self-contained environment. To run both linting and unit tests
28+
using the default installed Python version, run:
29+
30+
```bash
31+
tox
32+
```
33+
34+
For a more elaborate explanation on how to build and test the project, please see [the
35+
documentation](https://docs.dissect.tools/en/latest/contributing/developing.html#building-testing).
36+
37+
## Contributing
38+
39+
The Dissect project encourages any contribution to the codebase. To make your contribution fit into the project, please
40+
refer to [the style guide](https://docs.dissect.tools/en/latest/contributing/style-guide.html).
41+
42+
## Copyright and license
43+
44+
Dissect is released as open source by Fox-IT (<https://www.fox-it.com>) part of NCC Group Plc
45+
(<https://www.nccgroup.com>).
46+
47+
Developed by the Dissect Team (<[email protected]>) and made available at <https://github.com/fox-it/dissect>.
48+
49+
License terms: AGPL3 (<https://www.gnu.org/licenses/agpl-3.0.html>). For more information, see the LICENSE file.

0 commit comments

Comments
 (0)