Skip to content

Commit b912f65

Browse files
Merge pull request #108 from ChuckWoodraska/ID-1500
Bump version to 1.0.0
2 parents 6e7a3f8 + 5b0e40d commit b912f65

File tree

70 files changed

+32473
-18852
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

70 files changed

+32473
-18852
lines changed

.coveragerc

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,5 @@
11
[report]
22
include = domaintools/*.py
3+
domaintools_async/*.py
34
exclude_lines = if __name__ == .__main__.:
45
pragma: no cover

CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,12 @@
11
Changelog
22
=========
33

4+
### 1.0.0
5+
- Adding support for Iris Detect API endpoints
6+
- Update underlying HTTP client
7+
- Addition of helper functions for common tasks
8+
- Documentation and example code updates
9+
410
### 0.6.2
511
- Update README with Iris trademarks
612

README.md

Lines changed: 11 additions & 35 deletions
Original file line numberDiff line numberDiff line change
@@ -6,13 +6,13 @@
66
[![Coverage Status](https://coveralls.io/repos/github/DomainTools/python_api/badge.svg?branch=main)](https://coveralls.io/github/DomainTools/python_api?branch=main)
77
[![License](https://img.shields.io/github/license/mashape/apistatus.svg)](https://pypi.python.org/pypi/domaintools_api/)
88

9-
DomainTools' Official Python API
9+
DomainTools Official Python API
1010

1111
![domaintools Example](https://github.com/DomainTools/python_api/raw/main/artwork/example.gif)
1212

13-
The DomainTools Python API Wrapper provides an interface to work with our cybersecurity and related data tools provided by our Iris Investigate™ and Iris Enrich™ products. It is actively maintained and may be downloaded via <a href="https://github.com/DomainTools/python_api">GitHub</a> or <a href="https://pypi.org/project/domaintools-api/">PyPI</a>.
13+
The DomainTools Python API Wrapper provides an interface to work with our cybersecurity and related data tools provided by our Iris Investigate™, Iris Enrich™, and Iris Detect™ products. It is actively maintained and may be downloaded via <a href="https://github.com/DomainTools/python_api">GitHub</a> or <a href="https://pypi.org/project/domaintools-api/">PyPI</a>. See the included README file, the examples folder, and API documentation (https://app.swaggerhub.com/apis-docs/DomainToolsLLC/DomainTools_APIs/1.0#) for more info.
1414

15-
Installing the DomainTools' API
15+
Installing the DomainTools API
1616
===================
1717

1818
To install the API run
@@ -50,6 +50,12 @@ You can get an overview of every endpoint that you can interact with using the b
5050
help(api)
5151
```
5252

53+
Or if you know the endpoint you want to use, you can get more information about it:
54+
55+
```python
56+
help(api.iris_investigate)
57+
```
58+
5359
If applicable, native Python looping can be used directly to loop through any results:
5460

5561
```python
@@ -71,7 +77,6 @@ profile = api.domain_profile('google.com')
7177
title = profile['website_data']['title']
7278
```
7379

74-
7580
For any API call where a single type of data is expected you can directly cast to the desired type:
7681

7782
```python
@@ -89,40 +94,11 @@ api.iris_enrich('domaintools.com').response() == { ... }
8994

9095
You can directly get the html, xml, or json version of the response by calling `.(html|xml|json)()` These only work with non AsyncResults:
9196
```python
92-
html = str(api.domain_search('google').json())
97+
json = str(api.domain_search('google').json())
9398
xml = str(api.domain_search('google').xml())
9499
html = str(api.domain_search('google').html())
95100
```
96101

97-
Besides the Iris Investigate method letting you lookup domains, it can also be used to search for domains sharing common attributes. For instance, you can pass it an IP to bring back all domains sharing that IP:
98-
99-
```python
100-
api.iris_investigate(ip='ENTER_IP_ADDRESS_HERE')
101-
```
102-
103-
Other args you can use are below:
104-
- **ip**: Search for domains having this IP.
105-
- **email**: Search for domains with this email in their data.
106-
- **email_domain**: Search for domains where the email address uses this domain.
107-
- **nameserver_host**: Search for domains with this nameserver.
108-
- **nameserver_domain**: Search for domains with a nameserver that has this domain.
109-
- **nameserver_ip**: Search for domains with a nameserver on this IP.
110-
- **registrar**: Search for domains with this registrar.
111-
- **registrant**: Search for domains with this registrant name.
112-
- **registrant_org**: Search for domains with this registrant organization.
113-
- **mailserver_host**: Search for domains with this mailserver.
114-
- **mailserver_domain**: Search for domains with a mailserver that has this domain.
115-
- **mailserver_ip**: Search for domains with a mailserver on this IP.
116-
- **redirect_domain**: Search for domains which redirect to this domain.
117-
- **ssl_hash**: Search for domains which have an SSL certificate with this hash.
118-
- **ssl_subject**: Search for domains which have an SSL certificate with this subject string.
119-
- **ssl_email**: Search for domains which have an SSL certificate with this email in it.
120-
- **ssl_org**: Search for domains which have an SSL certificate with this organization in it.
121-
- **google_analytics**: Search for domains which have this Google Analytics code.
122-
- **adsense**: Search for domains which have this AdSense code.
123-
- **tld**: Filter by TLD. Must be combined with another parameter.
124-
- **search_hash**: Use search hash from Iris to bring back domains.
125-
126102
If any API call is unsuccesfull, one of the exceptions defined in `domaintools.exceptions` will be raised:
127103

128104
```python-traceback
@@ -174,7 +150,7 @@ Using the API Asynchronously
174150

175151
![domaintools Async Example](https://github.com/DomainTools/python_api/raw/main/artwork/example_async.gif)
176152

177-
The DomainTools' API automatically supports async usage:
153+
The DomainTools API automatically supports async usage:
178154

179155
```python
180156

domaintools/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
"""DomainTools' Official Python API"""
1+
"""DomainTools Official Python API"""
22
from domaintools._version import current
33
from domaintools.api import API
44

domaintools/_version.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -19,4 +19,4 @@
1919
OTHER DEALINGS IN THE SOFTWARE.
2020
2121
"""
22-
current = "0.6.2"
22+
current = "1.0.0"

0 commit comments

Comments
 (0)