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.1.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | d205bf0dee2846095c31215f11d770724b1edcdf8a4757740e2b973ed7c302e3 |
|
MD5 | 84ac8aae3f1086072897dbf1e4421d3c |
|
BLAKE2b-256 | dbe3381d445c5b7b3c023f63a802f75a5baf9ac9bd58a75fcc967dbb827de16c |
Hashes for fiftyone_devicedetection_cloud-4.3.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 296ee1f17206939dec04e9086896fea5005ff5bc35890a98e90d5b99824923ef |
|
MD5 | 809760827b64ed67899acd4f22d4ccc1 |
|
BLAKE2b-256 | 227995b8d124db474c126b4f69ab293beb29ad5a532814c4a0c3139fb75741fe |