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
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for fiftyone_devicedetection_cloud-4.3.3.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | 67c21a1c335798f9891f3ddd402348c0fd5b77198314bdf11938888000c1a337 |
|
MD5 | d592d4572704001a1dedb7f47794e0b2 |
|
BLAKE2b-256 | 40f2625906c0980696491620603e1b86f84821986e8530046597c90845f33984 |
Hashes for fiftyone_devicedetection_cloud-4.3.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 73fc36c4c0d9513663018c8c03fa74ea27cf2564ef802fa0c6133e78dd6b98e2 |
|
MD5 | 6252045476777d224bd9ca0dd9c8f120 |
|
BLAKE2b-256 | 8692d14732134be3473c7e9f13df892e2e605d32e6c0f4f0e9e534e7fa43ac0a |