aboutsummaryrefslogtreecommitdiffstats
path: root/rust/README.md
diff options
context:
space:
mode:
authorBryan Newbold <bnewbold@robocracy.org>2018-05-25 19:44:15 -0700
committerBryan Newbold <bnewbold@robocracy.org>2018-05-25 19:44:15 -0700
commit9b3e52e813bbd9dc9b1771ca2c63e33d93048e97 (patch)
tree24e266a67d458f4335b38737497bbb5f18152a73 /rust/README.md
parentf3523b1d900e19911bf0041ac1c75877b0bfc943 (diff)
downloadfatcat-9b3e52e813bbd9dc9b1771ca2c63e33d93048e97.tar.gz
fatcat-9b3e52e813bbd9dc9b1771ca2c63e33d93048e97.zip
update README and TODOlast-golang
Diffstat (limited to 'rust/README.md')
-rw-r--r--rust/README.md21
1 files changed, 10 insertions, 11 deletions
diff --git a/rust/README.md b/rust/README.md
index 78adfc48..e790c425 100644
--- a/rust/README.md
+++ b/rust/README.md
@@ -5,12 +5,16 @@ Rust implementation of fatcat API server (`fatcatd`).
- HTTP API
- [ ] base32 encoding of UUID identifiers
+ - [ ] inverse many-to-many helpers (files-by-release, release-by-creator)
- SQL Schema
- [x] Basic entities
- - [ ] one-to-many and many-to-many entities
- - [ ] JSON(B) "extra" metadata fields
+ - [x] one-to-many and many-to-many entities
+ - [x] JSON(B) "extra" metadata fields
+ - [ ] full rev1 schema for all entities
+ - [ ] editgroup review: comments? actions?
- Web Interface
- [ ] Migrate Python codebase
+ - [ ] Creation and editing of all entities
- Other
- [x] Basic logging
- [x] Swagger-UI
@@ -18,6 +22,7 @@ Rust implementation of fatcat API server (`fatcatd`).
- [ ] Metrics
- [ ] Authentication (eg, accounts, OAuth2, JWT)
- [ ] Authorization (aka, roles)
+ - [ ] bot vs. editor
## Development
@@ -83,17 +88,11 @@ On a bare server, as root:
### Special Tricks
-Regenerate API schemas:
+Regenerate API schemas (this will, as a side-effect, also run `cargo fmt` on
+the whole project, so don't run it with your editor open):
cargo install cargo-swagger # uses docker
- cargo swagger fatcat-openapi2.yml fatcat-api --docker-tag=v2.3.1
- sudo chown `whoami`:`whoami` -R fatcat-api
-
- # usually want to keep our changes to sub-module toml
- git checkout fatcat-api/Cargo.toml
-
- cargo fmt
- # git commit the fatcat-api directory at this point
+ ./codegen_openapi2.sh
Regenerate SQL schema: