Skip to content

Commit 33c0cd5

Browse files
authored
Merge pull request #34 from mandiant/feat/poetry_packaging
Poetry packaging and dependency updates
2 parents 342dfcc + e2950fc commit 33c0cd5

File tree

17 files changed

+679
-655
lines changed

17 files changed

+679
-655
lines changed

.dockerignore

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
.dockerignore
2+
.git
3+
.github
4+
gha-creds-*.json
5+
**/__pycache__
6+
.pytest_cache
7+
*.egg-info
8+
*.egg
9+
**/*.py[cod]
10+
build
11+
dist

LICENSE

100755100644
File mode changed.

MANIFEST.in

Lines changed: 0 additions & 13 deletions
This file was deleted.

Pipfile

Lines changed: 0 additions & 28 deletions
This file was deleted.

Pipfile.lock

Lines changed: 0 additions & 514 deletions
This file was deleted.

README.md

100755100644
Lines changed: 11 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -7,38 +7,34 @@
77
StringSifter is a machine learning tool that automatically ranks strings based on their relevance for malware analysis.
88

99
# Quick Links
10-
* [Technical Blogpost - *Learning to Rank Strings Output for Speedier Malware Analysis*](https://www.fireeye.com/blog/threat-research/2019/05/learning-to-rank-strings-output-for-speedier-malware-analysis.html)
11-
* [Announcement Blogpost - *Open Sourcing StringSifter*](https://www.fireeye.com/blog/threat-research/2019/09/open-sourcing-stringsifter.html)
10+
* [Technical Blogpost - *Learning to Rank Strings Output for Speedier Malware Analysis*](https://www.mandiant.com/resources/blog/learning-rank-strings-output-speedier-malware-analysis)
11+
* [Announcement Blogpost - *Open Sourcing StringSifter*](https://www.mandiant.com/resources/blog/open-sourcing-stringsifter)
1212
* [DerbyCon Talk - *StringSifter: Learning to Rank Strings Output for Speedier Malware Analysis*](https://youtu.be/pLiaVzOMJSk)
1313
* [StringSifter releases on PyPi](https://pypi.org/project/stringsifter/)
1414

1515
# Usage
1616

17-
StringSifter requires Python version 3.6 or newer. Run the following commands to get the code, run unit tests, and use the tool:
17+
StringSifter requires Python version 3.9 or newer. Run the following commands to get the code, run unit tests, and use the tool:
1818

1919
## Installation
2020

21-
Use `pip` to get running immediately. Choose the major version corresponding to your version of python:
22-
23-
| Python Version | Stringsifter Version | Branch | Example Pip Command |
24-
| -------------- | -------------------- | --------- | ------------------------------- |
25-
| 3.8+ | 2.x | master | `pip install stringsifter~=2.0` |
26-
| 3.6, 3.7 | 1.x | python3.7 | `pip install stringsifter~=1.0` |
21+
```sh
22+
pip install stringsifter
23+
```
2724

28-
For development, check out the correct branch for your Python version or stay on master for the latest supported version. Then use `pipenv`:
25+
For development, use [poetry](https://python-poetry.org/):
2926
```sh
30-
git clone https://github.com/fireeye/stringsifter.git
27+
git clone https://github.com/mandiant/stringsifter.git
3128
cd stringsifter
32-
git checkout python3.7 #Optional
33-
pipenv install --dev
29+
poetry install --with dev
3430
```
3531

3632
## Running Unit Tests
3733

3834
To run unit tests from the StringSifter installation directory:
3935

4036
```sh
41-
pipenv run tests
37+
poetry run tests -v
4238
```
4339

4440
## Running from the Command Line
@@ -139,4 +135,4 @@ We use [GitHub Issues](https://github.com/fireeye/stringsifter/issues) for posti
139135
- Thanks to the FireEye Data Science (FDS) and FireEye Labs Reverse Engineering (FLARE) teams for review and feedback.
140136
- StringSifter was designed and developed by Philip Tully (FDS), Matthew Haigh (FLARE), Jay Gibble (FLARE), and Michael Sikorski (FLARE).
141137
- The StringSifter logo was designed by Josh Langner (FLARE).
142-
- `flarestrings` is derived from the excellent tool [FLOSS](https://github.com/fireeye/flare-floss/blob/master/floss/strings.py#L7-L9).
138+
- `flarestrings` is derived from the excellent tool [FLOSS](https://github.com/mandiant/flare-floss).

docker/Dockerfile

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,9 @@
1-
FROM python:3.8
2-
3-
RUN pip install --upgrade pip pipenv
1+
FROM python:3.9
42

53
WORKDIR /src/stringsifter
64
COPY . /src/stringsifter
75

8-
RUN pipenv install --system --deploy
6+
RUN pip install -r requirements.txt
97
RUN pip install -e /src/stringsifter
108

119
CMD [ "/bin/bash" ]

0 commit comments

Comments
 (0)