Announced Prefixes

class prsw.stat.announced_prefixes.AnnouncedPrefixes(RIPEstat, resource, starttime: Optional[datetime] = None, endtime: Optional[datetime] = None, min_peers_seeing=None)

This data call returns all announced prefixes for a given ASN. The results can be restricted to a specific time period.

Reference: https://stat.ripe.net/docs/data_api#announced-prefixes

Property	Description
`earliest_time`	Earliest datetime data is available for.
`latest_time`	Latest datetime data is available for.
`prefixes`	A list of all announced prefixes + the timelines when they were visible.
`query_endtime`	The datetime at which the query ended.
`query_starttime`	The datetime at which the query started.
`resource`	The resource used for the query.

import prsw

ripe = prsw.RIPEstat()
prefixes = ripe.announced_prefixes(3333)

for network in prefixes:
    # AnnouncedPrefix(
    #   prefix=IPv4Network('193.0.0.0/21'),
    #   timelines=[
    #       Timeline(
    #           starttime=datetime.datetime(2021, 3, 31, 8, 0),
    #           endtime=datetime.datetime(2021, 4, 14, 8, 0)
    #       )
    #   ]
    # )

    print(network.prefix, network.timelines)

__getitem__(index): Get a specific index of the returned anncouned prefixes.

__init__(RIPEstat, resource, starttime: Optional[datetime] = None, endtime: Optional[datetime] = None, min_peers_seeing=None)

Initialize and request Announced Prefixes.

Parameters

resource – The Autonomous System Number for which to return prefixes
starttime – The start time for the query. (defaults to two weeks before current date and time)
endtime – The start time for the query. (defaults to two weeks before current date and time)
min_peers_seeing – Minimum number of RIS peers seeing the prefix for it to be included in the results. Excludes low visibility/localized announcements. (default 10)

from datetime import datetime

start = datetime.fromisoformat("2021-01-01T12:00:00.000000")
end = datetime.now()

prefixes = ripe.announced_prefixes(
    3333,                # Autonomous System Number
    starttime=start,     # datetime
    endtime=end,         # datetime
    min_peers_seeing=20, # int
    )

__iter__()

Provide a way to iterate over announced prefixes.

import prsw

ripe = prsw.RIPEstat()
prefixes = ripe.announced_prefixes(3333)

for announced_prefix in prefixes:
    print(announced_prefix.prefix, announced_prefix.timelines)

__len__()

Get the number of prefixes in announced prefixes.

import prsw

ripe = prsw.RIPEstat()
prefixes = ripe.announced_prefixes(3333)

print(len(prefixes))

property earliest_time: Earliest datetime data is available for.

property latest_time: Latest datetime data is available for.

property prefixes

A list of all announced prefixes + the timelines when they were visible.

Returns a list of AnnouncedPrefix named tuples with the following properties:

Property	Description
`prefix`	Announced IPv4Network or IPv6Network
`timelines`	List of Timeline named tuples with properties `starttime` and `endtime`

property query_endtime: The datetime at which the query ended.

property query_starttime: The datetime at which the query started.

property resource: The resource, autonomous system number, used for the query.