fiftyone-ipintelligence 4.5.0__tar.gz

fiftyone_ipintelligence-4.5.0/MANIFEST.in

@@ -0,0 +1,2 @@
+include version.txt
+include readme.md

fiftyone_ipintelligence-4.5.0/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: fiftyone_ipintelligence
+Version: 4.5.0
+Summary: 51Degrees IP Intelligence resolves an IP address to detailed location, network and registration information. This package aggregates the cloud and on-premise IP intelligence engines for the 51Degrees Pipeline API.
+Home-page: https://51degrees.com/?utm_source=pypi&utm_medium=package&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-setup.py&utm_term=url
+Author: 51Degrees Engineering
+Author-email: engineering@51degrees.com
+License: EUPL-1.2
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: License :: OSI Approved :: European Union Public Licence 1.2 (EUPL 1.2)
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fiftyone_ipintelligence_shared
+Requires-Dist: fiftyone_ipintelligence_cloud
+Requires-Dist: fiftyone_ipintelligence_onpremise
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 51Degrees IP Intelligence Engines
+
+![51Degrees](https://51degrees.com/img/logo.png?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-readme.md&utm_term=51degrees-ip-intelligence-engines "Data rewards the curious") **Python IP Intelligence**
+
+[Developer Documentation](https://51degrees.com/ip-intelligence-python/index.html?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-readme.md&utm_term=51degrees-ip-intelligence-engines "developer documentation")
+
+## Introduction
+
+This package aggregates the cloud and on-premise 51Degrees IP intelligence
+engines for the [51Degrees Pipeline API](https://51degrees.com/documentation/index.html?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-readme.md&utm_term=introduction)
+and provides the `IpIntelligencePipelineBuilder` which builds a pipeline with
+either engine depending on the settings provided:
+
+- Provide a `resource_key` to use the cloud engine.
+- Provide a `data_file_path` pointing at a `.ipi` data file to use the
+  on-premise engine.
+
+## Usage
+
+```python
+from fiftyone_ipintelligence.ipintelligence_pipelinebuilder import IpIntelligencePipelineBuilder
+
+# Cloud
+pipeline = IpIntelligencePipelineBuilder(resource_key="YOUR_RESOURCE_KEY").build()
+
+# On-premise
+pipeline = IpIntelligencePipelineBuilder(
+    data_file_path="51Degrees-LiteIpiV41.ipi",
+    licence_keys="",
+    usage_sharing=False).build()
+
+flowdata = pipeline.create_flowdata()
+flowdata.evidence.add("query.client-ip", "185.28.167.78")
+flowdata.process()
+print(flowdata.ip.registeredname.value())
+```

fiftyone_ipintelligence-4.5.0/pyproject.toml

@@ -0,0 +1,3 @@
+[build-system]
+requires = ["setuptools>=42", "wheel"]
+build-backend = "setuptools.build_meta"

fiftyone_ipintelligence-4.5.0/readme.md

@@ -0,0 +1,36 @@
+# 51Degrees IP Intelligence Engines
+
+![51Degrees](https://51degrees.com/img/logo.png?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-readme.md&utm_term=51degrees-ip-intelligence-engines "Data rewards the curious") **Python IP Intelligence**
+
+[Developer Documentation](https://51degrees.com/ip-intelligence-python/index.html?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-readme.md&utm_term=51degrees-ip-intelligence-engines "developer documentation")
+
+## Introduction
+
+This package aggregates the cloud and on-premise 51Degrees IP intelligence
+engines for the [51Degrees Pipeline API](https://51degrees.com/documentation/index.html?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-readme.md&utm_term=introduction)
+and provides the `IpIntelligencePipelineBuilder` which builds a pipeline with
+either engine depending on the settings provided:
+
+- Provide a `resource_key` to use the cloud engine.
+- Provide a `data_file_path` pointing at a `.ipi` data file to use the
+  on-premise engine.
+
+## Usage
+
+```python
+from fiftyone_ipintelligence.ipintelligence_pipelinebuilder import IpIntelligencePipelineBuilder
+
+# Cloud
+pipeline = IpIntelligencePipelineBuilder(resource_key="YOUR_RESOURCE_KEY").build()
+
+# On-premise
+pipeline = IpIntelligencePipelineBuilder(
+    data_file_path="51Degrees-LiteIpiV41.ipi",
+    licence_keys="",
+    usage_sharing=False).build()
+
+flowdata = pipeline.create_flowdata()
+flowdata.evidence.add("query.client-ip", "185.28.167.78")
+flowdata.process()
+print(flowdata.ip.registeredname.value())
+```

fiftyone_ipintelligence-4.5.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

fiftyone_ipintelligence-4.5.0/setup.py

@@ -0,0 +1,70 @@
+# *********************************************************************
+# This Original Work is copyright of 51 Degrees Mobile Experts Limited.
+# Copyright 2026 51 Degrees Mobile Experts Limited, Davidson House,
+# Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
+#
+# This Original Work is licensed under the European Union Public Licence
+# (EUPL) v.1.2 and is subject to its terms as set out below.
+#
+# If a copy of the EUPL was not distributed with this file, You can obtain
+# one at https://opensource.org/licenses/EUPL-1.2.
+#
+# The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
+# amended by the European Commission) shall be deemed incompatible for
+# the purposes of the Work and the provisions of the compatibility
+# clause in Article 5 of the EUPL shall not apply.
+#
+# If using the Work as, or as part of, a network application, by
+# including the attribution notice(s) required under Article 5 of the EUPL
+# in the end user terms of the application under an appropriate heading,
+# such notice(s) shall fulfill the requirements of that article.
+# *********************************************************************
+
+import setuptools
+import io
+import os
+
+def read(file_name):
+
+    """Read a text file and return the content as a string."""
+    try:
+        with io.open(
+            os.path.join(os.path.dirname(__file__), file_name), encoding="utf-8"
+        ) as f:
+            return f.read().strip()
+    except:
+        return "0.0.0"
+
+setuptools.setup(
+    name="fiftyone_ipintelligence",
+    version=read("version.txt"),
+    author="51Degrees Engineering",
+	author_email="engineering@51degrees.com",
+    url="https://51degrees.com/?utm_source=pypi&utm_medium=package&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-setup.py&utm_term=url",
+    description=("51Degrees IP Intelligence resolves an IP address to detailed location, network and registration information. This package aggregates the cloud and on-premise IP intelligence engines for the 51Degrees Pipeline API."),
+    long_description=read("readme.md"),
+    long_description_content_type='text/markdown',
+    python_requires=">=3.10",
+    packages=["fiftyone_ipintelligence"],
+    package_dir={"": "src"},
+    install_requires=[
+        "fiftyone_ipintelligence_shared",
+        "fiftyone_ipintelligence_cloud",
+        "fiftyone_ipintelligence_onpremise"
+    ],
+    license="EUPL-1.2",
+    classifiers=[
+        "Development Status :: 5 - Production/Stable",
+        "Programming Language :: Python",
+        "Programming Language :: Python :: 3 :: Only",
+        "Programming Language :: Python :: 3.10",
+        "Programming Language :: Python :: 3.11",
+        "Programming Language :: Python :: 3.12",
+        "Programming Language :: Python :: 3.13",
+        "Programming Language :: Python :: 3.14",
+        "License :: OSI Approved :: European Union Public Licence 1.2 (EUPL 1.2)",
+        "Operating System :: OS Independent",
+        "Topic :: Software Development :: Libraries :: Python Modules"
+    ],
+    include_package_data=True
+)

fiftyone_ipintelligence-4.5.0/src/fiftyone_ipintelligence/ipintelligence_pipelinebuilder.py

@@ -0,0 +1,134 @@
+# *********************************************************************
+# This Original Work is copyright of 51 Degrees Mobile Experts Limited.
+# Copyright 2026 51 Degrees Mobile Experts Limited, Davidson House,
+# Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
+#
+# This Original Work is licensed under the European Union Public Licence
+# (EUPL) v.1.2 and is subject to its terms as set out below.
+#
+# If a copy of the EUPL was not distributed with this file, You can obtain
+# one at https://opensource.org/licenses/EUPL-1.2.
+#
+# The 'Compatible Licences' set out in the Appendix to the EUPL (as may be
+# amended by the European Commission) shall be deemed incompatible for
+# the purposes of the Work and the provisions of the compatibility
+# clause in Article 5 of the EUPL shall not apply.
+#
+# If using the Work as, or as part of, a network application, by
+# including the attribution notice(s) required under Article 5 of the EUPL
+# in the end user terms of the application under an appropriate heading,
+# such notice(s) shall fulfill the requirements of that article.
+# *********************************************************************
+
+from fiftyone_pipeline_core.pipelinebuilder import PipelineBuilder
+from fiftyone_pipeline_cloudrequestengine.cloudrequestengine import CloudRequestEngine
+from fiftyone_ipintelligence_cloud.ipintelligence_cloud import IpIntelligenceCloud
+from fiftyone_ipintelligence_onpremise.ipintelligence_onpremise import IpIntelligenceOnPremise
+from fiftyone_ipintelligence_shared.utils import merge_two_dicts
+
+from fiftyone_pipeline_engines_fiftyone.share_usage import ShareUsage
+
+class IpIntelligencePipelineBuilder(PipelineBuilder):
+    """!
+    The IP Intelligence Pipeline Builder allows you to easily
+    construct a pipeline containing either the cloud or on-premise
+    IP intelligence engine depending on the parameters supplied.
+    """
+    def __init__(self, settings = None, usage_sharing = True, **kwargs):
+
+        """!
+
+        Constructor for the IP Intelligence Pipeline Builder.
+        Depending on parameters passed through, builds a pipeline
+        with either the cloud or on premise IP intelligence engines
+
+        General pipeline settings:
+
+        @type javascript_builder_settings: dict
+        @param javascript_builder_settings: parameters for the pipeline's JavaScript builder to populate additional evidence from the clientside.
+            - obj_name: the name of the client side object
+            with the JavaScript properties in it ('fod' by default)
+            - protocol: The protocol ("http" or "https") used by
+            the client side callback url. This can be overridden
+            with header.protocol evidence
+            - host The host of the client side callback url.
+            This can be overridden with header.host evidence.
+            - endpoint The endpoint of the client side callback url
+            * enable_cookies - whether cookies should be enabled
+            * minify: Whether to minify the JavaScript
+        @type cache: Cache
+        @param cache: An instance of the fiftyone.pipeline.engines.cache, for the cloud engine only. The on-premise engine raises an exception if one is supplied
+        class
+
+        Cloud Engine Settings:
+
+        @type resource_key: string
+        @param resource_key: the 51Degrees cloud resource key
+        @type cloud_request_origin: string
+        @param cloud_request_origin: the value to use for the Origin header when making requests to the cloud service
+
+        On Premise Engine Settings:
+
+        @type usage_sharing : bool
+        @param usage_sharing : Whether to enable usage sharing if using the on premise engine
+        @type data_file_path: string
+        @param data_file_path: path to the data file (.ipi)
+        @type auto_update: bool
+        @param auto_update: whether to automatically update the datafile when required
+        @type restricted_properties: list
+        @param restricted_properties: List of property keys to limit the engine to
+        @type licence_keys: string
+        @param licence_keys: licencekeys to use for the data file update service
+        @type download: bool
+        @param download: whether to download the datafile or keep it in memory when it is returned from the datafile update service
+        @type performance_profile: string
+        @param performance_profile: options are: LowMemory, MaxPerformance, Balanced, BalancedTemp, HighPerformance
+        @type reuse_temp_file: bool
+        @param reuse_temp_file: Indicates that an existing temp file may be used. This should be selected if multiple instances wish to use the same file to prevent high disk usage.
+        @type concurrency: int
+        @param concurrency: defaults to the number of cpus in the machine
+        @type update_on_start : bool
+        @param update_on_start : When this is set to true the datafile is updated / downloaded immediately on initialisation. This is useful if no initial datafile is present.
+        @type file_system_watcher: bool
+        @param file_system_watcher: whether to check the datafile's path for changes and update the connected FlowElement's data
+        @type polling_interval: int
+        @param polling_interval: How often to poll for updates to the datafile (minutes)
+        @type update_time_maximum_randomisation : int
+        @param update_time_maximum_randomisation :
+        Maximum randomisation offset in seconds to polling time interval
+        @type create_temp_data_copy: bool
+        @param create_temp_data_copy: whether to copy datafile to temporary location when updating
+        @type data_update_url: string
+        @param data_update_url: base url for the datafile update service
+
+        """
+        if settings is None:
+            settings = {}
+
+        settings = merge_two_dicts(dict(**kwargs), locals())
+
+        settings = merge_two_dicts(settings, settings["settings"])
+
+        del settings["self"]
+
+        super(IpIntelligencePipelineBuilder, self).__init__(settings)
+
+        # Add specific engines
+
+        if "data_file_path" in settings:
+            del settings["settings"]
+            ip_engine = IpIntelligenceOnPremise(**settings)
+
+            # If usage sharing enabled, add usage sharing engine
+
+            if usage_sharing:
+                self.add(ShareUsage())
+
+        else :
+            self.add(CloudRequestEngine(settings))
+            ip_engine = IpIntelligenceCloud()
+
+        if "cache" in settings:
+            ip_engine.set_cache(settings["cache"])
+
+        self.add(ip_engine)

fiftyone_ipintelligence-4.5.0/src/fiftyone_ipintelligence.egg-info/PKG-INFO

@@ -0,0 +1,71 @@
+Metadata-Version: 2.4
+Name: fiftyone_ipintelligence
+Version: 4.5.0
+Summary: 51Degrees IP Intelligence resolves an IP address to detailed location, network and registration information. This package aggregates the cloud and on-premise IP intelligence engines for the 51Degrees Pipeline API.
+Home-page: https://51degrees.com/?utm_source=pypi&utm_medium=package&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-setup.py&utm_term=url
+Author: 51Degrees Engineering
+Author-email: engineering@51degrees.com
+License: EUPL-1.2
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: License :: OSI Approved :: European Union Public Licence 1.2 (EUPL 1.2)
+Classifier: Operating System :: OS Independent
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: fiftyone_ipintelligence_shared
+Requires-Dist: fiftyone_ipintelligence_cloud
+Requires-Dist: fiftyone_ipintelligence_onpremise
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+# 51Degrees IP Intelligence Engines
+
+![51Degrees](https://51degrees.com/img/logo.png?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-readme.md&utm_term=51degrees-ip-intelligence-engines "Data rewards the curious") **Python IP Intelligence**
+
+[Developer Documentation](https://51degrees.com/ip-intelligence-python/index.html?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-readme.md&utm_term=51degrees-ip-intelligence-engines "developer documentation")
+
+## Introduction
+
+This package aggregates the cloud and on-premise 51Degrees IP intelligence
+engines for the [51Degrees Pipeline API](https://51degrees.com/documentation/index.html?utm_source=github&utm_medium=readme&utm_campaign=51degrees-python&utm_content=fiftyone_ipintelligence-readme.md&utm_term=introduction)
+and provides the `IpIntelligencePipelineBuilder` which builds a pipeline with
+either engine depending on the settings provided:
+
+- Provide a `resource_key` to use the cloud engine.
+- Provide a `data_file_path` pointing at a `.ipi` data file to use the
+  on-premise engine.
+
+## Usage
+
+```python
+from fiftyone_ipintelligence.ipintelligence_pipelinebuilder import IpIntelligencePipelineBuilder
+
+# Cloud
+pipeline = IpIntelligencePipelineBuilder(resource_key="YOUR_RESOURCE_KEY").build()
+
+# On-premise
+pipeline = IpIntelligencePipelineBuilder(
+    data_file_path="51Degrees-LiteIpiV41.ipi",
+    licence_keys="",
+    usage_sharing=False).build()
+
+flowdata = pipeline.create_flowdata()
+flowdata.evidence.add("query.client-ip", "185.28.167.78")
+flowdata.process()
+print(flowdata.ip.registeredname.value())
+```

fiftyone_ipintelligence-4.5.0/src/fiftyone_ipintelligence.egg-info/SOURCES.txt

@@ -0,0 +1,12 @@
+MANIFEST.in
+pyproject.toml
+readme.md
+setup.py
+version.txt
+src/fiftyone_ipintelligence/__init__.py
+src/fiftyone_ipintelligence/ipintelligence_pipelinebuilder.py
+src/fiftyone_ipintelligence.egg-info/PKG-INFO
+src/fiftyone_ipintelligence.egg-info/SOURCES.txt
+src/fiftyone_ipintelligence.egg-info/dependency_links.txt
+src/fiftyone_ipintelligence.egg-info/requires.txt
+src/fiftyone_ipintelligence.egg-info/top_level.txt

fiftyone_ipintelligence-4.5.0/src/fiftyone_ipintelligence.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

fiftyone_ipintelligence-4.5.0/src/fiftyone_ipintelligence.egg-info/requires.txt

@@ -0,0 +1,3 @@
+fiftyone_ipintelligence_shared
+fiftyone_ipintelligence_cloud
+fiftyone_ipintelligence_onpremise

fiftyone_ipintelligence-4.5.0/src/fiftyone_ipintelligence.egg-info/top_level.txt

@@ -0,0 +1 @@
+fiftyone_ipintelligence

fiftyone_ipintelligence-4.5.0/version.txt

@@ -0,0 +1 @@
+4.5.0