Skip to content

Commit e071a2b

Browse files
committed
formatting README
1 parent 5b8de95 commit e071a2b

1 file changed

Lines changed: 15 additions & 25 deletions

File tree

README.md

Lines changed: 15 additions & 25 deletions
Original file line numberDiff line numberDiff line change
@@ -33,12 +33,11 @@ Alternatively you can directly use `Client` and `PushShiftAPI` classes to implem
3333

3434
Check the `examples` folder to learn more.
3535

36-
---
3736
## Documentation
3837

3938
<a href="..\gatered\func.py#L12"><img align="right" style="float:right;" src="https://img.shields.io/badge/-source-cccccc?style=flat-square"></a>
4039

41-
## <kbd>function</kbd> `get_post_comments`
40+
### <kbd>function</kbd> `get_post_comments`
4241

4342
```python
4443
get_post_comments(
@@ -52,19 +51,18 @@ Helper function to get submission and its comments. If `all_comments` is `True`,
5251

5352
Returns `post` (submission) and its `comments` as list.
5453

55-
Parameters
56-
----------
54+
#### Parameters
55+
5756
submission_id: :class:`str`
5857
The Submission id (starts with `t3_`).
5958

6059
all_comments: Optional[:class:`bool`]
6160
Set this to `True` to also get all nested comments. Default to `False`.
6261

63-
---
6462

6563
<a href="..\gatered\func.py#L34"><img align="right" style="float:right;" src="https://img.shields.io/badge/-source-cccccc?style=flat-square"></a>
6664

67-
## <kbd>function</kbd> `get_posts`
65+
### <kbd>function</kbd> `get_posts`
6866

6967
```python
7068
get_posts(
@@ -81,8 +79,8 @@ Async Generator to get submissions page by page.
8179

8280
Returns an async generator. Use async for loop to handle page results.
8381

84-
Parameters
85-
----------
82+
#### Parameters
83+
8684
subreddit_name: :class:`str`
8785
Name of the subreddit.
8886

@@ -100,11 +98,10 @@ Set a request limit for pages to fetch. Disable this limit by passing `None`. D
10098
req_delay: Optional[:class:`int`]
10199
Set delay between each page request. Set 0 to disable it. Default to 0.5.
102100

103-
---
104101

105102
<a href="..\gatered\func.py#L93"><img align="right" style="float:right;" src="https://img.shields.io/badge/-source-cccccc?style=flat-square"></a>
106103

107-
## <kbd>function</kbd> `get_pushshift_posts`
104+
### <kbd>function</kbd> `get_pushshift_posts`
108105

109106
```python
110107
get_pushshift_posts(
@@ -120,8 +117,8 @@ Async Generator to get submissions by time range.
120117

121118
Returns an async generator. Use async for loop to handle page results.
122119

123-
Parameters
124-
----------
120+
#### Parameters
121+
125122
subreddit_name: :class:`str`
126123
Name of the subreddit.
127124

@@ -150,8 +147,6 @@ Httpx options can be passed in when creating the client such as proxies: https:/
150147
__init__(**options: Any)
151148
```
152149

153-
---
154-
155150
<a href="..\gatered\client.py#L220"><img align="right" style="float:right;" src="https://img.shields.io/badge/-source-cccccc?style=flat-square"></a>
156151

157152
### <kbd>method</kbd> `get_post_comments`
@@ -171,8 +166,8 @@ Get submission and its comments. If `all_comments` is `True`, it will fetch all
171166

172167
Returns `post` (submission) and its `comments` as list.
173168

174-
Parameters
175-
----------
169+
#### Parameters
170+
176171
submission_id: :class:`str`
177172
The Submission id (starts with `t3_`).
178173

@@ -189,9 +184,6 @@ max_per_second: Optional[:class:`int`]
189184
Limits the number of requests spawned per second. Default to 4.
190185

191186

192-
193-
---
194-
195187
<a href="..\gatered\client.py#L285"><img align="right" style="float:right;" src="https://img.shields.io/badge/-source-cccccc?style=flat-square"></a>
196188

197189
### <kbd>method</kbd> `get_posts`
@@ -211,8 +203,8 @@ Get submissions list from a subreddit, with ads filtered. This provides flexibil
211203

212204
Returns `subreddit` and its `posts` (submissions) as list, as well as `token` and `dist` for paginations.
213205

214-
Parameters
215-
----------
206+
#### Parameters
207+
216208
subreddit_name: :class:`str`
217209
The Subreddit name.
218210

@@ -242,8 +234,6 @@ This acts as a helper to fetch past submissions based on time range (which is no
242234
__init__(**options: Any)
243235
```
244236

245-
---
246-
247237
<a href="..\gatered\pushshift.py#L83"><img align="right" style="float:right;" src="https://img.shields.io/badge/-source-cccccc?style=flat-square"></a>
248238

249239
### <kbd>method</kbd> `get_posts`
@@ -263,8 +253,8 @@ Get submissions list from a subreddit.
263253

264254
Returns a list of submissions.
265255

266-
Parameters
267-
----------
256+
#### Parameters
257+
268258
subreddit_name: :class:`str`
269259
The Subreddit name.
270260

0 commit comments

Comments
 (0)