named value for fetching global APID

CHANGELOG.md

@@ -8,6 +8,10 @@ and this project adheres to [Semantic Versioning](http://semver.org/).
 
 ## [unreleased]
 
+## [v0.8.1]
+
+- Named value for fetching global APID
+
 ## [v0.8.0]
 
 - Update `PusServices` enumeration

spacepackets/__init__.py

@@ -1 +1 @@
-__version__ = "0.8.0"
+__version__ = "0.8.1"

spacepackets/ecss/conf.py

@@ -2,6 +2,9 @@
 from .definitions import DEFAULT_MAX_TC_DATA_SIZE
 
 
+FETCH_GLOBAL_APID = -1
+
+
 class PusVersion(enum.IntEnum):
     # ESA PSS-07-101. Not supported by this package!
     ESA_PUS = 0

spacepackets/ecss/tc.py

@@ -16,6 +16,7 @@
     PusVersion,
     get_pus_tc_version,
     get_max_tc_packet_size,
+    FETCH_GLOBAL_APID,
 )
 
 
@@ -168,7 +169,7 @@ def __init__(
         source_id: int = 0,
         pus_version: PusVersion = PusVersion.GLOBAL_CONFIG,
         ack_flags: int = 0b1111,
-        apid: int = -1,
+        apid: int = FETCH_GLOBAL_APID,
     ):
         """Initiate a PUS telecommand from the given parameters. The raw byte representation
         can then be retrieved with the :py:meth:`pack` function.

spacepackets/ecss/tm.py

@@ -11,7 +11,12 @@
     PacketTypes,
 )
 from spacepackets.ccsds.time import CdsShortTimestamp, read_p_field
-from spacepackets.ecss.conf import get_pus_tm_version, PusVersion, get_default_tm_apid
+from spacepackets.ecss.conf import (
+    get_pus_tm_version,
+    PusVersion,
+    get_default_tm_apid,
+    FETCH_GLOBAL_APID,
+)
 
 
 def get_service_from_raw_pus_packet(raw_bytearray: bytearray) -> int:
@@ -43,7 +48,7 @@ def __init__(
         time: CdsShortTimestamp = None,
         ssc: int = 0,
         source_data: bytearray = bytearray([]),
-        apid: int = -1,
+        apid: int = FETCH_GLOBAL_APID,
         message_counter: int = 0,
         space_time_ref: int = 0b0000,
         destination_id: int = 0,