Skip to content

Commit c8de245

Browse files
committed
refactor
1 parent 4d28533 commit c8de245

File tree

111 files changed

+117
-12064
lines changed

Some content is hidden

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

111 files changed

+117
-12064
lines changed

.gitignore

Lines changed: 0 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,3 @@
1-
.DS_Store
2-
.venv*
3-
.vscode
4-
**/*.pyc
5-
**/dist
6-
71
# Byte-compiled / optimized / DLL files
82
__pycache__/
93
*.py[cod]

README.md

Lines changed: 113 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,21 @@
22

33
[![](https://img.shields.io/pypi/v/stitch-connect-client.svg)](https://pypi.org/pypi/stitch-connect-client/) [![License](https://img.shields.io/badge/License-BSD%203--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
44

5-
An asynchronous Python client for calling the Stitch Connect API.
5+
https://www.stitchdata.com/docs/developers/stitch-connect/api
6+
7+
This Python package is automatically generated by the [OpenAPI Generator](https://openapi-generator.tech) project:
8+
9+
- API version: 0.1
10+
- Package version: 0.1.0
11+
- Build package: org.openapitools.codegen.languages.PythonClientCodegen
612

713
Table of Contents:
814

915
- [Installation](#installation)
1016
- [Guide](#guide)
17+
- [Documentation for API Endpoints](#documentation-for-api-endpoints)
18+
- [Documentation for Models](#documentation-for-models)
19+
- [Documentation for Authorization](#documentation-for-authorization)
1120
- [Development](#development)
1221

1322
## Installation
@@ -20,7 +29,94 @@ pip install stitch-connect-client
2029

2130
## Guide
2231

23-
For documentation on how to use the client, refer to the README in the [client directory](https://github.com/NarrativeScience/stitch-connect-python/client/)
32+
```python
33+
import stitch_connect_client
34+
from stitch_connect_client.rest import ApiException
35+
36+
37+
configuration = stitch_connect_client.Configuration()
38+
# Configure Bearer authorization: bearerAuth
39+
configuration.access_token = 'YOUR_BEARER_TOKEN'
40+
41+
# Defining host is optional and default to https://api.stitchdata.com
42+
configuration.host = "https://api.stitchdata.com"
43+
# Create an instance of the API class
44+
api_instance = stitch_connect_client.DestinationsApi(stitch_connect_client.ApiClient(configuration))
45+
create_destination_body = stitch_connect_client.CreateDestinationBody() # CreateDestinationBody | Object containing type and properties of a destination
46+
47+
try:
48+
# Creates a new destination. Only a single destination is supported per Stitch client account.
49+
api_response = api_instance.create_destination(create_destination_body)
50+
print(api_response)
51+
except ApiException as e:
52+
print(f"Exception when calling DestinationsApi->create_destination: {e}")
53+
54+
```
55+
56+
## Documentation for API Endpoints
57+
58+
All URIs are relative to *https://api.stitchdata.com*
59+
60+
Class | Method | HTTP request | Description
61+
------------ | ------------- | ------------- | -------------
62+
*DestinationsApi* | [**create_destination**](docs/DestinationsApi.md#create_destination) | **POST** /v4/destinations | Creates a new destination. Only a single destination is supported per Stitch client account.
63+
*DestinationsApi* | [**delete_destination**](docs/DestinationsApi.md#delete_destination) | **DELETE** /v4/destinations/{destination_id} | Deletes an existing destination. Note: Stitch requires a destination to replicate data. Replication will be paused until a new destination is created and has a successful connection.
64+
*DestinationsApi* | [**get_destination_types**](docs/DestinationsApi.md#get_destination_types) | **GET** /v4/destination-types | Retrieves general information about the configuration required for all supported destination types.
65+
*DestinationsApi* | [**get_destinations**](docs/DestinationsApi.md#get_destinations) | **GET** /v4/destinations | Lists the destination currently in use for a Stitch account. Only a single data warehouse is supported per Stitch client account.
66+
*DestinationsApi* | [**update_destination**](docs/DestinationsApi.md#update_destination) | **PUT** /v4/destinations/{destination_id} | Updates an existing destination. Modifications to the type attribute are not supported.
67+
*SourcesApi* | [**create_source**](docs/SourcesApi.md#create_source) | **POST** /v4/sources | Creates a source object, which is the first step in setting up a new data source. After the source object is created, additional configuration steps must be completed.
68+
*SourcesApi* | [**delete_source**](docs/SourcesApi.md#delete_source) | **DELETE** /v4/sources/{source_id} | Deletes an existing data source.
69+
*SourcesApi* | [**get_last_connection_check**](docs/SourcesApi.md#get_last_connection_check) | **GET** /v4/sources/{source_id}/last-connection-check | Retrieves the last connection check for a source by the source’s unique identifier.
70+
*SourcesApi* | [**get_source**](docs/SourcesApi.md#get_source) | **GET** /v4/sources/{source_id} | Retrieves a previously created data source by its unique identifier. This endpoint can be used to retrieve an active, paused, or deleted source.
71+
*SourcesApi* | [**get_sources**](docs/SourcesApi.md#get_sources) | **GET** /v4/sources | Lists the sources for an account, including active, paused, and deleted sources.
72+
*SourcesApi* | [**start_replication**](docs/SourcesApi.md#start_replication) | **POST** /v4/sources/{source_id}/sync | Manually starts a replication job for a source using the source’s unique identifier.
73+
*SourcesApi* | [**update_source**](docs/SourcesApi.md#update_source) | **PUT** /v4/sources/{source_id} | Updates an existing data source.
74+
*StreamsApi* | [**get_stream_schema**](docs/StreamsApi.md#get_stream_schema) | **GET** /v4/sources/{source_id}/streams/{stream_id} | Retrieves the schema for a source’s stream by the source and stream’s unique identifiers.
75+
*StreamsApi* | [**get_streams**](docs/StreamsApi.md#get_streams) | **GET** /v4/sources/{source_id}/streams | Lists the available streams for a source.
76+
*StreamsApi* | [**update_stream_metadata**](docs/StreamsApi.md#update_stream_metadata) | **PUT** /v4/sources/{source_id}/streams/metadata | Updates the metadata for streams and fields. This endpoint is used to define the metadata properties returned in the Stream Schema object’s non-discoverable-metadata-keys property.
77+
78+
79+
## Documentation for Models
80+
81+
- [AzureDestinationFormProperties](docs/AzureDestinationFormProperties.md)
82+
- [ConnectionCheck](docs/ConnectionCheck.md)
83+
- [ConnectionDetails](docs/ConnectionDetails.md)
84+
- [ConnectionStep](docs/ConnectionStep.md)
85+
- [ConnectionStepProps](docs/ConnectionStepProps.md)
86+
- [ConnectionStepPropsAnyOf](docs/ConnectionStepPropsAnyOf.md)
87+
- [ConnectionStepPropsJsonSchema](docs/ConnectionStepPropsJsonSchema.md)
88+
- [CreateDestinationBody](docs/CreateDestinationBody.md)
89+
- [CreateSourceBody](docs/CreateSourceBody.md)
90+
- [Destination](docs/Destination.md)
91+
- [DestinationFormProperties](docs/DestinationFormProperties.md)
92+
- [DestinationReportCard](docs/DestinationReportCard.md)
93+
- [ErrorObject](docs/ErrorObject.md)
94+
- [ErrorObjectError](docs/ErrorObjectError.md)
95+
- [FieldLevelMetadata](docs/FieldLevelMetadata.md)
96+
- [ForcedReplicationMethod](docs/ForcedReplicationMethod.md)
97+
- [HookNotification](docs/HookNotification.md)
98+
- [HookNotificationConfig](docs/HookNotificationConfig.md)
99+
- [Metadata](docs/Metadata.md)
100+
- [MetadataObject](docs/MetadataObject.md)
101+
- [ReplicationJob](docs/ReplicationJob.md)
102+
- [S3DestinationFormProperties](docs/S3DestinationFormProperties.md)
103+
- [SalesforceSourceFormProperties](docs/SalesforceSourceFormProperties.md)
104+
- [Source](docs/Source.md)
105+
- [SourceFormProperties](docs/SourceFormProperties.md)
106+
- [SourceReportCard](docs/SourceReportCard.md)
107+
- [Stream](docs/Stream.md)
108+
- [StreamLevelMetadata](docs/StreamLevelMetadata.md)
109+
- [StreamSchema](docs/StreamSchema.md)
110+
- [UpdateSourceBody](docs/UpdateSourceBody.md)
111+
112+
113+
## Documentation for Authorization
114+
115+
116+
#### bearerAuth
117+
118+
- **Type**: Bearer authentication
119+
24120

25121
## Development
26122

@@ -36,3 +132,18 @@ To run tests:
36132
```bash
37133
tox
38134
```
135+
136+
To regenerate the client, run:
137+
138+
```bash
139+
npx openapi-generator generate \
140+
-i ~/stitch-connect-openapi/openapi.yml \
141+
-g python \
142+
-o . \
143+
--library asyncio \
144+
--package-name stitch_connect_client \
145+
--git-user-id NarrativeScience \
146+
--git-repo-id stitch-connect-python \
147+
-p packageVersion=0.1.0
148+
-t templates
149+
```

client/.openapi-generator-ignore

Lines changed: 0 additions & 25 deletions
This file was deleted.

client/.openapi-generator/VERSION

Lines changed: 0 additions & 1 deletion
This file was deleted.

client/README.md

Lines changed: 0 additions & 142 deletions
This file was deleted.

client/docs/AzureDestinationFormProperties.md

Lines changed: 0 additions & 13 deletions
This file was deleted.

client/docs/ConnectionCheck.md

Lines changed: 0 additions & 12 deletions
This file was deleted.

0 commit comments

Comments
 (0)