Merge pull request #13 from Riminder/feat/asking-unfolding-apis

feat: asking, authentication, and unfolding APIs; and test suite

Author: corentin-hrflow

.env.example

@@ -1,2 +1,11 @@
 HRFLOW_API_KEY="___FILL_ME___"
-HRFLOW_USER_EMAIL="___FILL_ME___"
+HRFLOW_API_KEY_READ="___FILL_ME___"
+HRFLOW_USER_EMAIL="___FILL_ME___"
+HRFLOW_ALGORITHM_KEY="___FILL_ME___"
+HRFLOW_BOARD_KEY="___FILL_ME___"
+HRFLOW_JOB_KEY="___JOB_KEY_IN_BOARD___"
+HRFLOW_PROFILE_KEY="___PROFILE_KEY_IN_SOURCE_QUICKSILVER_SYNC___"
+HRFLOW_SOURCE_KEY_HAWK_SYNC="___FILL_ME___"
+HRFLOW_SOURCE_KEY_QUICKSILVER_SYNC="___FILL_ME___"
+HRFLOW_SOURCE_KEY_QUICKSILVER_ASYNC="___FILL_ME___"
+HRFLOW_SOURCE_KEY_MOZART_ASYNC="___FILL_ME___"

.flake8

@@ -0,0 +1,6 @@
+[flake8]
+max-line-length = 88
+exclude = .pytest_cache, __pycache__, .env, .venv
+black-config = pyproject.toml
+per-file-ignores = __init__.py:F401
+ignore = E731, W503, E203

.gitignore

@@ -12,6 +12,7 @@ credentials
 credentials_seg
 test/*
 test_assets/*
+tests/assets
 .htpasswd
 
 docker/dependencies/libs/*

Makefile

@@ -4,6 +4,10 @@ ARGS :=
 clean:
 	rm -rf build dist *.egg-info
 
+clean_cache:
+	find . -type d \( -name '__pycache__' -o -name '.pytest_cache' \) -exec rm -rf {} +
+	rm -rf tests/assets
+
 build:
 	poetry build
 
@@ -14,4 +18,13 @@ deploy-test:
 	poetry publish -r test-pypi --build
 
 deploy:
-	poetry publish --build
+	poetry publish --build
+
+flake8:
+	poetry run flake8 --config=./.flake8
+
+style:
+	poetry run isort . && poetry run black --config=./pyproject.toml .
+
+check:
+	bash ./check.sh

README.md

@@ -56,7 +56,7 @@ Install using `pip install -U hrflow` or `conda install hrflow -c conda-forge`.
 
 ```py
 from hrflow import Hrflow
-client = Hrflow(api_secret="YOUR_API_KEY"; api_user="YOU_USER_EMAIL")
+client = Hrflow(api_secret="YOUR_API_KEY", api_user="YOU_USER_EMAIL")
 
 # read file from directory (in binary mode) 
 with open("path_to_file.pdf", "rb") as f:

check.sh

@@ -0,0 +1,13 @@
+#!/bin/bash
+
+PYTEST_RUN="poetry run pytest"
+PYTEST_OPTIONS=(--verbose --tb=long --strict-markers --durations=0 --datefmt "%Y-%m-%d %H:%M:%S.%f%z")
+PYTEST_DIR=tests/
+
+if [ "$#" -gt 0 ]; then
+    for marker in "$@"; do
+        $PYTEST_RUN "${PYTEST_OPTIONS[@]}" "$PYTEST_DIR" -m "$marker"
+    done
+else
+    $PYTEST_RUN "${PYTEST_OPTIONS[@]}" "$PYTEST_DIR"
+fi

hrflow/__init__.py

@@ -1,4 +1,10 @@
+from .__version__ import (
+    __author__,
+    __author_email__,
+    __description__,
+    __license__,
+    __title__,
+    __url__,
+    __version__,
+)
 from .hrflow.hrflow import Hrflow
-
-from .__version__ import __title__, __description__, __url__, __version__
-from .__version__ import __author__, __author_email__, __license__

hrflow/__version__.py

@@ -6,4 +6,4 @@
 __version__ = importlib.metadata.version("hrflow")
 __author__ = "HrFlow.ai"
 __author_email__ = "contact@hrflow.ai"
-__license__ = "MIT"
+__license__ = "MIT"

hrflow/hrflow/auth/__init__.py

@@ -0,0 +1,35 @@
+import typing as t
+
+from ..utils import validate_key, validate_response
+
+API_SECRET_REGEX = r"^ask[rw]?_[0-9a-f]{32}$"
+
+
+class Auth:
+    def __init__(self, api):
+        self.client = api
+
+    def get(self) -> t.Dict[str, t.Any]:
+        """
+        Try your API Keys. This endpoint allows you to learn how to add the right
+        information to your API calls, so you can make them.
+
+        Args:
+            api_user:       <str>
+                            Your HrFlow.ai account's email.
+            api_secret:     <str>
+                            Your API Key.
+
+        Returns:
+            `/auth` response
+        """
+
+        validate_key(
+            "api_secret",
+            self.client.auth_header.get("X-API-KEY"),
+            regex=API_SECRET_REGEX,
+        )
+
+        response = self.client.get("auth")
+
+        return validate_response(response)

hrflow/hrflow/board/__init__.py

@@ -1,31 +1,35 @@
-from ..utils import validate_key, validate_page, validate_limit, validate_value, validate_response
-
-from ..utils import ORDER_BY_VALUES
+from ..utils import (
+    ORDER_BY_VALUES,
+    validate_key,
+    validate_limit,
+    validate_page,
+    validate_response,
+    validate_value,
+)
 
 
 class Board(object):
-
     def __init__(self, client):
         self.client = client
 
-    def list(self, name=None, page=1, limit=30, sort_by='date', order_by='desc'):
+    def list(self, name=None, page=1, limit=30, sort_by="date", order_by="desc"):
         """
-            Search boards for given filters.
-
-            Args:
-                name:             <string>
-                                  name
-                page:             <integer>
-                                  page
-                limit:            <integer>
-                                  limit
-                sort_by:          <string>
-                                  sort_by
-                order_by:         <string>
-                                  order_by
-
-            Returns
-                Result of source's search
+        Search boards for given filters.
+
+        Args:
+            name:             <string>
+                              name
+            page:             <integer>
+                              page
+            limit:            <integer>
+                              limit
+            sort_by:          <string>
+                              sort_by
+            order_by:         <string>
+                              order_by
+
+        Returns
+            Result of source's search
 
         """
         query_params = {}
@@ -40,15 +44,15 @@ def list(self, name=None, page=1, limit=30, sort_by='date', order_by='desc'):
 
     def get(self, key=None):
         """
-            Get source given a board key.
+        Get source given a board key.
 
-            Args:
-                key:         <string>
-                             board_key
-            Returns
-                Board if exists
+        Args:
+            key:         <string>
+                         board_key
+        Returns
+            Board if exists
 
         """
         query_params = {"key": validate_key("Board", key)}
-        response = self.client.get('board', query_params)
+        response = self.client.get("board", query_params)
         return validate_response(response)