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.2.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | b6322393674b432a9e470a41dc205ca62ecfefef7aa001e151764bd4e1442b01 |
|
MD5 | 1374dc395718ee2b5f061d45ab9f5723 |
|
BLAKE2b-256 | 404288ef7bc452201fe23699080e427e8f1a12223b1b14c5c60a46ee915e4654 |
Hashes for fiftyone_devicedetection_cloud-4.3.2-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 330e51091f2825986b0e0ca7f17c1fddca4c6e194d2f850814468f2c3a0f5822 |
|
MD5 | d660c22961abeb45c974c8548d876bb8 |
|
BLAKE2b-256 | 1e35a2a80da5ee0dfb1707dd07522a4fc4a31474727b6b208e9160fad511f8ff |