hyprtask 0.1.0

A simple CLI tool for Google Tasks
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

# Publishing to crates.io

## Steps to Publish

### 1. Complete Cargo.toml Metadata

Update these fields in `Cargo.toml`:
- `authors` - Your name and email
- `repository` - Your GitHub repo URL
- `homepage` - Your project homepage

### 2. Get crates.io API Token

1. Visit https://crates.io/
2. Login with GitHub
3. Go to Account Settings → API Tokens
4. Generate a new token
5. Copy the token

### 3. Login to cargo

```bash
cargo login <your-api-token>
```

This saves the token to `~/.cargo/credentials`

### 4. Verify Package

Check everything is correct:

```bash
cargo package --list
```

This shows what files will be included in the package.

### 5. Publish!

```bash
cargo publish
```

### 6. Install and Test

After publishing (takes a few minutes to index):

```bash
cargo install hyprtask
```

Then anyone can install it with:

```bash
cargo install hyprtask
```

## Important Notes

⚠️ **Package names are permanent** - You cannot delete or change a package name once published

⚠️ **Versions are immutable** - You cannot modify a published version (but can yank it)

⚠️ **Include necessary files** - Make sure `README.md` and `LICENSE` are included

## Version Updates

To publish a new version:

1. Update version in `Cargo.toml`
2. Commit changes
3. Run `cargo publish` again

## Before Publishing Checklist

- [ ] Fill in all Cargo.toml metadata
- [ ] Add LICENSE file
- [ ] Update README.md
- [ ] Test build: `cargo build --release`
- [ ] Test package: `cargo package`
- [ ] Commit all changes to git
- [ ] Create git tag: `git tag v0.1.0`
- [ ] Push to GitHub: `git push && git push --tags`
- [ ] Run `cargo publish`

## After Publishing

Users can install with:

```bash
cargo install hyprtask
```

And the binary will be at `~/.cargo/bin/hyprtask`

## Useful Commands

```bash
# Check package content
cargo package --list

# Build without publishing (dry run)
cargo publish --dry-run

# Yank a version (doesn't delete, just prevents new installs)
cargo yank --vers 0.1.0

# Un-yank a version
cargo yank --vers 0.1.0 --undo
```

## Resources

- [Cargo Book - Publishing](https://doc.rust-lang.org/cargo/reference/publishing.html)
- [crates.io Policies](https://crates.io/policies)
- [crates.io](https://crates.io/)