Skip to content

Commit 80b878d

Browse files
Merge pull request #192 from dvonthenen/more-cd-fixes
CD Release Fixes & SetupTools
2 parents 45969eb + 6f9f446 commit 80b878d

File tree

4 files changed

+80
-85
lines changed

4 files changed

+80
-85
lines changed

README.md

Lines changed: 57 additions & 63 deletions
Original file line numberDiff line numberDiff line change
@@ -14,7 +14,7 @@ Official Python SDK for [Deepgram](https://www.deepgram.com/). Power your apps w
1414
* [Examples](#examples)
1515
* [Testing](#testing)
1616
* [Configuration](#configuration)
17-
* [Custom API Endpoint] [#custom-api-endpoint]
17+
* [Custom API Endpoint] [#custom-api-endpoint]
1818
* [Transcription](#transcription)
1919
* [Remote Files](#remote-files)
2020
* [Local Files](#local-files)
@@ -74,37 +74,37 @@ To quickly get started with examples for prerecorded and streaming, run the file
7474

7575
Run the following command to install `pytest` and `pytest-cov` as dev dependencies.
7676

77-
```
77+
```sh
7878
pip install -r requirements.txt
7979
```
8080

8181
## Run All Tests
8282

8383
## Setup
8484

85-
```
85+
```sh
8686
pip install pytest
8787
pip install pytest-cov
8888
```
8989

9090
## Run All Tests
9191

92-
```
92+
```sh
9393
pytest --api-key <key> tests/
9494
```
9595

9696
## Test Coverage Report
9797

98-
```
98+
```sh
9999
pytest --cov=deepgram --api-key <key> tests/
100100
```
101101

102102
# Configuration
103103

104104
To setup the configuration of the Deepgram Client, do the following:
105105

106-
- Import the Deepgram client
107-
- Create a Deepgram Client instance and pass in credentials to the constructor.
106+
* Import the Deepgram client
107+
* Create a Deepgram Client instance and pass in credentials to the constructor.
108108

109109
```python
110110
from deepgram import Deepgram
@@ -117,7 +117,7 @@ deepgram = Deepgram(DEEPGRAM_API_KEY)
117117

118118
In order to point the SDK at a different API environment (e.g., for on-prem deployments), you can pass in an object setting the `api_url` when initializing the Deepgram client.
119119

120-
```py
120+
```python
121121
dg_client = Deepgram({
122122
"api_key": DEEPGRAM_API_KEY,
123123
"api_url": "http://localhost:8080/v1/listen"
@@ -277,7 +277,7 @@ project = await deepgram.projects.get(PROJECT_ID)
277277

278278
### Get a Project Response
279279

280-
```
280+
```ts
281281
{
282282
project_id: String,
283283
name: String,
@@ -294,7 +294,6 @@ Updates a project based on a provided project object.
294294
| --------- | ------ | ------------------------------------------------------------------------------- |
295295
| project | Object | Object representing a project. Must contain `project_id` and `name` properties. |
296296

297-
298297
### Update a Project Example Request
299298

300299
```python
@@ -303,9 +302,9 @@ updateResponse = await deepgram.projects.update(project)
303302

304303
### Update a Project Response
305304

306-
```
305+
```ts
307306
{
308-
message: String;
307+
message: String;
309308
}
310309
```
311310

@@ -331,16 +330,16 @@ response = await deepgram.keys.list(PROJECT_ID)
331330

332331
### List Keys Response
333332

334-
```
333+
```ts
335334
{
336-
api_keys: [
337-
{
338-
api_key_id: string,
339-
comment: string,
340-
created: string,
341-
scopes: Array<string>,
342-
},
343-
];
335+
api_keys: [
336+
{
337+
api_key_id: string,
338+
comment: string,
339+
created: string,
340+
scopes: Array<string>,
341+
},
342+
];
344343
}
345344
```
346345

@@ -364,7 +363,7 @@ response = await deepgram.keys.create(PROJECT_ID, COMMENT_FOR_KEY, SCOPES)
364363

365364
### Create API Key Response
366365

367-
```
366+
```ts
368367
{
369368
api_key_id: string,
370369
key: string,
@@ -417,7 +416,7 @@ response = await deepgram.members.list_members(PROJECT_ID)
417416

418417
### Get Members Response
419418

420-
```
419+
```ts
421420
{
422421
members: [
423422
{
@@ -450,9 +449,9 @@ response = await deepgram.members.remove_member(PROJECT_ID, MEMBER_ID)
450449

451450
### Remove Member Response
452451

453-
```
452+
```ts
454453
{
455-
message: string;
454+
message: string;
456455
}
457456
```
458457

@@ -479,7 +478,7 @@ response = await deepgram.scopes.get_scope(PROJECT_ID, MEMBER_ID)
479478

480479
### Get Member Scopes Response
481480

482-
```
481+
```ts
483482
{
484483
scopes: string[]
485484
}
@@ -505,9 +504,9 @@ response = await deepgram.scopes.update_scope(PROJECT_ID, MEMBER_ID, 'member')
505504

506505
### Update Scope Response
507506

508-
```
507+
```ts
509508
{
510-
message: string;
509+
message: string;
511510
}
512511
```
513512

@@ -533,14 +532,14 @@ response = await deepgram.invitations.list_invitations(PROJECT_ID)
533532

534533
### List Invites Response
535534

536-
```
535+
```ts
537536
{
538-
members: [
539-
{
540-
email: string,
541-
scope: string,
542-
},
543-
];
537+
members: [
538+
{
539+
email: string,
540+
scope: string,
541+
},
542+
];
544543
}
545544
```
546545

@@ -566,9 +565,9 @@ response = await deepgram.invitations.send_invitation(PROJECT_ID, {
566565

567566
### Send Invite Response
568567

569-
```
568+
```ts
570569
{
571-
message: string;
570+
message: string;
572571
}
573572
```
574573

@@ -594,9 +593,9 @@ response = await deepgram.invitations.remove_invitation(
594593

595594
### Delete Invite Response
596595

597-
```
596+
```ts
598597
{
599-
message: string;
598+
message: string;
600599
}
601600
```
602601

@@ -618,9 +617,9 @@ response = await deepgram.invitations.leave_project(PROJECT_ID)
618617

619618
### Leave Project Response
620619

621-
```
620+
```ts
622621
{
623-
message: string;
622+
message: string;
624623
}
625624
```
626625

@@ -672,7 +671,7 @@ response = await deepgram.usage.list_requests(PROJECT_ID, {
672671

673672
### Get All Requests Response
674673

675-
```
674+
```ts
676675
{
677676
page: Number,
678677
limit: Number,
@@ -741,7 +740,7 @@ response = await deepgram.usage.get_request(PROJECT_ID, REQUEST_ID)
741740

742741
### Get Request Response
743742

744-
```
743+
```ts
745744
{
746745
request_id: String;
747746
created: String;
@@ -798,7 +797,7 @@ Retrieves aggregated usage data for a project based on the provided options.
798797

799798
#### Get Usage Options
800799

801-
```python
800+
```ts
802801
{
803802
// The time to retrieve requests made since
804803
// Example: "2020-01-01T00:00:00+00:00"
@@ -854,7 +853,7 @@ response = await deepgram.usage.get_usage(PROJECT_ID, {
854853

855854
### Get Usage Response
856855

857-
```
856+
```ts
858857
{
859858
start: String,
860859
end: String,
@@ -886,7 +885,7 @@ Retrieves features used by the provided project_id based on the provided options
886885

887886
#### Get Fields Options
888887

889-
```typescript
888+
```ts
890889
{
891890
// The time to retrieve requests made since
892891
// Example: "2020-01-01T00:00:00+00:00"
@@ -908,7 +907,7 @@ response = await deepgram.usage.get_fields(PROJECT_ID, {
908907

909908
#### Get Fields Response
910909

911-
```
910+
```ts
912911
{
913912
tags: String[],
914913
models: String[],
@@ -922,7 +921,6 @@ response = await deepgram.usage.get_fields(PROJECT_ID, {
922921

923922
The `deepgram.billing` object provides access to the balances endpoints of the Deepgram API. Each request is project based and will require a `project_id`.
924923

925-
926924
## Get All Balances
927925

928926
You can retrieve all balances on a given project using the `billing.list_balance` function.
@@ -941,7 +939,7 @@ response = await deepgram.billing.list_balance(PROJECT_ID)
941939

942940
### Get All Balances Response
943941

944-
```
942+
```ts
945943
{
946944
balances: [
947945
{
@@ -973,14 +971,14 @@ const response = deepgram.billing.get_balance(PROJECT_ID, BALANCE_ID)
973971

974972
### Get Balance Response
975973

976-
```
974+
```ts
977975
{
978-
balance: {
979-
balance_id: string;
980-
amount: number;
981-
units: string;
982-
purchase: string;
983-
}
976+
balance: {
977+
balance_id: string;
978+
amount: number;
979+
units: string;
980+
purchase: string;
981+
}
984982
}
985983
```
986984

@@ -997,10 +995,6 @@ To make sure our community is safe for all, be sure to review and agree to our
997995
We love to hear from you so if you have questions, comments or find a bug in the
998996
project, let us know! You can either:
999997

1000-
- [Open an issue in this repository](https://github.com/deepgram/deepgram-python-sdk/issues/new)
1001-
- [Join the Deepgram Github Discussions Community](https://github.com/orgs/deepgram/discussions)
1002-
- [Join the Deepgram Discord Community](https://discord.gg/xWRaCDBtW4)
1003-
1004-
[license]: LICENSE.txt
1005-
1006-
998+
* [Open an issue in this repository](https://github.com/deepgram/deepgram-python-sdk/issues/new)
999+
* [Join the Deepgram Github Discussions Community](https://github.com/orgs/deepgram/discussions)
1000+
* [Join the Deepgram Discord Community](https://discord.gg/xWRaCDBtW4)

deepgram/__init__.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
# SPDX-License-Identifier: MIT
44

55
# version
6-
__version__ = "3.0.0"
6+
__version__ = "0.0.0"
77

88
# entry point for the deepgram python sdk
99
from .client import DeepgramClient, DeepgramApiKeyError

pyproject.toml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,8 +4,7 @@ build-backend = "setuptools.build_meta"
44

55
[project]
66
name = "deepgram-sdk"
7-
dynamic = ["version", "readme", "license", "description", "authors", "keywords", "classifiers", "dependencies"]
7+
dynamic = ["version", "description", "readme", "license", "authors", "keywords", "classifiers", "dependencies"]
88

99
[tool.setuptools.dynamic]
1010
version = {attr = "deepgram.__version__"}
11-
readme = {file = "README.md"}

0 commit comments

Comments
 (0)