\r\n

51Degrees Device Detection Python  4.5

Device Detection services for 51Degrees Pipeline

cloud/taclookup_console.py

TAC Lookup Console Example - Cloud This example shows the details of devices associated with a given 'Type Allocation Code' or 'TAC'. More background information on TACs can be found through various online sources such as Wikipedia: https://en.wikipedia.org/wiki/Type_Allocation_Code

You will learn:

  1. How to create a Pipeline that uses the 51Degrees cloud service for TAC lookup
  2. How to pass a TAC as evidence to the Pipeline
  3. How to retrieve device details associated with the TAC

This example is available in full on GitHub.

To run this example, you will need to create a resource key. The resource key is used as shorthand to store the particular set of properties you are interested in as well as any associated license keys that entitle you to increased request limits and/or paid-for properties.

You can create a resource key using the 51Degrees Configurator.

Required PyPi Dependencies:

1 # *********************************************************************
2 # This Original Work is copyright of 51 Degrees Mobile Experts Limited.
3 # Copyright 2025 51 Degrees Mobile Experts Limited, Davidson House,
4 # Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
5 #
6 # This Original Work is licensed under the European Union Public Licence
7 # (EUPL) v.1.2 and is subject to its terms as set out below.
8 #
9 # If a copy of the EUPL was not distributed with this file, You can obtain
10 # one at https://opensource.org/licenses/EUPL-1.2.
11 #
12 # The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
13 # amended by the European Commission) shall be deemed incompatible for
14 # the purposes of the Work and the provisions of the compatibility
15 # clause in Article 5 of the EUPL shall not apply.
16 #
17 # If using the Work as, or as part of, a network application, by
18 # including the attribution notice(s) required under Article 5 of the EUPL
19 # in the end user terms of the application under an appropriate heading,
20 # such notice(s) shall fulfill the requirements of that article.
21 # *********************************************************************
22 
23 
42 
43 import json5
44 from pathlib import Path
45 import sys
46 # pylint: disable=E0402
47 from ..example_utils import ExampleUtils
48 from fiftyone_pipeline_core.logger import Logger
49 from fiftyone_pipeline_core.pipelinebuilder import PipelineBuilder
50 from fiftyone_devicedetection_shared.constants import Constants
51 
52 class TacLookupConsole():
53  def run(self, config, logger, output):
54 
55  output("This example shows the details of devices " +
56  "associated with a given 'Type Allocation Code' or 'TAC'.")
57  output("More background information on TACs can be " +
58  "found through various online sources such as Wikipedia: " +
59  "https://en.wikipedia.org/wiki/Type_Allocation_Code")
60  output("----------------------------------------")
61 
62  # In this example, we use the PipelineBuilder and configure it from a file.
63  # For a demonstration of how to do this in code instead, see the
64  # NativeModelLookup example.
65  # For more information about builders in general see the documentation at
66  # https://51degrees.com/documentation/_concepts__configuration__builders__index.html
67 
68  # Create the pipeline using the service provider and the configured options.
69  pipeline = PipelineBuilder().add_logger(logger).build_from_configuration(config)
70 
71  # Pass a TAC into the pipeline and list the matching devices.
72  self.analyseTac(self._tac1, pipeline, output)
73  # Repeat for an alternative TAC.
74  self.analyseTac(self._tac2, pipeline, output)
75 
76  def analyseTac(self, tac, pipeline, output):
77  # Create the FlowData instance.
78  data = pipeline.create_flowdata()
79  # Add the TAC as evidence.
80  data.evidence.add(Constants.EVIDENCE_QUERY_TAC_KEY, tac)
81  # Process the supplied evidence.
82  data.process()
83  # Get result data from the flow data.
84  result = data.hardware
85  output(f"Which devices are associated with the TAC '{tac}'?")
86  # The 'hardware.profiles' object contains one or more devices.
87  # This is the same interface used for standard device detection, so we have
88  # access to all the same properties.
89  for device in result.profiles:
90  vendor = ExampleUtils.get_human_readable(device, "hardwarevendor")
91  name = ExampleUtils.get_human_readable(device, "hardwarename")
92  model = ExampleUtils.get_human_readable(device, "hardwaremodel")
93  output(f"\t{vendor} {name} ({model})")
94 
95  # Example values to use when looking up device details from TACs.
96  _tac1 = "35925406"
97  _tac2 = "86386802"
98 
99 def main(argv):
100  # Use the command line args to get the resource key if present.
101  # Otherwise, get it from the environment variable.
102  resource_key = argv[0] if len(argv) > 0 else ExampleUtils.get_resource_key()
103 
104  # Configure a logger to output to the console.
105  logger = Logger()
106 
107  # Load the configuration file
108  configFile = Path(__file__).resolve().parent.joinpath("taclookup_console.json").read_text()
109  config = json5.loads(configFile)
110 
111  # Get the resource key setting from the config file.
112  resourceKeyFromConfig = ExampleUtils.get_resource_key_from_config(config)
113  configHasKey = resourceKeyFromConfig and resourceKeyFromConfig.startswith("!!") == False
114 
115  # If no resource key is specified in the config file then override it with the key
116  # from the environment variable / command line.
117  if configHasKey == False:
118  ExampleUtils.set_resource_key_in_config(config, resource_key)
119 
120  # If we don't have a resource key then log an error.
121  if not ExampleUtils.get_resource_key_from_config(config):
122  logger.log("error",
123  "No resource key specified on the command line or in " +
124  f"the environment variable '{ExampleUtils.RESOURCE_KEY_ENV_VAR}'. " +
125  "The 51Degrees cloud service is accessed using a 'ResourceKey'. " +
126  "For more information see " +
127  "https://51degrees.com/documentation/_info__resource_keys.html. " +
128  "TAC lookup is not available as a free service. This means " +
129  "that you will first need a license key, which can be purchased " +
130  "from our pricing page: https://51degrees.com/pricing. Once this is " +
131  "done, a resource key with the properties required by this example " +
132  "can be created at https://configure.51degrees.com/QKyYH5XT. You " +
133  "can now populate the environment variable mentioned at the start " +
134  "of this message with the resource key or pass it as the first " +
135  "argument on the command line.")
136  else:
137  TacLookupConsole().run(config, logger, print)
138 
139 if __name__ == "__main__":
140  main(sys.argv[1:])

Generated by doxygen 1.8.15