microcosm.blue
Add getCounts XRPC equivalent to REST /links/count
Simple conversion of the existing endpoint from REST to XRPC. Consequtively marked the pre-existing REST endpoint as deprecated.
In addition we now ignore rocks.test
+48
constellation/src/server/mod.rs
+48
constellation/src/server/mod.rs
···
66
66
}
67
67
}),
68
68
)
69
+
// deprecated
69
70
.route(
70
71
"/links/count",
71
72
get({
72
73
let store = store.clone();
73
74
move |accept, query| async {
74
75
spawn_blocking(|| count_links(accept, query, store))
76
+
.await
77
+
.map_err(to500)?
78
+
}
79
+
}),
80
+
)
81
+
.route(
82
+
"/xrpc/blue.microcosm.links.getBacklinksCount",
83
+
get({
84
+
let store = store.clone();
85
+
move |accept, query| async {
86
+
spawn_blocking(|| get_backlink_counts(accept, query, store))
75
87
.await
76
88
.map_err(to500)?
77
89
}
···
343
355
#[serde(skip_serializing)]
344
356
query: GetLinksCountQuery,
345
357
}
358
+
#[deprecated]
346
359
fn count_links(
347
360
accept: ExtractAccept,
348
361
query: Query<GetLinksCountQuery>,
···
361
374
}
362
375
363
376
#[derive(Clone, Deserialize)]
377
+
struct GetItemsCountQuery {
378
+
subject: String,
379
+
source: String,
380
+
}
381
+
#[derive(Template, Serialize)]
382
+
#[template(path = "get-backlinks-count.html.j2")]
383
+
struct GetItemsCountResponse {
384
+
total: u64,
385
+
#[serde(skip_serializing)]
386
+
query: GetItemsCountQuery,
387
+
}
388
+
fn get_backlink_counts(
389
+
accept: ExtractAccept,
390
+
query: axum_extra::extract::Query<GetItemsCountQuery>,
391
+
store: impl LinkReader,
392
+
) -> Result<impl IntoResponse, http::StatusCode> {
393
+
let Some((collection, path)) = query.source.split_once(':') else {
394
+
return Err(http::StatusCode::BAD_REQUEST);
395
+
};
396
+
let path = format!(".{path}");
397
+
let total = store
398
+
.get_count(&query.subject, collection, &path)
399
+
.map_err(|_| http::StatusCode::INTERNAL_SERVER_ERROR)?;
400
+
401
+
Ok(acceptable(
402
+
accept,
403
+
GetItemsCountResponse {
404
+
total,
405
+
query: (*query).clone(),
406
+
},
407
+
))
408
+
}
409
+
410
+
#[derive(Clone, Deserialize)]
364
411
struct GetDidsCountQuery {
365
412
target: String,
366
413
collection: String,
···
668
715
#[serde(skip_serializing)]
669
716
query: GetAllLinksQuery,
670
717
}
718
+
#[deprecated]
671
719
fn count_all_links(
672
720
accept: ExtractAccept,
673
721
query: Query<GetAllLinksQuery>,
+38
constellation/templates/get-backlinks-count.html.j2
+38
constellation/templates/get-backlinks-count.html.j2
···
1
+
{% extends "base.html.j2" %}
2
+
{% import "try-it-macros.html.j2" as try_it %}
3
+
4
+
{% block title %}Link Count{% endblock %}
5
+
{% block description %}Count of {{ query.source }} records linking to {{ query.subject }}{% endblock %}
6
+
7
+
{% block content %}
8
+
9
+
{% call try_it::get_backlinks_count(
10
+
query.subject,
11
+
query.source,
12
+
) %}
13
+
14
+
<h2>
15
+
Total links to <code>{{ query.subject }}</code>
16
+
{% if let Some(browseable_uri) = query.subject|to_browseable %}
17
+
<small style="font-weight: normal; font-size: 1rem"><a href="{{ browseable_uri }}">browse record</a></small>
18
+
{% endif %}
19
+
</h2>
20
+
21
+
<p><strong><code>{{ total|human_number }}</code></strong> total links from <code>{{ query.source }}</code> to <code>{{ query.subject }}</code></p>
22
+
23
+
<ul>
24
+
<li>
25
+
See direct backlinks at <code>/xrpc/blue.microcosm.links.getBacklinks</code>:
26
+
<a href="/xrpc/blue.microcosm.links.getBacklinks?subject={{ query.subject|urlencode }}&source={{ query.source|urlencode }}">
27
+
/xrpc/blue.microcosm.links.getBacklinks?subject={{ query.subject }}&source={{ query.source }}
28
+
</a>
29
+
</li>
30
+
<li>See all links to this target at <code>/links/all</code>: <a href="/links/all?target={{ query.subject|urlencode }}">/links/all?target={{ query.subject }}</a></li>
31
+
</ul>
32
+
33
+
<details>
34
+
<summary>Raw JSON response</summary>
35
+
<pre class="code">{{ self|tojson }}</pre>
36
+
</details>
37
+
38
+
{% endblock %}
+14
-1
constellation/templates/hello.html.j2
+14
-1
constellation/templates/hello.html.j2
···
121
121
{% call try_it::dids("at://did:plc:vc7f4oafdgxsihk4cry2xpze/app.bsky.feed.post/3lgwdn7vd722r", "app.bsky.feed.like", ".subject.uri") %}
122
122
123
123
124
-
<h3 class="route"><code>GET /links/count</code></h3>
124
+
<h3 class="route deprecated"><code>[deprecated] GET /links/count</code></h3>
125
125
126
126
<p>The total number of links pointing at a given target.</p>
127
127
···
137
137
<p style="margin-bottom: 0"><strong>Try it:</strong></p>
138
138
{% call try_it::links_count("did:plc:vc7f4oafdgxsihk4cry2xpze", "app.bsky.graph.block", ".subject") %}
139
139
140
+
<h3 class="route"><code>GET /xrpc/blue.microcosm.links.getBacklinksCount</code></h3>
141
+
142
+
<p>The total number of links pointing at a given target.</p>
143
+
144
+
<h4>Query parameters:</h4>
145
+
146
+
<ul>
147
+
<li><code>subject</code>: required, must url-encode. The target being linked to. Example: <code>did:plc:vc7f4oafdgxsihk4cry2xpze</code> or <code>at://did:plc:vc7f4oafdgxsihk4cry2xpze/app.bsky.feed.post/3lgwdn7vd722r</code></li>
148
+
<li><code>source</code>: required. Collection and path specification for the primary link. Example: <code>app.bsky.feed.like:subject.uri</code></li>
149
+
</ul>
150
+
151
+
<p style="margin-bottom: 0"><strong>Try it:</strong></p>
152
+
{% call try_it::get_backlinks_count("did:plc:vc7f4oafdgxsihk4cry2xpze", "app.bsky.graph.block:subject") %}
140
153
141
154
<h3 class="route"><code>GET /links/count/distinct-dids</code></h3>
142
155
+7
constellation/templates/try-it-macros.html.j2
+7
constellation/templates/try-it-macros.html.j2
···
104
104
</form>
105
105
{% endmacro %}
106
106
107
+
{% macro get_backlinks_count(subject, source) %}
108
+
<form method="get" action="/xrpc/blue.microcosm.links.getBacklinksCount">
109
+
<pre class="code"><strong>GET</strong> /xrpc/blue.microcosm.links.getBacklinksCount
110
+
?subject= <input type="text" name="subject" value="{{ subject }}" placeholder="subject" />
111
+
&source= <input type="text" name="source" value="{{ source }}" placeholder="source" /> <button type="submit">get links count</button></pre>
112
+
</form>
113
+
{% endmacro %}
107
114
108
115
{% macro links_count(target, collection, path) %}
109
116
<form method="get" action="/links/count">
+38
lexicons/blue.microcosm/links/getBacklinksCount.json
+38
lexicons/blue.microcosm/links/getBacklinksCount.json
···
1
+
{
2
+
"lexicon": 1,
3
+
"id": "blue.microcosm.links.getBacklinksCount",
4
+
"defs": {
5
+
"main": {
6
+
"type": "query",
7
+
"description": "count records that link to another record",
8
+
"parameters": {
9
+
"type": "params",
10
+
"required": ["subject", "source"],
11
+
"properties": {
12
+
"subject": {
13
+
"type": "string",
14
+
"format": "uri",
15
+
"description": "the primary target being linked to (at-uri, did, or uri)"
16
+
},
17
+
"source": {
18
+
"type": "string",
19
+
"description": "collection and path specification for the primary link"
20
+
}
21
+
}
22
+
},
23
+
"output": {
24
+
"encoding": "application/json",
25
+
"schema": {
26
+
"type": "object",
27
+
"required": ["total"],
28
+
"properties": {
29
+
"total": {
30
+
"type": "integer",
31
+
"description": "total number of matching links"
32
+
}
33
+
}
34
+
}
35
+
}
36
+
}
37
+
}
38
+
}
+1
-1
readme.md
+1
-1
readme.md
···
10
10
Tutorials, how-to guides, and client SDK libraries are all in the works for gentler on-ramps, but are not quite ready yet. But don't let that stop you! Hop in the [microcosm discord](https://discord.gg/tcDfe4PGVB), or post questions and tag [@bad-example.com](https://bsky.app/profile/bad-example.com) on Bluesky if you get stuck anywhere.
11
11
12
12
> [!tip]
13
-
> This repository's primary home is moving to tangled: [@microcosm.blue/microcosm-rs](https://tangled.org/microcosm.blue/microcosm-rs). It will continue to be mirrored on [github](https://github.com/at-microcosm/microcosm-rs) for the forseeable future, and it's fine to open issues or pulls in either place!
13
+
> This repository's primary home is moving to tangled: [@microcosm.blue/microcosm-rs](https://tangled.sh/@microcosm.blue/microcosm-rs). It will continue to be mirrored on [github](https://github.com/at-microcosm/microcosm-rs) for the forseeable future, and it's fine to open issues or pulls in either place!
14
14
15
15
16
16
🌌 [Constellation](./constellation/)
+1
-1
slingshot/api-description.md
+1
-1
slingshot/api-description.md
···
90
90
- [🎇 Spacedust](https://spacedust.microcosm.blue/), a firehose of all social interactions
91
91
92
92
> [!success]
93
-
> All microcosm projects are [open source](https://tangled.org/bad-example.com/microcosm-links). **You can help sustain Slingshot** and all of microcosm by becoming a [Github sponsor](https://github.com/sponsors/uniphil/) or a [Ko-fi supporter](https://ko-fi.com/bad_example)!
93
+
> All microcosm projects are [open source](https://tangled.sh/@bad-example.com/microcosm-links). **You can help sustain Slingshot** and all of microcosm by becoming a [Github sponsor](https://github.com/sponsors/uniphil/) or a [Ko-fi supporter](https://ko-fi.com/bad_example)!
History
8 rounds
13 comments
seoul.systems
submitted
#7
8 commits
expand
collapse
Add getCounts XRPC equivalent to REST /links/count
Simple conversion of the existing endpoint from REST to XRPC.
Consequtively marked the pre-existing REST endpoint as deprecated.
In addition we now ignore rocks.test
# Conflicts:
# constellation/src/storage/mod.rs
# lexicons/blue.microcosm/links/getManyToMany.json
Modify backlinks counting XRPC endpoint name
Now matches the existing XRPC getBacklinks endpoint naming scheme.
This should fix the white-space issue for the` try-it-macros` template as
well.
Mark /links/count REST endpoint as deprecated
Remove
.uri suffix
Reformat existing lexicons
Remove wrongly commited getManyToMany lexicon
This belongs to the xrpc_many2many branch.
Fix Git whitespace error in "hello" template
Format .prettierrc and fix Git whitespace error
expand 3 comments
happy to do merging locally as needed!
merged. thanks!
closed without merging
seoul.systems
submitted
#6
7 commits
expand
collapse
Add getCounts XRPC equivalent to REST /links/count
Simple conversion of the existing endpoint from REST to XRPC.
Consequtively marked the pre-existing REST endpoint as deprecated.
In addition we now ignore rocks.test
# Conflicts:
# constellation/src/storage/mod.rs
# lexicons/blue.microcosm/links/getManyToMany.json
Modify backlinks counting XRPC endpoint name
Now matches the existing XRPC getBacklinks endpoint naming scheme.
This should fix the white-space issue for the` try-it-macros` template as
well.
Mark /links/count REST endpoint as deprecated
Remove
.uri suffix
Reformat existing lexicons
Remove wrongly commited getManyToMany lexicon
This belongs to the xrpc_many2many branch.
Fix Git whitespace error in "hello" template
expand 0 comments
seoul.systems
submitted
#5
6 commits
expand
collapse
Add getCounts XRPC equivalent to REST /links/count
Simple conversion of the existing endpoint from REST to XRPC.
Consequtively marked the pre-existing REST endpoint as deprecated.
In addition we now ignore rocks.test
# Conflicts:
# constellation/src/storage/mod.rs
# lexicons/blue.microcosm/links/getManyToMany.json
Modify backlinks counting XRPC endpoint name
Now matches the existing XRPC getBacklinks endpoint naming scheme.
This should fix the white-space issue for the` try-it-macros` template as
well.
Mark /links/count REST endpoint as deprecated
Remove
.uri suffix
Reformat existing lexicons
Remove wrongly commited getManyToMany lexicon
This belongs to the xrpc_many2many branch.
expand 0 comments
seoul.systems
submitted
#4
3 commits
expand
collapse
Add getCounts XRPC equivalent to REST /links/count
Simple conversion of the existing endpoint from REST to XRPC.
Consequtively marked the pre-existing REST endpoint as deprecated.
In addition we now ignore rocks.test
# Conflicts:
# constellation/src/storage/mod.rs
# lexicons/blue.microcosm/links/getManyToMany.json
Modify backlinks counting XRPC endpoint name
Now matches the existing XRPC getBacklinks endpoint naming scheme.
This should fix the white-space issue for the` try-it-macros` template as
well.
Mark /links/count REST endpoint as deprecated
expand 4 comments
Tangled somehow complains about merge conflicts here, but I couldn't find any after rebasing on upstream/main again?!
very weird!
one tiny thing left: the source for blocks is app.bsky.graph.block:subject (no .uri suffix on the path) -- it's in the hello.html template.
i think some many-to-many order stuff ended up on this branch but i'm too tired for git rn.
if you don't get to it first i'm happy to fix the source and git stuff and merge when i can get to it :)
Sorry about the the m2m stuff that I didn't catch before opening the PR. I did clean this up again, and nothing belonging there should be remaining here; Addresses your above comment regarding the .uri suffix as well.
seoul.systems
submitted
#3
3 commits
expand
collapse
Add getCounts XRPC equivalent to REST /links/count
Simple conversion of the existing endpoint from REST to XRPC.
Consequtively marked the pre-existing REST endpoint as deprecated.
In addition we now ignore rocks.test
# Conflicts:
# constellation/src/storage/mod.rs
# lexicons/blue.microcosm/links/getManyToMany.json
Modify backlinks counting XRPC endpoint name
Now matches the existing XRPC getBacklinks endpoint naming scheme.
This should fix the white-space issue for the` try-it-macros` template as
well.
Mark /links/count REST endpoint as deprecated
expand 0 comments
seoul.systems
submitted
#2
1 commit
expand
collapse
Add getCounts XRPC equivalent to REST /links/count
Simple conversion of the existing endpoint from REST to XRPC.
Consequtively marked the pre-existing REST endpoint as deprecated.
In addition we now ignore rocks.test
# Conflicts:
# constellation/src/storage/mod.rs
# lexicons/blue.microcosm/links/getManyToMany.json
expand 6 comments
Had to do some rebasing and cleanup, but good to go now I think.
sweet!
(btw the local/ gitignore is there for doing local/rocks.test, but i'm fine adding it to the top-level gitignore too!)
i think links.getCounts is a little too broad -- what do you think of links.getBacklinksCount?
we also throw a deprecated warning under /links/count on the main page template, matching the one for /links.
it's weird but the whitespace in the forms in try-it-macros is significant (one of my moments of knowingly doing things the wrong way because i was bored, sorry!)
the new form for this endpoint needs little tweaking to match the others.
Ah got it. The rocks tests ended up cluttering the top-level directory so I just added them to .gitignore. I often keep a .local file in .gitignores to ignore whatever's supposed to stay in one's local copy and somehow assumed this had the same intent.
Changed the function and endpoint/method name as requested to get_backlinks_count/getBacklinksCount
The endpoint in the try-it-macro should now match the other existing ones down to how they're formatted with whitespace
seoul.systems
submitted
#1
3 commits
expand
collapse
Make metrics collection opt-in
Adds a new --collect-metrics (presence) flag to make metrics collection
opt-in. The new default is to __not__ collect any metrics, i.e. neither
spawning the monitoring thread nor starting the metrics server server
that exposes these.
Increase constellation response limits
As outlined in the description of issue #4 we increase:
- the default response limit from 16 to __100__
- the maximum from 100 to __1000_
Add getCounts XRPC equivalent to REST /links/count
Simple conversion of the existing endpoint from REST to XRPC.
Consequtively marked the pre-existing REST endpoint as deprecated.
In addition we now ignore rocks.test
# Conflicts:
# constellation/src/storage/mod.rs
# lexicons/blue.microcosm/links/getManyToMany.json
expand 0 comments
seoul.systems
submitted
#0
7 commits
expand
collapse
Make metrics collection opt-in
Adds a new --collect-metrics (presence) flag to make metrics collection
opt-in. The new default is to __not__ collect any metrics, i.e. neither
spawning the monitoring thread nor starting the metrics server server
that exposes these.
Increase constellation response limits
As outlined in the description of issue #4 we increase:
- the default response limit from 16 to __100__
- the maximum from 100 to __1000_
wip: m2m
Add tests for new get_many_to_many query handler
Fix get_m2m_empty test
Replace tuple with RecordsBySubject struct
Replace (String, Vec<RecordId>) tuples with a proper
RecordsBySubject struct throughout the many-to-many query
implementation as Lexicons per ATProto spec do not offer a tuple type.
Add lexicon definition for the getManyToMany XRPC endpoint.
Add getCounts XRPC equivalent to REST /links/count
Simple conversion of the existing endpoint from REST to XRPC.
Consequtively marked the pre-existing REST endpoint as deprecated.
In addition we now ignore rocks.test
I'm giving up on the whitespace issue...
git-diff --checkeddoesn't indicate any errors either.As far as I can tell this seems to be a confirmed Tangled issue