git.iko.soy/urbit.org
on master help sign in
changes to scry ref per @Fang- recommendations
93ab53dtinnus-napbus
arvo/eyre/examples.md+3−3
compare with master
unifiedsplit
@@ -592,7 +592,7 @@ First, using `|pass` in the dojo, let's approve the origin `http://foo.example`
592|pass [%e [%approve-origin 'http://foo.example']]
592|pass [%e [%approve-origin 'http://foo.example']]
593```
593```
594
594
595−Now if we scry for the [approved](@/docs/arvo/eyre/scry.md#x-cors-approved) CORS `set`:
595+Now if we scry for the [approved](@/docs/arvo/eyre/scry.md#cors-approved) CORS `set`:
596
596
597```
597```
598> .^(approved=(set @t) %ex /=//=/cors/approved)
598> .^(approved=(set @t) %ex /=//=/cors/approved)
@@ -630,7 +630,7 @@ Now we'll try rejecting an `origin`. Back in the dojo, let's `|pass` Eyre a `%re
630|pass [%e [%reject-origin 'http://bar.example']]
630|pass [%e [%reject-origin 'http://bar.example']]
631```
631```
632
632
633−If we scry for the [rejected](@/docs/arvo/eyre/scry.md#x-cors-rejected) CORS `set`:
633+If we scry for the [rejected](@/docs/arvo/eyre/scry.md#cors-rejected) CORS `set`:
634
634
635```
635```
636> .^(rejected=(set @t) %ex /=//=/cors/rejected)
636> .^(rejected=(set @t) %ex /=//=/cors/rejected)
@@ -679,7 +679,7 @@ Connection: close
679Server: urbit/vere-1.5
679Server: urbit/vere-1.5
680```
680```
681
681
682−Now if we scry for the [requests](@/docs/arvo/eyre/scry.md#x-cors-requests) CORS `set`:
682+Now if we scry for the [requests](@/docs/arvo/eyre/scry.md#cors-requests) CORS `set`:
683
683
684```
684```
685> .^(requests=(set @t) %ex /=//=/cors/requests)
685> .^(requests=(set @t) %ex /=//=/cors/requests)
arvo/eyre/scry.md+17−36
@@ -7,13 +7,13 @@ template = "doc.html"
7## Contents
7## Contents
8
8
9- [Introduction](#introduction)
9- [Introduction](#introduction)
10−- [/x/cors](#xcors) - CORS settings.
10+- [/cors](#cors) - CORS settings.
11− - [/x/cors/requests](#xcorsrequests) - Requested origins.
11+ - [/cors/requests](#cors-requests) - Requested origins.
12− - [/x/cors/approved](#xcorsapproved) - Approved origins.
12+ - [/cors/approved](#cors-approved) - Approved origins.
13− - [/x/cors/approved/\<origin\>](#xcorsapprovedorigin) - Check if origin approved.
13+ - [/cors/approved/\<origin\>](#cors-approved-origin) - Check if origin approved.
14− - [/x/cors/rejected](#xcorsrejected) - Rejected origins.
14+ - [/cors/rejected](#cors-rejected) - Rejected origins.
15− - [/x/cors/rejected/\<origin\>](#xcorsrejectedorigin) - Check if origin rejected.
15+ - [/cors/rejected/\<origin\>](#cors-rejected-origin) - Check if origin rejected.
16−- [/x/authenticated/cookie/\<cookie\>](#xauthenticatedcookiecookie) - Check if cookie authenticated.
16+- [/authenticated/cookie/\<cookie\>](#authenticated-cookie-cookie) - Check if cookie authenticated.
17- [bindings](#bindings) - URL path bindings.
17- [bindings](#bindings) - URL path bindings.
18- [connections](#connections) - Open http connections.
18- [connections](#connections) - Open http connections.
19- [authentication-state](#authentication-state) - Authentication details.
19- [authentication-state](#authentication-state) - Authentication details.
@@ -24,11 +24,11 @@ template = "doc.html"
24
24
25Here are all of Eyre's scry endpoints. There's not too many and they mostly deal with either CORS settings or aspects of the state of connections.
25Here are all of Eyre's scry endpoints. There's not too many and they mostly deal with either CORS settings or aspects of the state of connections.
26
26
27−The first few with a `care` of `x` are a scry like `.^(<type> %ex /=//=/<some-path>)` (note the empty `desk`). The rest have no `care` and the tag replaces the `desk` like `.^(<type> %e /=<something>=)`.
27+The first few have a `care` of `x` and are a scry like `.^(<type> %ex /=//=/<some-path>)` (note the empty `desk`). The rest have no `care` and the tag replaces the `desk` like `.^(<type> %e /=<something>=)`.
28
28
29All examples are from the dojo.
29All examples are from the dojo.
30
30
31−# `/x/cors`
31+# `/cors`
32
32
33An `x` scry with a `path` of `/cors` will return Eyre's CORS origin registry. The type returned is a [cors-registry](@/docs/arvo/eyre/data-types.md#cors-registry) which contains the `set`s of approved, rejected and requested origins.
33An `x` scry with a `path` of `/cors` will return Eyre's CORS origin registry. The type returned is a [cors-registry](@/docs/arvo/eyre/data-types.md#cors-registry) which contains the `set`s of approved, rejected and requested origins.
34
34
@@ -42,7 +42,7 @@ Example:
42]
42]
43```
43```
44
44
45−## `/x/cors/requests`
45+## `/cors/requests`
46
46
47An `x` scry with a `path` of `/cors/requests` will return the `set` of pending origin requests. These are origins that were in an `Origin: ...` HTTP header but weren't in the existing approved or rejected sets. The type returned is a `(set origin:eyre)`.
47An `x` scry with a `path` of `/cors/requests` will return the `set` of pending origin requests. These are origins that were in an `Origin: ...` HTTP header but weren't in the existing approved or rejected sets. The type returned is a `(set origin:eyre)`.
48
48
@@ -53,7 +53,7 @@ Example:
53requests={~~http~3a.~2f.~2f.baz~.example}
53requests={~~http~3a.~2f.~2f.baz~.example}
54```
54```
55
55
56−## `/x/cors/approved`
56+## `/cors/approved`
57
57
58An `x` scry with a `path` of `/cors/approved` will return the `set` of approved CORS origins. The type returned is a `(set origin:eyre)`.
58An `x` scry with a `path` of `/cors/approved` will return the `set` of approved CORS origins. The type returned is a `(set origin:eyre)`.
59
59
@@ -64,11 +64,11 @@ Example:
64approved={~~http~3a.~2f.~2f.foo~.example}
64approved={~~http~3a.~2f.~2f.foo~.example}
65```
65```
66
66
67−## `/x/cors/approved/<origin>`
67+## `/cors/approved/<origin>`
68
68
69An `x` scry whose `path` is `/cors/approved/<origin>` tests whether the given origin URL is in the `approved` set of the CORS registry. The type returned is a simple `?`.
69An `x` scry whose `path` is `/cors/approved/<origin>` tests whether the given origin URL is in the `approved` set of the CORS registry. The type returned is a simple `?`.
70
70
71−The origin URL must be a cord-encoded `@t` rather than just the plain `@t`, so you'll have to do something like `(scot %t 'foo')` rather than just `'foo'`.
71+The origin URL is a `@t`, but since `@t` may not be valid in a path, it must be encoded in a `@ta` using `+scot` like `(scot %t 'foo')` rather than just `'foo'`.
72
72
73Examples:
73Examples:
74
74
@@ -82,7 +82,7 @@ Examples:
82%.n
82%.n
83```
83```
84
84
85−## `/x/cors/rejected`
85+## `/cors/rejected`
86
86
87An `x` scry with a `path` of `/cors/rejected` will return the `set` of rejected CORS origins. The type returned is a `(set origin:eyre)`.
87An `x` scry with a `path` of `/cors/rejected` will return the `set` of rejected CORS origins. The type returned is a `(set origin:eyre)`.
88
88
@@ -93,7 +93,7 @@ Example:
93rejected={~~http~3a.~2f.~2f.bar~.example}
93rejected={~~http~3a.~2f.~2f.bar~.example}
94```
94```
95
95
96−## `/x/cors/rejected/<origin>`
96+## `/cors/rejected/<origin>`
97
97
98An `x` scry whose `path` is `/cors/rejected/<origin>` tests whether the given origin URL is in the `rejected` set of the CORS registry. The type returned is a simple `?`.
98An `x` scry whose `path` is `/cors/rejected/<origin>` tests whether the given origin URL is in the `rejected` set of the CORS registry. The type returned is a simple `?`.
99
99
@@ -111,7 +111,7 @@ Examples:
111%.n
111%.n
112```
112```
113
113
114−# `/x/authenticated/cookie/<cookie>`
114+# `/authenticated/cookie/<cookie>`
115
115
116An `x` scry whose `path` is `/authenticated/cookies/<cookie>` tests whether the given cookie is currently valid. The type returned is a `?`.
116An `x` scry whose `path` is `/authenticated/cookies/<cookie>` tests whether the given cookie is currently valid. The type returned is a `?`.
117
117
@@ -146,26 +146,7 @@ Example:
146 ~[/gall/use/file-server/0w2.EijQB/~zod/~landscape /dill //term/1]
146 ~[/gall/use/file-server/0w2.EijQB/~zod/~landscape /dill //term/1]
147 [%app app=%file-server]
147 [%app app=%file-server]
148 ]
148 ]
149− [ [site=~ path=<|~chat|>]
149+ ...(truncated for brevity)...
150− ~[/gall/use/file-server/0w2.EijQB/~zod/~chat /dill //term/1]
151− [%app app=%file-server]
152− ]
153− [[site=~ path=<|~ scry|>] ~[/dill //term/1] [%scry ~]]
154− [[site=~ path=<|~ logout|>] ~[/dill //term/1] [%logout ~]]
155− [[site=~ path=<|~ login|>] ~[/dill //term/1] [%authentication ~]]
156− [[site=~ path=<|~ channel|>] ~[/dill //term/1] [%channel ~]]
157− [ [site=~ path=<|spider|>]
158− ~[/gall/use/spider/0w2.EijQB/~zod/bind /dill //term/1]
159− [%app app=%spider]
160− ]
161− [ [site=~ path=<|.well-known acme-challenge|>]
162− ~[/gall/use/acme/0w2.EijQB/~zod/acme /dill //term/1]
163− [%gen generator=[desk=%home path=<|gen acme domain-validation hoon|> args=0]]
164− ]
165− [ [site=~ path=<||>]
166− ~[/gall/use/file-server/0w2.EijQB/~zod /dill //term/1]
167− [%app app=%file-server]
168− ]
169]
150]
170```
151```
171
152