Modern MISP - API
Requirements
- Docker
latest-stable
Getting Started
Clone the project and install Python version 3.11.0. It is recommended to install Python using pyenv. Then install all dependencies by typing make setup into your terminal and start your local database container using make up.
Create a file called .env and copy the contents of .env.example into it. Finally, start the development server using make dev.
You should now be able to access the api on localhost:4000.
To use the commandline tool run python .\src\mmisp\commandline_tool\main.py --h from the base directory to view all commands. For detailed information of all commands: python .\src\mmisp\commandline_tool\main.py --help.
For setting up the DB use the commandline tool option for setup and then create your user account. In case you have not created a new organisation yet, please add your account to the setup basic organisation: ghost_org.
Run tests using make test (local database container required running) or make test/lite.
Setting up your IDE
Be sure to use the newly created virtual env as your interpreter (./venv/bin/python). Also install the Ruff extension for your IDE and set Ruff as your default code formatter. It is recommended to activate formatting your code on every save.
Best Practices
General Guidelines
The following are some guidelines for writing code, in no particular order:
- Try to write clean code
- Use the "early return" pattern, do you really need that
elseblock? - Add correct types wherever possible, reduce
Anyoccurrences as much as possible - Reduce database calls
- Be consistent within your code, and within the rest of the codebase
- Use whitespace generously, to group and separate lines of code
- Be explicit, magic is great until it is not
Endpoint Ordering
Try to order endpoints using CRUD so that the following order is achieved:
- Create a {resource}
- Read / Get a {resource}
- Update a {resource}
- Delete a {resource}
- Get all {resource}s
- More niche endpoints
- Deprecated endpoints
1 maintainer
Metadata
1 maintainer
Release files for mmisp-lib 0.14.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mmisp_lib-0.14.1.tar.gz | 131.0 kB | Details |
Release files / mmisp_lib-0.14.1.tar.gz
| Download URL | mmisp_lib-0.14.1.tar.gz |
|---|---|
| Size | 131.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
639792902576da41011220f3ab7f52e742f99ffdcfd223ea83dcc57d4f7fc86d
|
|
BLAKE2b-256 checksum How to use checksums |
f0103ca0c5a1fa4a040f5c07b8b02b2779b683e3834b409a6890402d19ab55a9
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/7.0.0 CPython/3.11.16
|
