XanaduAI · josh146 · Mar 19, 2020 · Feb 19, 2020 · Feb 19, 2020 · Feb 19, 2020
diff --git a/.github/CHANGELOG.md b/.github/CHANGELOG.md
diff --git a/.gitignore b/.gitignore
@@ -13,8 +13,8 @@ notebooks/*
 examples/.ipynb_checkpoints/*
 .pytest_cache/*
 pytest/.pytest_cache/
-doc/tutorials_apps/*
 examples_apps/*.html
 doc/_static/thumbs/*
+doc/tutorials_apps/*
 !doc/_static/code.png
 doc/code/api/*
diff --git a/.travis.yml b/.travis.yml
@@ -10,14 +10,14 @@ env:
     - LOGGING=info
 matrix:
   include:
-    - env: OPTIONS="frontend or fock or gaussian or apps"
+    - env: OPTIONS="frontend or fock or gaussian or apps or api"
     - env: OPTIONS="tf and pure"
     - env: OPTIONS="tf and mixed"
     - env: BATCHED=1 OPTIONS="tf and pure"
     - env: BATCHED=1 OPTIONS="tf and mixed"
 install:
   - pip install -r requirements.txt
-  - pip install wheel codecov pytest pytest-cov --upgrade
+  - pip install wheel codecov pytest==5.3 pytest-cov --upgrade
   - python3 setup.py bdist_wheel
   - pip install dist/StrawberryFields*.whl
 script:

diff --git a/Makefile b/Makefile
@@ -33,11 +33,13 @@ dist:
 .PHONY : clean
 clean:
 	rm -rf strawberryfields/__pycache__
+	rm -rf strawberryfields/api/__pycache__
 	rm -rf strawberryfields/backends/__pycache__
 	rm -rf strawberryfields/backends/fockbackend/__pycache__
 	rm -rf strawberryfields/backends/tfbackend/__pycache__
 	rm -rf strawberryfields/backends/gaussianbackend/__pycache__
 	rm -rf tests/__pycache__
+	rm -rf tests/api/__pycache__
 	rm -rf tests/backend/__pycache__
 	rm -rf tests/frontend/__pycache__
 	rm -rf tests/integration/__pycache__
@@ -51,7 +53,7 @@ docs:
 clean-docs:
 	make -C doc clean
 
-test: test-frontend test-gaussian test-fock test-tf batch-test-tf test-apps
+test: test-frontend test-gaussian test-fock test-tf batch-test-tf test-apps test-api
 
 test-%:
 	@echo "Testing $(subst test-,,$@) backend..."
@@ -61,7 +63,7 @@ batch-test-%:
 	@echo "Testing $(subst batch-test-,,$@) backend in batch mode..."
 	export BATCHED=1 && $(PYTHON) $(TESTRUNNER) -m $(subst batch-test-,,"$@")
 
-coverage: coverage-frontend coverage-gaussian coverage-fock coverage-tf batch-coverage-tf coverage-apps
+coverage: coverage-frontend coverage-gaussian coverage-fock coverage-tf batch-coverage-tf coverage-apps coverage-api
 
 coverage-%:
 	@echo "Generating coverage report for $(subst coverage-,,$@)..."

diff --git a/README.rst b/README.rst
@@ -53,35 +53,13 @@ Features
 Installation
 ============
 
-Strawberry Fields requires Python version 3.5, 3.6, or 3.7 (3.8 is currently not support). Installation of Strawberry Fields, as well as all dependencies, can be done using pip:
+Strawberry Fields requires Python version 3.5, 3.6, 3.7, or 3.8. Installation of Strawberry Fields, as well as all dependencies, can be done using pip:
 
 .. code-block:: bash
 
     pip install strawberryfields
 
 
-TensorFlow support
-------------------
-
-To use Strawberry Fields with TensorFlow, version 1.3 of
-TensorFlow is required. This can be installed alongside Strawberry Fields
-as follows:
-
-.. code-block:: console
-
-    pip install strawberryfields tensorflow==1.3
-
-Or, to install Strawberry Fields and TensorFlow with GPU and CUDA support:
-
-.. code-block:: console
-
-    pip install strawberryfields tensorflow-gpu==1.3
-
-
-Note that TensorFlow version 1.3 is only supported on Python versions
-less than 3.7.
-
-
 Getting started
 ===============
 

diff --git a/default_config.toml b/default_config.toml
@@ -5,8 +5,8 @@
 [api]
 # Options for the Strawberry Fields Cloud API
 # Fill in your authentication
-authentatication_token = None # example token form: 071cdcce-9241-4965-93af-4a4dbc739135
+authentication_token = None # example token form: 071cdcce-9241-4965-93af-4a4dbc739135
 # Fill in the hostname of the Cloud API
-hostname = "localhost"
+hostname = "platform.strawberryfields.ai"
 # Whether Strawberry Fields should use SSL to connect to the API
 use_ssl = true
diff --git a/doc/_static/xanadu_gallery.css b/doc/_static/xanadu_gallery.css
@@ -227,7 +227,8 @@ p.sphx-glr-signature a.reference.external {
 
 
 .sphx-glr-download-link-note.admonition.note,
-.reference.download.internal,
+.sphx-glr-download,
+.sphx-glr-footer,
 .sphx-glr-signature {
   display: none;
 }

diff --git a/doc/code/sf_api.rst b/doc/code/sf_api.rst
@@ -0,0 +1,14 @@
+sf.api
+======
+
+.. currentmodule:: strawberryfields.api
+
+.. warning::
+
+    Unless you are a Strawberry Fields developer, you likely do not need
+    to use these classes directly.
+
+.. automodapi:: strawberryfields.api
+    :no-heading:
+    :no-inheritance-diagram:
+    :include-all-objects:
diff --git a/doc/code/sf_cli.rst b/doc/code/sf_cli.rst
@@ -0,0 +1,127 @@
+sf.cli
+======
+
+.. currentmodule:: strawberryfields.cli
+
+The Strawberry Fields command line program ``sf`` provides several utilities
+including:
+
+* ``sf configure [--token] [--local]``: configure the connection to the cloud platform
+
+* ``sf run input [--output FILE]``: submit and execute quantum programs from the command line
+
+* ``sf --ping``: verify your connection to the Xanadu cloud platform.
+
+
+Configure
+---------
+
+Using the ``sf configure`` command to create a configuration file on Linux:
+
+.. code-block:: bash
+
+    $ sf configure --token MYAUTH
+    $ cat  ~/.config/strawberryfields/config.toml
+    [api]
+    authentication_token = "MYAUTH"
+    hostname = "platform.strawberryfields.ai"
+    use_ssl = true
+    port = 443
+
+Using the ``sf configure`` command to create a configuration file on Windows:
+
+.. code-block:: ps1con
+
+    C:\> sf configure --token MYAUTH
+    C:\> cat C:\Users\USERNAME\AppData\Local\Xanadu\strawberryfields\config.toml
+    [api]
+    authentication_token = "MYAUTH"
+    hostname = "platform.strawberryfields.ai"
+    use_ssl = true
+    port = 443
+
+**Flags:**
+
+* ``--token``: The authentication token to use.
+* ``--local``: Whether or not to create the configuration file locally in the current directory.
+
+If not provided, the configuration file will be saved in the users configuration directory.
+
+Configuration wizard
+~~~~~~~~~~~~~~~~~~~~
+
+For more advanced configuration options, the configuration wizard can be used.
+
+Here we show how the interactive wizard can be used to configure each API
+option. Once done, we have a look at the newly created configuration file.
+
+Example run in a Linux based operating system:
+
+.. code-block:: bash
+
+    $ sf configure
+    Please enter the authentication token to use when connecting: [] MYAUTH
+    Please enter the hostname of the server to connect to: [platform.strawberryfields.ai] MYHOST
+    Should the client attempt to connect over SSL? [y] N
+    Please enter the port number to connect with: [443] 12345
+
+    $cat  ~/.config/strawberryfields/config.toml
+    [api]
+    authentication_token = "MYAUTH"
+    hostname = "MYHOST"
+    use_ssl = false
+    port = "12345"
+
+The same example run on a Windows operating system:
+
+.. code-block:: powershell
+
+    $ sf configure
+    Please enter the authentication token to use when connecting: [] MYAUTH
+    Please enter the hostname of the server to connect to: [platform.strawberryfields.ai] MYHOST
+    Should the client attempt to connect over SSL? [y] N
+    Please enter the port number to connect with: [443] 12345
+
+    $ cat C:\Users\USERNAME\AppData\Local\Xanadu\strawberryfields\config.toml
+    [api]
+    authentication_token = "MYAUTH"
+    hostname = "MYHOST"
+    use_ssl = false
+    port = "12345"
+
+Testing your connection
+-----------------------
+
+To test that your account credentials correctly authenticate against the cloud platform, the ``ping`` flag can be used:
+
+.. code-block:: bash
+
+    $ sf --ping
+    You have successfully authenticated to the platform!
+
+Submitting jobs
+---------------
+
+To execute a Blackbird ``.xbb`` file from the command line, the ``sf run`` command
+line program can be used:
+
+.. code-block:: console
+
+    sf run test.xbb --output out.txt
+
+After executing the above command, the result will be stored in ``out.txt``
+in the current working directory.
+You can also omit the ``--output`` parameter to print the result to the screen.
+
+Functions
+---------
+
+.. warning::
+
+    Unless you are a Strawberry Fields developer, you likely do not need
+    to access the functions in this module directly.
+
+.. automodapi:: strawberryfields.cli
+    :no-heading:
+    :no-inheritance-diagram:
+    :skip: store_account, create_config, load, RemoteEngine, Connection, ConfigurationError
diff --git a/doc/code/sf_configuration.rst b/doc/code/sf_configuration.rst
@@ -0,0 +1,17 @@
+sf.configuration
+================
+
+.. currentmodule:: strawberryfields.configuration
+
+.. warning::
+
+    Unless you are a Strawberry Fields developer, you likely do not need
+    to access this module directly.
+
+    See the :doc:`/introduction/configuration` page for more information on
+    configuring Strawberry Fields.
+
+.. automodapi:: strawberryfields.configuration
+    :no-heading:
+    :skip: user_config_dir
+    :no-inheritance-diagram:
diff --git a/doc/conf.py b/doc/conf.py
@@ -58,9 +58,12 @@ def __getattr__(cls, name):
     'sphinx_gallery.gen_gallery',
     "sphinx.ext.intersphinx",
     "sphinx_automodapi.automodapi",
-    'sphinx_copybutton'
+    'sphinx_copybutton',
+    "m2r"
 ]
 
+source_suffix = ['.rst', '.md']
+
 from glob import glob
 import shutil
 import warnings

diff --git a/doc/development/release_notes.md b/doc/development/release_notes.md
@@ -0,0 +1,6 @@
+Release notes
+-------------
+
+This page contains the release notes for PennyLane.
+
+.. mdinclude:: ../../.github/CHANGELOG.md
diff --git a/doc/development/research.rst b/doc/development/research.rst
@@ -1,7 +1,7 @@
 .. _research:
 
 Research and contribution
-===============================
+=========================
 
 Research
 ---------------
@@ -34,15 +34,7 @@ If you are having issues, please let us know by posting the issue on our Github
 
 To chat directly with the team designing and building Strawberry Fields, as well as members of our
 community - ranging from professors of quantum physics, to students, to those just interested in being a
-part of a rapidly growing industry - you can join our `Slack channel <https://u.strawberryfields.ai/slack>`_.
-
-Available channels:
-
-* ``#strawberryfields``: For general discussion regarding Strawberry Fields
-* ``#sf_projects``: For discussion of research ideas and projects built on Strawberry Fields
-* ``#sf_bugs``: For discussion of any bugs and issues you run into using Strawberry Fields
-* ``#sf_interactive``: For discussion relating to the `Strawberry Fields Interactive <https://strawberryfields.ai>`_ web application
-* ``#sf_docs``: For discussion of the Strawberry Fields `documentation <https://strawberryfields.readthedocs.io>`_
+part of a rapidly growing industry - you can join our `discussion forum <https://discuss.pennylane.ai>`_ and `Slack channel <https://u.strawberryfields.ai/slack>`_.
 
 Sometimes, it might take us a couple of hours to reply - please be patient!
 

diff --git a/doc/index.rst b/doc/index.rst
@@ -128,7 +128,9 @@ Support
 - **Source Code:** https://github.com/XanaduAI/strawberryfields
 - **Issue Tracker:** https://github.com/XanaduAI/strawberryfields/issues
 
-If you are having issues, please let us know by posting the issue on our Github issue tracker, or by joining our `Strawberry Fields Slack channel <https://u.strawberryfields.ai/slack>`_.
+If you are having issues, please let us know by posting the issue on our Github issue tracker.
+
+To chat directly with the team designing and building Strawberry Fields, as well as members of our community — ranging from quantum computing researchers, to students, to those just interested in being a part of a rapidly growing industry — you can join our `discussion forum <https://discuss.pennylane.ai>`_ and `Slack channel <https://u.strawberryfields.ai/slack>`_.
 
 For more details on contributing or performing research with Strawberry Fields, please see
 :ref:`research`.
@@ -154,6 +156,7 @@ Strawberry Fields is **free** and **open source**, released under the Apache Lic
    introduction/ops
    introduction/states
    introduction/tutorials
+   introduction/configuration
    zreferences
 
 .. toctree::
@@ -163,6 +166,7 @@ Strawberry Fields is **free** and **open source**, released under the Apache Lic
 
    development/development_guide
    development/research
+   development/release_notes.md
 
 .. toctree::
    :maxdepth: 1
@@ -171,14 +175,17 @@ Strawberry Fields is **free** and **open source**, released under the Apache Lic
 
    code/sf
    code/sf_apps
-   code/sf_ops
-   code/sf_utils
+   code/sf_api
    code/sf_backends
    code/sf_circuitspecs
    code/sf_circuitdrawer
+   code/sf_cli
+   code/sf_configuration
    code/sf_decompositions
    code/sf_engine
    code/sf_io
+   code/sf_ops
    code/sf_program
    code/sf_program_utils
    code/sf_parameters
+   code/sf_utils