Update README and development setup

Author: jansel

README.md

@@ -16,58 +16,42 @@ ensembles of disparate search techniques simultaneously, techniques which
 perform well will receive larger testing budgets and techniques which perform
 poorly will be disabled.
 
-System dependencies
--------------------
-
-A list of system dependencies can be found in [debian-packages-deps][]
-which are primarily python 2.6+ (not 3.x) and sqlite3 (or your
-[supported][sqlalchemy-dialects] database backend of choice).
-
-On Ubuntu/Debian there can be installed with:
-
-    sudo apt-get install `cat debian-packages-deps | tr '\n' ' '`
-
-[debian-packages-deps]: https://raw.github.com/jansel/opentuner/master/debian-packages-deps
-[sqlalchemy-dialects]: http://docs.sqlalchemy.org/en/rel_0_8/dialects/index.html
-
 
 Installation
 -------------------
-OpenTuner (and dependencies) can be installed with
+
+OpenTuner requires python 3.7+ and sqlite3 (or your
+[supported][sqlalchemy-dialects] database backend of choice).
+Install with:
 
     sudo pip install opentuner
 
 or
 
     pip install --user opentuner
 
-This will not install any of the example programs.
-
+[sqlalchemy-dialects]: http://docs.sqlalchemy.org/en/rel_0_8/dialects/index.html
 
 Development installation
 -------------------
-For development (running OpenTuner out of a git checkout), a list of python
-dependencies can be found in [requirements.txt][] these can be installed
-system-wide with `pip`.
-
-    sudo apt-get install python-pip
-    sudo pip install -r requirements.txt
 
-Or you can use virtual env to create a isolated python environment by running:
+For development or running examples out of a git checkout, we recommend using
+[miniconda3](https://docs.conda.io/en/latest/miniconda.html).
 
-    python ./venv-bootstrap.py
-
-which will create a ./venv/bin/python (./venv/Scripts/python.exe on windows)
-with all the required packages installed.
-
-[requirements.txt]: https://raw.github.com/jansel/opentuner/master/requirements.txt
+    conda create --name=opentuner python=3.8
+    conda activate opentuner
+    pip install -r requirements.txt -r optional-requirements.txt
+    python setup.py develop
 
 
 Checking Installation
 ---------------------
 
-Quickly checking that a successful installation has been made, may be performed
-by running an example program such as:
+To check an installation you can run tests:
+
+    pytest tests/*
+
+Or run an example program:
 
     ./examples/rosenbrock/rosenbrock.py
 

debian-packages-deps

@@ -5,7 +5,6 @@
 from builtins import filter
 from builtins import range
 from past.utils import old_div
-import adddeps  # fix sys.path
 
 import math
 import argparse

examples/gccflags/adddeps.py

@@ -4,7 +4,6 @@
 #
 # This is an extremely simplified version meant only for tutorials
 #
-import adddeps  # fix sys.path
 
 import opentuner
 from opentuner import ConfigurationManipulator

examples/gccflags/gccflags.py

@@ -22,7 +22,6 @@
 from builtins import input
 from builtins import range
 from builtins import object
-import adddeps  # fix sys.path
 
 import argparse
 import collections

examples/gccflags/gccflags_minimal.py

@@ -1,18 +1,13 @@
 from __future__ import print_function
-from builtins import str
-import adddeps  # fix sys.path
 
 import argparse
 import logging
+from builtins import str
 
 import opentuner
-from opentuner.search.manipulator import (ConfigurationManipulator,
-                                          IntegerParameter,
-                                          FloatParameter)
-from opentuner.search.objective import MinimizeTime
 from opentuner.measurement import MeasurementInterface
-from opentuner.measurement.inputmanager import FixedInputManager
-from opentuner.tuningrunmain import TuningRunMain
+from opentuner.search.manipulator import (ConfigurationManipulator,
+                                          IntegerParameter)
 
 log = logging.getLogger(__name__)
 
@@ -29,7 +24,7 @@
 class HPLinpack(MeasurementInterface):
     def run(self, desired_result, input, limit):
         self.output_hpl_datfile(desired_result.configuration.data)
-        import subprocess, os
+        import subprocess
         binary = self.args.xhpl
         subprocess.call(["mpirun", "-np", str(self.args.nprocs), binary])
 

examples/halide/adddeps.py

@@ -13,7 +13,6 @@
 from builtins import range
 from past.utils import old_div
 from builtins import object
-import adddeps  # fix sys.path
 import argparse
 import base64
 import pickle
@@ -31,9 +30,6 @@
 import opentuner
 from opentuner.search.manipulator import ConfigurationManipulator, IntegerParameter, EnumParameter, BooleanParameter
 from opentuner.measurement import MeasurementInterface
-from opentuner.measurement.inputmanager import FixedInputManager
-from opentuner.tuningrunmain import TuningRunMain
-from opentuner.search.objective import MinimizeTime
 from future.utils import with_metaclass
 
 

examples/halide/halidetuner.py

@@ -1,7 +1,6 @@
 #!/usr/bin/env python
 
 from __future__ import print_function
-import adddeps  # fix sys.path
 
 import argparse
 import json

examples/hpl/adddeps.py

@@ -2,27 +2,24 @@
 
 from __future__ import division
 from __future__ import print_function
-from builtins import range
-from past.utils import old_div
-import adddeps  # fix sys.path
 
-import re
 import argparse
+import json
 import logging
+import re
 import subprocess
 import tempfile
-import json
+from builtins import range
 from pprint import pprint
 
+from past.utils import old_div
+
 import opentuner
 from opentuner.search.manipulator import (ConfigurationManipulator,
                                           IntegerParameter,
                                           LogIntegerParameter,
-                                          FloatParameter,
-                                          LogFloatParameter,
                                           SelectorParameter,
-                                          SwitchParameter,
-                                          PermutationParameter, )
+                                          SwitchParameter)
 
 try:
     from lxml import etree

examples/hpl/hpl.py

@@ -8,7 +8,6 @@
 from __future__ import print_function
 
 from builtins import range
-import adddeps  # add opentuner to path in dev mode
 
 import opentuner
 from opentuner.api import TuningRunManager

examples/mario/adddeps.py

@@ -11,7 +11,6 @@
 
 from builtins import zip
 from builtins import range
-import adddeps  # add opentuner to path in dev mode
 
 import opentuner
 from opentuner.api import TuningRunManager

examples/mario/mario.py

@@ -10,7 +10,6 @@
 
 from __future__ import print_function
 from builtins import range
-import adddeps  # fix sys.path
 
 import argparse
 import logging

examples/petabricks/adddeps.py

@@ -5,19 +5,13 @@
 # http://en.wikipedia.org/wiki/Travelling_salesman_problem
 #
 
-from builtins import range
-import adddeps  # fix sys.path
-
 import argparse
-import logging
+from builtins import range
 
 import opentuner
+from opentuner.measurement import MeasurementInterface
 from opentuner.search.manipulator import (ConfigurationManipulator,
                                           PermutationParameter)
-from opentuner.search.objective import MinimizeTime
-from opentuner.measurement import MeasurementInterface
-from opentuner.measurement.inputmanager import FixedInputManager
-from opentuner.tuningrunmain import TuningRunMain
 
 parser = argparse.ArgumentParser(parents=opentuner.argparsers())
 parser.add_argument('data', help='distance matrix file')

examples/petabricks/import_old_result.py

@@ -5,7 +5,6 @@
 # This is an extremely simplified version meant only for tutorials
 #
 from __future__ import print_function
-import adddeps  # fix sys.path
 
 import opentuner
 from opentuner import ConfigurationManipulator

examples/petabricks/pbtuner.py

@@ -14,7 +14,6 @@
 from __future__ import print_function
 from builtins import range
 from past.utils import old_div
-import adddeps  # fix sys.path
 
 import argparse
 import logging

examples/py_api/adddeps.py

@@ -1,3 +1,4 @@
 django
 matplotlib
-virtualenv
+pytest
+pypandoc