Skip to main content

The 51Degrees Pipeline API is a generic web request intelligence and data processing solution with the ability to add a range of 51Degrees and/or custom plug ins (Engines). This project contains 51Degrees Device Detection engines that can be used with the Pipeline API

Project description

51Degrees Device Detection Engines - Cloud

51Degrees v4 Device Detection Python

Developer Documentation | Available Properties

Introduction

From PyPi

pip install fiftyone-devicedetection-cloud

You can confirm this is working with the following micro-example.

  • Create a resource key for free with the 51Degrees configurator. This defines the properties you want to access.
  • On the 'implement' page of the configurator, copy the resource key and replace YOUR_RESOURCE_KEY in the example below. Save this as exampledd.py
  • Run the example with python exampledd.py
  • Feel free to try different user-agents and property values.
from fiftyone_devicedetection_cloud.devicedetection_cloud_pipelinebuilder import DeviceDetectionCloudPipelineBuilder
pipeline = DeviceDetectionCloudPipelineBuilder({"resource_key": "YOUR_RESOURCE_KEY"}).build()
fd = pipeline.create_flowdata()
fd.evidence.add("header.user-agent", "Mozilla/5.0 (iPhone; CPU iPhone OS 12_2 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148")
fd.process()
print(fd.device.ismobile.value())

For more in-depth examples, check out the examples page in the documentation.

From GitHub

If you've cloned the GitHub repository, you will be able to run the examples directly:

python -m examples.cloud.gettingstarted

To run the web example navigate into examples/cloud folder:

Linux

Execute export FLASK_APP=web where web is the example file, and start your application via flask run.

Windows

Execute $env:FLASK_APP = "web" where web is the example file, and start your application via flask run.

Tests

To run the tests use:

python -m unittest discover -s tests -p test*.py -b

Cloud tests will only run with a valid 51Degrees resource key (see above) set as a resource_key operating system environment variable.

For example, use following command to set resource_key on Linux: export resource_key=MY-RESOURCE-KEY

On Microsoft Windows use: $env:resource_key = "MY-RESOURCE-KEY"

As the performance and offline processing tests take longer than the others, there is another environment variable flag to run those:

Linux: export run_performance_tests=true

Microsoft Windows: $env:run_performance_tests = "true"

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for fiftyone-devicedetection-cloud, version 4.3.3
Filename, size File type Python version Upload date Hashes
Filename, size fiftyone_devicedetection_cloud-4.3.3.tar.gz (5.7 kB) File type Source Python version None Upload date Hashes View
Filename, size fiftyone_devicedetection_cloud-4.3.3-py3-none-any.whl (8.1 kB) File type Wheel Python version py3 Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Huawei Huawei PSF Sponsor Microsoft Microsoft PSF Sponsor NVIDIA NVIDIA PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page