open-space-toolkit-io 3.0.1__py311-none-manylinux2014_x86_64.whl

open_space_toolkit_io-3.0.1.dist-info/METADATA

@@ -0,0 +1,27 @@
+Metadata-Version: 2.1
+Name: open-space-toolkit-io
+Version: 3.0.1
+Summary: Addressing, networking, database connectors.
+Author: Open Space Collective
+Author-email: contact@open-space-collective.org
+License: Apache License 2.0
+Keywords: open-space-collective,open-space-toolkit io
+Classifier: Development Status :: 3 - Alpha
+Classifier: Programming Language :: Python :: 3
+Classifier: License :: OSI Approved :: Apache Software License
+Classifier: Operating System :: POSIX :: Linux
+Description-Content-Type: text/markdown
+Requires-Dist: open-space-toolkit-core ~=3.0.0
+
+# Open Space Toolkit ▸ I/O
+
+Addressing, networking, database connectors.
+
+[![Build and Test](https://github.com/open-space-collective/open-space-toolkit-io/actions/workflows/build-test.yml/badge.svg?branch=main)](https://github.com/open-space-collective/open-space-toolkit-io/actions/workflows/build-test.yml)
+[![Code Coverage](https://codecov.io/gh/open-space-collective/open-space-toolkit-io/branch/main/graph/badge.svg)](https://codecov.io/gh/open-space-collective/open-space-toolkit-io)
+[![Documentation](https://img.shields.io/readthedocs/pip/stable.svg)](https://open-space-collective.github.io/open-space-toolkit-io)
+[![GitHub version](https://badge.fury.io/gh/open-space-collective%2Fopen-space-toolkit-io.svg)](https://badge.fury.io/gh/open-space-collective%2Fopen-space-toolkit-io)
+[![PyPI version](https://badge.fury.io/py/open-space-toolkit-io.svg)](https://badge.fury.io/py/open-space-toolkit-io)
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+
+[GitHub](https://github.com/open-space-collective/open-space-toolkit-io)

open_space_toolkit_io-3.0.1.dist-info/RECORD

@@ -0,0 +1,18 @@
+ostk/__init__.py,sha256=epnVn2PwdQkUDZ1msqBRO5nEZIOUBIq-IfK3IlNPijE,21
+ostk/io/OpenSpaceToolkitIOPy.cpython-311-x86_64-linux-gnu.so,sha256=qsq2BB08AieMsA44eDCivUQ45P58jV1IJLkDdvCZ8E8,307168
+ostk/io/__init__.py,sha256=IpLxatW_R2ItRy031KQcbFRNczGDpWeozg9COJH9QLA,83
+ostk/io/libopen-space-toolkit-io.so.3,sha256=lhgaeJknUheoomyiYsVBnTgafRDPV6DdMYugZ2fwSOc,9337512
+ostk/io/test/__init__.py,sha256=epnVn2PwdQkUDZ1msqBRO5nEZIOUBIq-IfK3IlNPijE,21
+ostk/io/test/ip/__init__.py,sha256=epnVn2PwdQkUDZ1msqBRO5nEZIOUBIq-IfK3IlNPijE,21
+ostk/io/test/ip/tcp/__init__.py,sha256=epnVn2PwdQkUDZ1msqBRO5nEZIOUBIq-IfK3IlNPijE,21
+ostk/io/test/ip/tcp/http/__init__.py,sha256=epnVn2PwdQkUDZ1msqBRO5nEZIOUBIq-IfK3IlNPijE,21
+ostk/io/test/ip/tcp/http/test_client.py,sha256=I0nRWp3HTkr2oMEbOSZJZEYVHxn7pbAdE6kBdI29mbU,1682
+ostk/io/test/ip/tcp/http/test_request.py,sha256=-puxxwFqhzizeX8odF0gqgbRCXLk_zDCZkQuEUNJYx0,2205
+ostk/io/test/ip/tcp/http/test_response.py,sha256=GAnbvAeNHJO9odmvxmZrW-ruuCHLYI-xYMJFQAE41lw,5866
+ostk/io/test/url/__init__.py,sha256=epnVn2PwdQkUDZ1msqBRO5nEZIOUBIq-IfK3IlNPijE,21
+ostk/io/test/url/test_url.py,sha256=9mPqkSq_9Xrqtdl-dK8YWw2bkvo2zd63j03WEOU1VEs,4554
+open_space_toolkit_io-3.0.1.dist-info/METADATA,sha256=YWd0LrixO20XhKaQBSUp3y73QuJDJ9tEPJJnQWclfso,1672
+open_space_toolkit_io-3.0.1.dist-info/WHEEL,sha256=wsubv5QUqU-p5zScRwtL3gqNUtin6rSSxODAU7loirM,111
+open_space_toolkit_io-3.0.1.dist-info/top_level.txt,sha256=zOR18699uDYnafgarhL8WU_LmTZY_5NVqutv-flp_x4,5
+open_space_toolkit_io-3.0.1.dist-info/zip-safe,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
+open_space_toolkit_io-3.0.1.dist-info/RECORD,,

open_space_toolkit_io-3.0.1.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: bdist_wheel (0.43.0)
+Root-Is-Purelib: true
+Tag: py311-none-manylinux2014_x86_64
+

open_space_toolkit_io-3.0.1.dist-info/top_level.txt

@@ -0,0 +1 @@
+ostk

open_space_toolkit_io-3.0.1.dist-info/zip-safe

@@ -0,0 +1 @@
+

ostk/__init__.py

@@ -0,0 +1 @@
+# Apache License 2.0

ostk/io/__init__.py

@@ -0,0 +1,5 @@
+# Apache License 2.0
+
+from ostk.core import *
+
+from .OpenSpaceToolkitIOPy import *

ostk/io/test/__init__.py

@@ -0,0 +1 @@
+# Apache License 2.0

ostk/io/test/ip/__init__.py

@@ -0,0 +1 @@
+# Apache License 2.0

ostk/io/test/ip/tcp/__init__.py

@@ -0,0 +1 @@
+# Apache License 2.0

ostk/io/test/ip/tcp/http/__init__.py

@@ -0,0 +1 @@
+# Apache License 2.0

ostk/io/test/ip/tcp/http/test_client.py

@@ -0,0 +1,60 @@
+# Apache License 2.0
+
+import pytest
+
+import ostk.io as io
+from ostk.core.filesystem import Directory, File, Path
+
+URL = io.URL
+Request = io.ip.tcp.http.Request
+Response = io.ip.tcp.http.Response
+Client = io.ip.tcp.http.Client
+
+
+def test_http_client_get_success():
+    url = URL.parse("https://www.google.com")
+
+    response = Client.get(url)
+
+    assert response is not None
+    assert response.is_defined() is True
+    assert response.is_ok() is True
+    assert response.get_status_code() == Response.StatusCode.Ok
+
+
+def test_http_client_send_success():
+    url = URL.parse("https://www.google.com")
+
+    request = Request(Request.Method.Get, url, "")
+    response = Client.send(request)
+
+    assert response is not None
+    assert response.is_defined() is True
+    assert response.is_ok() is True
+    assert response.get_status_code() == Response.StatusCode.Ok
+
+
+def test_http_client_fetch_success():
+    url = URL.parse(
+        "https://www.google.com/images/branding/googlelogo/2x/googlelogo_color_272x92dp.png"
+    )
+    directory = Directory.path(Path.parse("/tmp"))
+
+    file_response = Client.fetch(url, directory)
+
+    assert file_response is not None
+    assert file_response.exists() is True
+
+
+# def test_http_client_list_success():
+
+# Disabling similar to the C++ test. The list takes about 1 minute to complete for some reason.
+
+# url = URL.parse("ftp://naif.jpl.nasa.gov/pub/naif/generic_kernels/")
+# file_input = File.path(Path.parse("/tmp/listing.txt"))
+# response = Client.list(url, file_input, 3)
+
+# assert response is not None
+# assert response.is_defined() is True
+# assert response.is_ok() is True
+# assert response.get_status_code() == Response.StatusCode.Ok

ostk/io/test/ip/tcp/http/test_request.py

@@ -0,0 +1,90 @@
+# Apache License 2.0
+
+import pytest
+
+import ostk.io as io
+
+URL = io.URL
+Request = io.ip.tcp.http.Request
+Method = Request.Method
+
+
+def test_http_request():
+    enum_members = Request.Method.__members__
+
+    list_keys = [
+        "Undefined",
+        "Get",
+        "Head",
+        "Post",
+        "Put",
+        "Delete",
+        "Trace",
+        "Options",
+        "Connect",
+        "Patch",
+    ]
+
+    list_values = [
+        Method.Undefined,
+        Method.Get,
+        Method.Head,
+        Method.Post,
+        Method.Put,
+        Method.Delete,
+        Method.Trace,
+        Method.Options,
+        Method.Connect,
+        Method.Patch,
+    ]
+
+    assert list(enum_members.keys()) == list_keys
+    assert list(enum_members.values()) == list_values
+
+    requests = []
+    url = URL.parse("https://www.google.com")
+
+    for request_method in list_values:
+        request = Request(request_method, url, "body")
+        assert isinstance(request, Request)
+        requests.append(request)
+
+    undef_request = requests[0]
+    get_request = requests[1]
+    post_request = requests[3]
+
+    assert undef_request.is_defined() is False
+    assert Request.undefined().is_defined() is False
+    assert get_request.is_defined()
+    assert post_request.is_defined()
+
+    converted_methods = []
+    for method_value in list_values:
+        converted_methods.append(Request.string_from_method(method_value))
+    assert converted_methods == list_keys
+
+    assert get_request.get_method() == Method.Get
+    assert post_request.get_method() == Method.Post
+
+    with pytest.raises(RuntimeError):
+        undef_request.get_method()
+
+    assert get_request.get_url() == url
+    assert post_request.get_url() == url
+
+    with pytest.raises(RuntimeError):
+        undef_request.get_url()
+
+    assert get_request.get_body() == "body"
+    assert post_request.get_body() == "body"
+
+    with pytest.raises(RuntimeError):
+        undef_request.get_body()
+
+    new_get_request = Request.get(url)
+
+    assert isinstance(new_get_request, Request)
+    assert new_get_request.is_defined()
+    assert new_get_request.get_method() == Method.Get
+    assert new_get_request.get_url() == url
+    assert new_get_request.get_body() == ""

ostk/io/test/ip/tcp/http/test_response.py

@@ -0,0 +1,198 @@
+# Apache License 2.0
+
+import pytest
+
+import ostk.io as io
+
+URL = io.URL
+Response = io.ip.tcp.http.Response
+StatusCode = Response.StatusCode
+
+
+def test_http_response():
+    enum_members = Response.StatusCode.__members__
+
+    list_keys = [
+        "Undefined",
+        "Continue",
+        "SwitchingProtocols",
+        "Processing",
+        "EarlyHints",
+        "Ok",
+        "Created",
+        "Accepted",
+        "NonAuthoritativeInformation",
+        "NoContent",
+        "ResetContent",
+        "PartialContent",
+        "MultiStatus",
+        "AlreadyReported",
+        "IMUsed",
+        "MultipleChoices",
+        "MovedPermanently",
+        "Found",
+        "SeeOther",
+        "NotModified",
+        "UseProxy",
+        "SwitchProxy",
+        "TemporaryRedirect",
+        "PermanentRedirect",
+        "BadRequest",
+        "Unauthorized",
+        "PaymentRequired",
+        "Forbidden",
+        "NotFound",
+        "MethodNotAllowed",
+        "NotAcceptable",
+        "ProxyAuthenticationRequired",
+        "RequestTimeout",
+        "Conflict",
+        "Gone",
+        "LengthRequired",
+        "PreconditionFailed",
+        "PayloadTooLarge",
+        "URITooLong",
+        "UnsupportedMediaType",
+        "RangeNotSatisfiable",
+        "ExpectationFailed",
+        "ImATeapot",
+        "MisdirectedRequest",
+        "UnprocessableEntity",
+        "Locked",
+        "FailedDependency",
+        "UpgradeRequired",
+        "PreconditionRequired",
+        "TooManyRequests",
+        "RequestHeaderFieldsTooLarge",
+        "UnavailableForLegalReasons",
+        "InternalServerError",
+        "NotImplemented",
+        "BadGateway",
+        "ServiceUnavailable",
+        "GatewayTimeout",
+        "HTTPVersionNotSupported",
+        "VariantAlsoNegotiates",
+        "InsufficientStorage",
+        "LoopDetected",
+        "NotExtended",
+        "NetworkAuthenticationRequire",
+    ]
+
+    list_values = [
+        StatusCode.Undefined,
+        StatusCode.Continue,
+        StatusCode.SwitchingProtocols,
+        StatusCode.Processing,
+        StatusCode.EarlyHints,
+        StatusCode.Ok,
+        StatusCode.Created,
+        StatusCode.Accepted,
+        StatusCode.NonAuthoritativeInformation,
+        StatusCode.NoContent,
+        StatusCode.ResetContent,
+        StatusCode.PartialContent,
+        StatusCode.MultiStatus,
+        StatusCode.AlreadyReported,
+        StatusCode.IMUsed,
+        StatusCode.MultipleChoices,
+        StatusCode.MovedPermanently,
+        StatusCode.Found,
+        StatusCode.SeeOther,
+        StatusCode.NotModified,
+        StatusCode.UseProxy,
+        StatusCode.SwitchProxy,
+        StatusCode.TemporaryRedirect,
+        StatusCode.PermanentRedirect,
+        StatusCode.BadRequest,
+        StatusCode.Unauthorized,
+        StatusCode.PaymentRequired,
+        StatusCode.Forbidden,
+        StatusCode.NotFound,
+        StatusCode.MethodNotAllowed,
+        StatusCode.NotAcceptable,
+        StatusCode.ProxyAuthenticationRequired,
+        StatusCode.RequestTimeout,
+        StatusCode.Conflict,
+        StatusCode.Gone,
+        StatusCode.LengthRequired,
+        StatusCode.PreconditionFailed,
+        StatusCode.PayloadTooLarge,
+        StatusCode.URITooLong,
+        StatusCode.UnsupportedMediaType,
+        StatusCode.RangeNotSatisfiable,
+        StatusCode.ExpectationFailed,
+        StatusCode.ImATeapot,
+        StatusCode.MisdirectedRequest,
+        StatusCode.UnprocessableEntity,
+        StatusCode.Locked,
+        StatusCode.FailedDependency,
+        StatusCode.UpgradeRequired,
+        StatusCode.PreconditionRequired,
+        StatusCode.TooManyRequests,
+        StatusCode.RequestHeaderFieldsTooLarge,
+        StatusCode.UnavailableForLegalReasons,
+        StatusCode.InternalServerError,
+        StatusCode.NotImplemented,
+        StatusCode.BadGateway,
+        StatusCode.ServiceUnavailable,
+        StatusCode.GatewayTimeout,
+        StatusCode.HTTPVersionNotSupported,
+        StatusCode.VariantAlsoNegotiates,
+        StatusCode.InsufficientStorage,
+        StatusCode.LoopDetected,
+        StatusCode.NotExtended,
+        StatusCode.NetworkAuthenticationRequire,
+    ]
+
+    assert list(enum_members.keys()) == list_keys
+    assert list(enum_members.values()) == list_values
+
+    responses = []
+    for i in range(len(list_values)):
+        statuscode = list_values[i]
+        response = Response(statuscode, f"body{i}")
+        assert isinstance(response, Response)
+        if i > 0:
+            assert response.is_defined()
+        responses.append(response)
+
+        assert Response.string_from_status_code(statuscode) == list_keys[i]
+
+    response_0 = responses[0]
+    response_2 = responses[2]
+    response_3 = responses[3]
+    response_4 = responses[4]
+    response_5 = responses[5]
+
+    assert response_0.is_defined() is False
+    assert response_2.is_defined() is True
+    assert response_3.is_defined() is True
+    assert response_4.is_defined() is True
+    assert isinstance(Response.undefined(), Response)
+    assert Response.undefined().is_defined() is False
+
+    with pytest.raises(RuntimeError):
+        response_0.get_body()
+
+    assert response_2.get_body() == "body2"
+    assert response_3.get_body() == "body3"
+    assert response_4.get_body() == "body4"
+
+    with pytest.raises(RuntimeError):
+        response_0.is_ok()
+
+    assert response_2.is_ok() is False
+    assert response_3.is_ok() is False
+    assert response_4.is_ok() is False
+
+    with pytest.raises(RuntimeError):
+        response_0.get_status_code()
+
+    assert response_2.get_status_code() == StatusCode.SwitchingProtocols
+    assert response_3.get_status_code() == StatusCode.Processing
+    assert response_4.get_status_code() == StatusCode.EarlyHints
+
+    assert response_5.is_defined() is True
+    assert response_5.is_ok() is True
+    assert response_5.get_status_code() == StatusCode.Ok
+    assert response_5.get_body() == "body5"

ostk/io/test/url/__init__.py

@@ -0,0 +1 @@
+# Apache License 2.0

ostk/io/test/url/test_url.py

@@ -0,0 +1,157 @@
+# Apache License 2.0
+
+import pytest
+
+import ostk.io as io
+
+from ostk.core.type import String
+
+URL = io.URL
+
+
+def test_url_constructors():
+    # default constructor
+    scheme = "https"
+    host = "domain.org"
+    path = "/path/to/page"
+    port = 443
+    user = "user"
+    password = "password"
+    query = URL.Query.undefined()
+    fragment = "fragment"
+    url = URL(scheme, host, path, port, user, password, query, fragment)
+    assert isinstance(url, URL)
+
+    # undefined url constructor
+    url = URL.undefined()
+    assert isinstance(url, URL)
+
+    # parsing url constructor
+    url = URL.parse("https://www.google.com")
+    assert isinstance(url, URL)
+
+
+def test_url_getter_functions():
+    scheme = "https"
+    host = "domain.org"
+    path = "/path/to/page"
+    port = 443
+    user = "user"
+    password = "password"
+    query = URL.Query.undefined()
+    fragment = "fragment"
+    url = URL(scheme, host, path, port, user, password, query, fragment)
+
+    assert url.get_scheme() == scheme
+    assert url.get_host() == host
+    assert url.get_path() == path
+    assert url.get_port() == port
+    assert url.get_user() == user
+    assert url.get_password() == password
+    assert url.get_query() == query
+    assert url.get_fragment() == fragment
+
+
+def test_url_setter_functions():
+    url = URL.parse("https://www.google.com")
+
+    url.set_scheme("http")
+    url.set_host("youtube.com")
+    url.set_path("/path/to/page")
+    url.set_port(443)
+    url.set_user("Bob")
+    url.set_password("Sponge")
+    url.set_query(URL.Query.undefined())
+    url.set_fragment("frag")
+
+    assert url.get_scheme() == "http"
+    assert url.get_host() == "youtube.com"
+    assert url.get_path() == "/path/to/page"
+    assert url.get_port() == 443
+    assert url.get_user() == "Bob"
+    assert url.get_password() == "Sponge"
+    assert url.get_query().is_defined() is False
+    assert url.get_fragment() == "frag"
+
+
+def test_url_comparators():
+    url_1 = URL.parse("https://www.google.com")
+    url_2 = URL.parse("https://www.youtube.com")
+
+    assert url_1 == url_1
+    assert url_1 != url_2
+
+
+def test_url_to_string():
+    url = URL.parse("https://www.google.com")
+
+    assert isinstance(url.to_string(), String)
+    assert url.to_string() == "https://www.google.com"
+    assert url.to_string(False) == url.to_string()
+    # assert url.to_string(True) == 'https://%20www.google.com'
+
+
+def test_url_operators():
+    url_1 = URL.parse("https://www.google.com")
+    url_2 = url_1 + "/stuff"
+
+    assert url_2.to_string() == "https://www.google.com/stuff"
+    assert isinstance(url_2, URL)
+
+
+def test_url_query():
+    parameter_1 = URL.Query.Parameter("name1", "value1")
+    parameter_2 = URL.Query.Parameter("name2", "value2")
+
+    list_parameters = [parameter_1, parameter_2, parameter_1, parameter_2]
+    tuple_parameters = (parameter_1, parameter_2)
+
+    assert parameter_1 == parameter_1
+    assert parameter_1 != parameter_2
+    assert parameter_1.is_defined()
+    assert parameter_2.is_defined()
+
+    assert parameter_1.get_name() == "name1"
+    assert parameter_1.get_value() == "value1"
+
+    assert parameter_2.get_name() == "name2"
+    assert parameter_2.get_value() == "value2"
+
+    query_1 = URL.Query(list_parameters)
+    query_2 = URL.Query(tuple_parameters)
+    query_3 = URL.Query((parameter_1,))
+
+    assert isinstance(query_1, URL.Query)
+    assert isinstance(query_2, URL.Query)
+    assert isinstance(query_3, URL.Query)
+
+    assert query_1.is_defined()
+    assert query_2.is_defined()
+    assert query_3.is_defined()
+    assert URL.Query.undefined().is_defined() is False
+
+    assert query_1.has_parameter_with_name("name1")
+    assert query_1.has_parameter_with_name("name2")
+    assert query_2.has_parameter_with_name("name1")
+    assert query_2.has_parameter_with_name("name2")
+    assert query_3.has_parameter_with_name("name1") is True
+    assert query_3.has_parameter_with_name("name2") is False
+
+    assert query_1.to_string() == "name1=value1&name2=value2&name1=value1&name2=value2"
+    assert query_2.to_string() == "name1=value1&name2=value2"
+    assert query_3.to_string() == "name1=value1"
+
+    query_3.add_parameter(parameter_2)
+    assert query_3.to_string() == "name1=value1&name2=value2"
+
+    assert query_3 == query_2
+    assert query_3 != query_1
+    assert query_2 != query_1
+
+    param_1 = query_1.get_parameter_with_name("name1")
+    param_2 = query_2.get_parameter_with_name("name2")
+
+    assert isinstance(param_1, String)
+    assert isinstance(param_2, String)
+    assert param_1 == "value1"
+    assert param_2 == "value2"