PP-P2P-Parser icon indicating copy to clipboard operation
PP-P2P-Parser copied to clipboard
verified publisher icon ChrisRBe

Rework documentation

Open ChrisRBe opened this issue 4 years ago • 3 comments

Current documentation is not user friendly:

  • missing proper guidelines to set up a development environment
  • how to use
  • how to contribute

ChrisRBe avatar Sep 09 '21 18:09 ChrisRBe

Just from my little experience from my last MR:

  1. Install pipenv (example for OSX with brew: brew install pipenv)
  2. Install dependencies for this project with pipenv install
  3. Start a shell that can use all dependencies: pipenv shell
  4. Run all tests: pytest -v --doctest-modules
  5. Automatically format code: black ./src

AlexanderLill avatar Dec 19 '21 12:12 AlexanderLill

is there also a guide or executable windows version

flod1 avatar Feb 08 '23 15:02 flod1

Hi @flod1,

there's currently no executable version available.

You should be able to follow the setup also under Windows:

  1. Download and install Python 3.8 or later (Download from python.org) (unit tests are executed against 3.8 to 3.11)
  2. Open a terminal/cmd and run pip install pipenv
  3. once pipenv is installed navigate to the downloaded (either unpacked archive or via git clone) directory
  4. Install all dependencies via pipenv install (if you also need the dev packages add the --dev parameter)
  5. Enter the virtual env pipenv shell
  6. run the script

ChrisRBe avatar Feb 09 '23 04:02 ChrisRBe