first commit

Author: eisuke-ueta

.gitignore

@@ -0,0 +1,8 @@
+/**/__pycache__
+/**/.pytest_cache
+/**/*.pem
+.DS_Store
+.pytest_cache
+dist
+build
+fastlabel.egg-info

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2020 FastLabel Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

MANIFEST.in

@@ -0,0 +1,2 @@
+include requirements.txt
+include README.md

README.md

@@ -0,0 +1,69 @@
+# FastLabel Python SDK
+
+## Installation
+
+```bash
+$ pip install fastlabel
+```
+
+## Usage
+
+Configure API Key in environment variable.
+
+```bash
+export FASTLABEL_API_KEY="YOUR_API_KEY"
+```
+
+Initialize fastlabel client.
+
+```python
+import fastlabel
+client = fastlabel.Client()
+```
+
+## Model Analysis
+
+### Upload Predictions
+
+```python
+import fastlabel
+from fastlabel.const import AnalysisType
+
+# Initialize client
+client = fastlabel.Client()
+
+# Create predictions
+const predictions = [
+    {
+        fileKey="sample1.jpg",  # file name exists in project
+        labels=[
+            {
+                "value": "line_a",  # class value exists in project
+                "points": [
+                    { "x": 10, "y": 10 },
+                    { "x": 20, "y": 20 },
+                ]
+            },
+            {
+                "value": "line_b",
+                "points": [
+                    { "x": 30, "y": 30 },
+                    { "x": 40, "y": 40 },
+                ]
+            }
+        ]
+    }
+]
+
+# Upload predictions
+client.upload_predictions(
+    project_id="project_id",    # your fastlabel project id
+    analysis_type=AnalysisType.line,    # annotation type to be analyze
+    threshold=20,   # IoU percentage/pixel to analyze labels. (Ex: 0 - 100)
+    predictions=predictions
+)
+```
+
+## API Docs
+
+Check [this](https://api-fastlabel-production.web.app/api/doc/) for further information.

fastlabel/__init__.py

@@ -0,0 +1,88 @@
+import logging
+import os
+import requests
+from fastlabel.const import AnalysisType
+
+FASTLABEL_ENDPOINT = "https://api-fastlabel-production.web.app/api/v1/"
+
+class Client:
+
+    api_key = None
+
+    def __init__(self) -> None:
+        if not os.environ.get('FASTLABEL_API_KEY'):
+            raise ValueError("FASTLABEL_API_KEY is not configured.")
+        self.api_key = "Bearer " + os.environ.get('FASTLABEL_API_KEY')
+
+    def _getrequest(self, endpoint: str, params=None) -> dict:
+        """Makes a get request to an endpoint.
+        If an error occurs, assumes that endpoint returns JSON as:
+            { 'status_code': XXX,
+              'error': 'I failed' }
+        """
+        params = params or {}
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": self.api_key,
+        }
+        r = requests.get(FASTLABEL_ENDPOINT + endpoint,
+                         headers=headers, params=params)
+
+        if r.status_code == 200:
+            return r.json()
+        else:
+            try:
+                error = r.json()['error']
+            except ValueError:
+                error = r.text
+            if r.status_code == 400:
+                raise FastLabelInvalidException(error, r.status_code)
+            else:
+                raise FastLabelException(error, r.status_code)
+    
+    def _postrequest(self, endpoint, payload=None):
+        """Makes a post request to an endpoint.
+        If an error occurs, assumes that endpoint returns JSON as:
+            { 'status_code': XXX,
+              'error': 'I failed' }
+        """
+        payload = payload or {}
+        headers = {
+            "Content-Type": "application/json",
+            "Authorization": self.api_key,
+        }
+        r = requests.post(FASTLABEL_ENDPOINT + endpoint, json=payload, headers=headers)
+
+        if r.status_code == 200:
+            return r.json()
+        else:
+            try:
+                error = r.json()['error']
+            except ValueError:
+                error = r.text
+            if r.status_code == 400:
+                raise FastLabelInvalidException(error, r.status_code)
+            else:
+                raise FastLabelException(error, r.status_code)
+
+    def upload_predictions(self, project_id: str, analysis_type: AnalysisType, threshold: int, predictions: list) -> None:
+        endpoint = "predictions/upload"
+        payload = {
+            "projectId": project_id,
+            "analysisType": analysis_type,
+            "threshold": threshold,
+            "predictions": predictions
+        }
+        self._postrequest(endpoint, payload=payload)
+        logging.info("")
+
+
+class FastLabelException(Exception):
+    def __init__(self, message, errcode):
+        super(FastLabelException, self).__init__(
+            '<Response [{}]> {}'.format(errcode, message))
+        self.code = errcode
+
+
+class FastLabelInvalidException(FastLabelException, ValueError):
+    pass

fastlabel/const.py

@@ -0,0 +1,3 @@
+class AnalysisType(object):
+    bbox = "bbox"
+    line = "line"

pypi_update_guide.md

@@ -0,0 +1,53 @@
+# PyPI Update Guide
+
+_Creating and deploying a new package version is easy_
+
+## Prerequisites
+
+1. Ensure you're on the latest master
+
+2. Ensure you have a PyPI account created and are added as a Collaborator
+
+## Deployment Steps:
+
+**Step 0: Critical - Bump Project Version**
+
+In `setup.py`, you need to specify a new project version.
+
+We use [semantic versioning](https://packaging.python.org/guides/distributing-packages-using-setuptools/#semantic-versioning-preferred). If you are adding a meaningful feature, bump the minor version. If you are fixing a bug, bump the incremental version.
+
+**Step 1: Remove Previous Versions**
+
+Clear out any previously packaged files in the `dist` folder
+
+**Step 2: Create a Source Distribution**
+
+```
+python3 setup.py sdist
+```
+
+**Step 3: Create `wheel`**
+
+You should also create a wheel for your project. A wheel is a built package that can be installed without needing to go through the “build” process. Installing wheels is substantially faster for the end user than installing from a source distribution
+
+```
+python3 setup.py bdist_wheel
+```
+
+**Step 4: Install Twine**
+
+Twine is what is used to manage PyPI pacakges
+
+```
+pip install twine
+```
+
+**Step 5: Upload distribution to PyPI**
+
+```
+python3 -m twine upload dist/*
+```
+
+**Step 6: Check out the PyPI page to ensure all looks good**
+
+[https://pypi.org/project/fastlabel/](https://pypi.org/project/fastlabel/)

requirements.txt

@@ -0,0 +1 @@
+requests==2.25.1

setup.py

@@ -0,0 +1,20 @@
+import setuptools
+
+with open("README.md", "r", encoding="utf-8") as file:
+    long_description = file.read()
+
+with open('requirements.txt', encoding="utf-8") as file:
+    install_requires = file.read()
+
+setuptools.setup(
+    name="fastlabel",
+    version="0.1.0",
+    author="eisuke-ueta",
+    author_email="eisuke.ueta@fastlabel.ai",
+    description="The official Python SDK for FastLabel API, the Data Platform for AI",
+    long_description=long_description,
+    long_description_content_type="text/markdown",
+    packages=setuptools.find_packages(),
+    install_requires=install_requires,
+    python_requires='>=3.8',
+    include_package_data=True)