Upgrading to v2 from v1

[thehappydinoa]

High Impact Changes

• censys is now a namespace packages. This requires some imports to change. The censys package cannot be directly imported, you must specify a subpackage.

# Search 
from censys.search import SearchClient, CensysCertificates, CensysData, CensysIPv4, CensysWebsites, CensysHosts
# ASM
from censys.asm import AsmClient

Medium Impact Changes

• Added CensysHosts to interact with the new API described here.
• CensysHosts's search method returns a query object that is both callable and iterable. Examples can be found here.

General Changes

• There is now a single client object for all search indexes. Examples can be found here.

# Instead of importing each index
from censys.search import CensysCertificates, CensysData, CensysIPv4, CensysWebsites, CensysHosts

# You can use the client object to access all of them
from censys.search import SearchClient
c = SearchClient()

# Access each individual index 
certs = c.v1.certificates # CensysCertificates()
data = c.v1.data # CensysData()
ipv4 = c.v1.ipv4 # CensysIPv4()
websites = c.v1.websites # CensysWebsites()
hosts = c.v2.hosts # CensysHosts()

Miscellaneous

You can easily view the changes with the GitHub comparison tool and choose which updates are important to you.