import decimal import json from datetime import datetime import pytest from ocpp.exceptions import ( FormatViolationError, NotImplementedError, PropertyConstraintViolationError, ProtocolError, TypeConstraintViolationError, UnknownCallErrorCodeError, ValidationError, ) from ocpp.messages import ( Call, CallError, CallResult, MessageType, _DecimalEncoder, _validators, get_validator, unpack, validate_payload, ) from ocpp.v16.enums import Action def test_unpack_with_invalid_json(): """ Test that correct exception is raised when unpack is called with invalid JSON. """ with pytest.raises(FormatViolationError): unpack(b"\x01") def test_unpack_without_jsonified_list(): """ OCPP messages are JSONified lists. This test make sure that the correct exception is raised when input is not a JSONified list. """ with pytest.raises(ProtocolError): unpack(json.dumps("3")) def test_unpack_without_message_type_id_in_json(): """ OCPP must contain the MessageTypeID as first element of the message. This test validates if correct exception is raised when this is not the case """ with pytest.raises(ProtocolError): unpack(json.dumps([])) def test_unpack_with_invalid_message_type_id_in_json(): """ OCPP messages only have 3 valid values for MessageTypeID, that is the first element of the OCPP message. This test validates that correct exception is raised when this value is invalid. """ with pytest.raises(PropertyConstraintViolationError): unpack(json.dumps([5, 1])) def test_get_validator_with_valid_name(): """ Test if correct validator is returned and if validator is added to cache. """ schema = get_validator(MessageType.Call, "Reset", ocpp_version="1.6") assert schema == _validators["Reset_1.6"] assert schema.schema == { "$schema": "http://json-schema.org/draft-04/schema#", "title": "ResetRequest", "type": "object", "properties": { "type": { "additionalProperties": False, "type": "string", "enum": ["Hard", "Soft"], } }, "additionalProperties": False, "required": ["type"], } def test_get_validator_with_invalid_name(): """ Test if OSError is raised when schema validation file cannnot be found. """ with pytest.raises(OSError): get_validator(MessageType.Call, "non-existing", ocpp_version="1.6") def test_validate_set_charging_profile_payload(): """ " Test if payloads with floats are validated correctly. This test uses the value of 21.4, which is internally represented as 21.39999999999999857891452847979962825775146484375. You can verify this using `decimal.Decimal(21.4)` """ message = Call( unique_id="1234", action="SetChargingProfile", payload={ "connectorId": 1, "csChargingProfiles": { "chargingProfileId": 1, "stackLevel": 0, "chargingProfilePurpose": "TxProfile", "chargingProfileKind": "Relative", "chargingSchedule": { "chargingRateUnit": "A", "chargingSchedulePeriod": [{"startPeriod": 0, "limit": 21.4}], }, "transactionId": 123456789, }, }, ) validate_payload(message, ocpp_version="1.6") def test_validate_get_composite_profile_payload(): """ " Test if payloads with floats are validated correctly. This test uses the value of 15.2, which is internally represented as 15.19999999999999857891452847979962825775146484375. You can verify this using `decimal.Decimal(15.2)` """ message = CallResult( unique_id="1234", action="GetCompositeSchedule", payload={ "status": "Accepted", "connectorId": 1, "scheduleStart": "2021-06-15T14:01:32Z", "chargingSchedule": { "duration": 60, "chargingRateUnit": "A", "chargingSchedulePeriod": [{"startPeriod": 0, "limit": 15.2}], }, }, ) validate_payload(message, ocpp_version="1.6") @pytest.mark.parametrize("ocpp_version", ["1.6", "2.0"]) def test_validate_payload_with_valid_payload(ocpp_version): """ Test if validate_payload doesn't return any exceptions when it's validating a valid payload. """ message = CallResult( unique_id="1234", action="Heartbeat", payload={"currentTime": datetime.now().isoformat()}, ) validate_payload(message, ocpp_version=ocpp_version) def test_validate_payload_with_invalid_additional_properties_payload(): """ Test if validate_payload raises FormatViolationError when validation of payload with unrequested properties fails. """ message = CallResult( unique_id="1234", action="Heartbeat", payload={"invalid_key": True}, ) with pytest.raises(FormatViolationError): validate_payload(message, ocpp_version="1.6") def test_validate_payload_with_invalid_type_payload(): """ Test if validate_payload raises TypeConstraintViolationError when validation of payload with mismatched type fails. """ message = Call( unique_id="1234", action="StartTransaction", payload={ "connectorId": 1, "idTag": "okTag", "meterStart": "invalid_type", "timestamp": "2022-01-25T19:18:30.018Z", }, ) with pytest.raises(TypeConstraintViolationError): validate_payload(message, ocpp_version="1.6") def test_validate_payload_with_invalid_missing_property_payload(): """ Test if validate_payload raises ProtocolError when validation of payload with missing properties fails. """ message = Call( unique_id="1234", action="StartTransaction", payload={ "connectorId": 1, "idTag": "okTag", # meterStart is purposely missing "timestamp": "2022-01-25T19:18:30.018Z", }, ) with pytest.raises(ProtocolError): validate_payload(message, ocpp_version="1.6") def test_validate_payload_with_invalid_message_type_id(): """ Test if validate_payload raises ValidationError when it is called with a message type id other than 2, Call, or 3, CallError. """ with pytest.raises(ValidationError): validate_payload(dict(), ocpp_version="1.6") def test_validate_payload_with_non_existing_schema(): """ Test if correct exception is raised when a validation schema cannot be found. """ message = CallResult( unique_id="1234", action="MagicSpell", payload={"invalid_key": True}, ) with pytest.raises(NotImplementedError): validate_payload(message, ocpp_version="1.6") def test_call_error_representation(): call = CallError( unique_id=1, error_code="GenericError", error_description="Some message", error_details={}, ) assert ( str(call) == "" ) def test_call_representation(): call = Call(unique_id="1", action=Action.Heartbeat, payload={}) assert str(call) == "" def test_call_result_representation(): call = CallResult( unique_id="1", action=Action.Authorize, payload={"status": "Accepted"} ) assert ( str(call) == "" ) def test_creating_exception_from_call_error(): call_error = CallError( unique_id="1337", error_code="ProtocolError", error_description="Something went wrong", error_details="Some details about the error", ) assert call_error.to_exception() == ProtocolError( description="Something went wrong", details="Some details about the error" ) def test_creating_exception_from_call_error_with_unknown_error_code(): call_error = CallError( unique_id="1337", error_code="418", error_description="I'm a teapot", ) with pytest.raises(UnknownCallErrorCodeError): call_error.to_exception() def test_serializing_decimal(): assert json.dumps([decimal.Decimal(2.000001)], cls=_DecimalEncoder) == "[2.0]" def test_serializing_custom_types(): """ validate_payload() raises an exception receives an invalid OCPP message. This exception contains the Call causing the problem. The exception is turned into a CallError which in serialized to JSON. https://github.com/mobilityhouse/ocpp/issues/395 tracks a bug where serialization would fails because Call is not serializable. This test verifies that fix for that bug. """ message = Call( unique_id="1234", action="StartTransaction", payload={ "connectorId": 1, "idTag": "okTag", "meterStart": "invalid_type", "timestamp": "2022-01-25T19:18:30.018Z", }, ) try: validate_payload(message, ocpp_version="1.6") except TypeConstraintViolationError as error: # Before the fix, this call would fail with a TypError. Lack of any error # makes this test pass. _ = message.create_call_error(error).to_json() def test_validate_meter_values_hertz(): """ Tests that a unit of measure called "Hertz" is permitted in validation. This was missing from the original 1.6 spec, but was added as an errata (see the OCPP 1.6 Errata sheet, v4.0 Release, 2019-10-23, page 34). """ message = Call( unique_id="1234", action="MeterValues", payload={ "connectorId": 1, "transactionId": 123456789, "meterValue": [ { "timestamp": "2020-02-21T13:48:45.459756Z", "sampledValue": [ { "value": "50.0", "measurand": "Frequency", "unit": "Hertz", } ], } ], }, ) validate_payload(message, ocpp_version="1.6") def test_validate_set_maxlength_violation_payload(): """ Test if payloads that violate maxLength raise a TypeConstraintViolationError """ message = Call( unique_id="1234", action="StartTransaction", payload={ "idTag": "012345678901234567890", "connectorId": 1, }, ) with pytest.raises(TypeConstraintViolationError): validate_payload(message, ocpp_version="1.6")