checkpoint: document account actions

This commit is contained in:
Dan Anglin 2024-07-01 21:09:37 +01:00
parent 64c1dbcf51
commit 91784a9d08
Signed by: dananglin
GPG key ID: 0C1D44CFBEE68638

View file

@ -29,9 +29,10 @@ Log into your GoToSocial account. You can run this multiple times to log into mu
```
enbas login --instance gts.enbas-demo.private
```
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `instance` | string| true | The instance that you wan to log into. | |
| `instance` | string | true | The instance that you wan to log into. | |
### Switch between accounts
@ -40,10 +41,11 @@ Switch between your logged in accounts.
```
enbas switch --to account --account-name vincent@gts.enbas-demo.private
```
| flag | required | description | default |
|------|----------|-------------|---------|
| `to` | true | the resource you want to switch to. in this case you want `account`. | |
| `account-name` | true | the name of the account you want to switch to | |
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `to` | string | true | The resource you want to switch to. In this case you want `account`. | |
| `account-name` | string | true | The name of the account you want to switch to. | |
### See the account that you are currently logged in as
@ -53,20 +55,136 @@ enbas whoami
## Accounts
### View your own account
Print the information of your own account.
```
enbas show --type account --my-account
```
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `type` | string | true | The resource you want to view. In this case you want `account`. | |
| `my-account` | boolean | true | Use this flag to view your own account. | |
| `show-preferences` | boolean | false | Show your posting preferences. | false |
### View an account
Print the information of a local or a remote account. If the account is unknown by your instance a `404` message
will be returned.
```
enbas show --type account --account-name @name@example.social
```
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `type` | string | true | The resource you want to view. In this case you want `account`. | |
| `account-name` | string | true | The name of the account to view. | |
| `skip-relationship` | boolean | false | Set to `true` to skip viewing your relationship to the account you are viewing. | false |
### Follow an account
Send a follow request to the account you want to follow.
```
enbas follow --type account --account-name @name@example.social
```
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `type` | string | true | The resource you want to follow. In this case you want `account`. | |
| `account-name` | string | true | The name of the account to follow. | |
| `show-reposts` | boolean | false | Show reposts from the account you want to follow. | true |
| `notify` | boolean | false | Get notifications when the account you want to follow posts a status. | false |
### Unfollow an account
Unfollow the account that you are following. If you have a pending follow request to the account
in question, unfollowing will remove the follow request.
```
enbas unfollow --type account --account-name @name@example.social
```
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `type` | string | true | The resource you want to unfollow. In this case you want `account`. | |
| `account-name` | string | true | The name of the account to unfollow. | |
### Block an account
```
enbas block --type account --account-name @name@example.social
```
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `type` | string | true | The resource you want to block. In this case you want `account`. | |
| `account-name` | string | true | The name of the account to block. | |
### Unblock an account
```
enbas unblock --type account --account-name @name@example.social
```
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `type` | string | true | The resource you want to unblock. In this case you want `account`. | |
| `account-name` | string | true | The name of the account to unblock. | |
### View blocked accounts
Print a list of accounts that you are currently blocking.
```
enbas show --type blocked
```
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `type` | string | true | The resource you want to view. In this case you want `blocked` for blocked accounts. | |
| `limit` | integer | false | The maximum number of accounts to list. | 20 |
### Mute an account
```
enbas mute --type account --account-name @name@example.social --mute-notifications --mute-duration="1h"
```
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `type` | string | true | The resource you want to mute. In this case you want `account`. | |
| `account-name` | string | true | The name of the account to mute. | |
| `mute-notifications` | boolean | false | Set to `true` to mute notifications as well as statuses. | false |
| `mute-duration` | string | false | Specify how long the account should be muted for. Set to `0s` to mute indefinitely | 0s (indefinitely) |
### Unmute an account
```
enbas unmute --type account --account-name @name@example.social
```
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `type` | string | true | The resource you want to unmute. In this case you want `account`. | |
| `account-name` | string | true | The name of the account to unmute. | |
### View muted accounts
Print a list of accounts that you have muted.
```
enbas show --type muted-accounts
```
| flag | type | required | description | default |
|------|------|----------|-------------|---------|
| `type` | string | true | The resource you want to view. In this case you want `muted-accounts`. | |
| `limit` | integer | false | The maximum number of accounts to list. | 20 |
## Statuses
### View a status