@damurka/jovian 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (91) hide show
  1. package/LICENSE +24 -0
  2. package/README.md +175 -0
  3. package/docs/api/README.md +55 -0
  4. package/docs/api/session.md +143 -0
  5. package/docs/api/types.md +120 -0
  6. package/docs/architecture/overview.md +218 -0
  7. package/docs/cpp-usage.md +60 -0
  8. package/docs/development.md +105 -0
  9. package/docs/getting-started.md +127 -0
  10. package/docs/guides/comms.md +70 -0
  11. package/docs/guides/environments.md +80 -0
  12. package/docs/guides/history.md +44 -0
  13. package/docs/guides/interactive-input.md +48 -0
  14. package/docs/guides/interrupting.md +45 -0
  15. package/docs/guides/playground.md +33 -0
  16. package/docs/guides/sessions-lifecycle.md +70 -0
  17. package/docs/kernels.md +117 -0
  18. package/docs/protocol.md +135 -0
  19. package/docs/releasing.md +73 -0
  20. package/docs/troubleshooting.md +110 -0
  21. package/lib/execution/execution-queue.d.ts +20 -0
  22. package/lib/execution/execution-queue.js +256 -0
  23. package/lib/handlers/display-handler.d.ts +7 -0
  24. package/lib/handlers/display-handler.js +10 -0
  25. package/lib/handlers/error-handler.d.ts +7 -0
  26. package/lib/handlers/error-handler.js +8 -0
  27. package/lib/handlers/result-handler.d.ts +7 -0
  28. package/lib/handlers/result-handler.js +10 -0
  29. package/lib/handlers/stream-handler.d.ts +7 -0
  30. package/lib/handlers/stream-handler.js +8 -0
  31. package/lib/index.d.ts +7 -0
  32. package/lib/index.js +5 -0
  33. package/lib/messaging/message-parser.d.ts +6 -0
  34. package/lib/messaging/message-parser.js +33 -0
  35. package/lib/messaging/message-router.d.ts +14 -0
  36. package/lib/messaging/message-router.js +41 -0
  37. package/lib/middleware/index.d.ts +5 -0
  38. package/lib/middleware/index.js +5 -0
  39. package/lib/middleware/middleware-chain.d.ts +7 -0
  40. package/lib/middleware/middleware-chain.js +14 -0
  41. package/lib/middleware/middleware.d.ts +5 -0
  42. package/lib/middleware/middleware.js +2 -0
  43. package/lib/middleware/plugins/logging-plugin.d.ts +6 -0
  44. package/lib/middleware/plugins/logging-plugin.js +9 -0
  45. package/lib/middleware/plugins/metrics-plugin.d.ts +8 -0
  46. package/lib/middleware/plugins/metrics-plugin.js +13 -0
  47. package/lib/session/comm.d.ts +39 -0
  48. package/lib/session/comm.js +58 -0
  49. package/lib/session/native-paths.d.ts +48 -0
  50. package/lib/session/native-paths.js +108 -0
  51. package/lib/session/session-manager.d.ts +229 -0
  52. package/lib/session/session-manager.js +842 -0
  53. package/lib/session/supervisor-client.d.ts +36 -0
  54. package/lib/session/supervisor-client.js +147 -0
  55. package/lib/types/engine.d.ts +269 -0
  56. package/lib/types/engine.js +2 -0
  57. package/lib/types/index.d.ts +3 -0
  58. package/lib/types/index.js +3 -0
  59. package/lib/types/messages.d.ts +68 -0
  60. package/lib/types/messages.js +2 -0
  61. package/lib/utils/logger.d.ts +12 -0
  62. package/lib/utils/logger.js +58 -0
  63. package/lib/utils/network.d.ts +11 -0
  64. package/lib/utils/network.js +50 -0
  65. package/package.json +57 -0
  66. package/packages/hera/DESCRIPTION +29 -0
  67. package/packages/hera/LICENSE +2 -0
  68. package/packages/hera/LICENSE.md +21 -0
  69. package/packages/hera/NAMESPACE +32 -0
  70. package/packages/hera/NEWS.md +7 -0
  71. package/packages/hera/R/cell_options.R +13 -0
  72. package/packages/hera/R/comm.R +228 -0
  73. package/packages/hera/R/completion.R +54 -0
  74. package/packages/hera/R/execute.R +199 -0
  75. package/packages/hera/R/inspect.R +73 -0
  76. package/packages/hera/R/log.R +14 -0
  77. package/packages/hera/R/mime_bundle.R +65 -0
  78. package/packages/hera/R/routines.R +86 -0
  79. package/packages/hera/R/utils.R +32 -0
  80. package/packages/hera/R/zzz.R +128 -0
  81. package/packages/hera/man/Comm.Rd +179 -0
  82. package/packages/hera/man/CommManager.Rd +215 -0
  83. package/packages/hera/man/View.Rd +22 -0
  84. package/packages/hera/man/cell_options.Rd +20 -0
  85. package/packages/hera/man/clear_output.Rd +23 -0
  86. package/packages/hera/man/complete.Rd +23 -0
  87. package/packages/hera/man/display_data.Rd +22 -0
  88. package/packages/hera/man/is_elara.Rd +18 -0
  89. package/packages/hera/man/mime_bundle.Rd +25 -0
  90. package/packages/hera/man/mime_types.Rd +22 -0
  91. package/packages/hera/man/reexports.Rd +16 -0
@@ -0,0 +1,215 @@
1
+ % Generated by roxygen2: do not edit by hand
2
+ % Please edit documentation in R/comm.R
3
+ \name{CommManagerClass}
4
+ \alias{CommManagerClass}
5
+ \alias{CommManager}
6
+ \title{Comm Manager class}
7
+ \usage{
8
+ CommManager
9
+ }
10
+ \description{
11
+ Instance of the \link{CommManagerClass} class.
12
+ }
13
+ \section{Methods}{
14
+ \subsection{Public methods}{
15
+ \itemize{
16
+ \item \href{#method-CommManagerClass-initialize}{\code{CommManagerClass$new()}}
17
+ \item \href{#method-CommManagerClass-register_comm_target}{\code{CommManagerClass$register_comm_target()}}
18
+ \item \href{#method-CommManagerClass-unregister_comm_target}{\code{CommManagerClass$unregister_comm_target()}}
19
+ \item \href{#method-CommManagerClass-new_comm}{\code{CommManagerClass$new_comm()}}
20
+ \item \href{#method-CommManagerClass-comms}{\code{CommManagerClass$comms()}}
21
+ \item \href{#method-CommManagerClass-target_callback}{\code{CommManagerClass$target_callback()}}
22
+ \item \href{#method-CommManagerClass-preserve}{\code{CommManagerClass$preserve()}}
23
+ \item \href{#method-CommManagerClass-release}{\code{CommManagerClass$release()}}
24
+ \item \href{#method-CommManagerClass-get_comm_info}{\code{CommManagerClass$get_comm_info()}}
25
+ \item \href{#method-CommManagerClass-clone}{\code{CommManagerClass$clone()}}
26
+ }
27
+ }
28
+ \if{html}{\out{<hr>}}
29
+ \if{html}{\out{<a id="method-CommManagerClass-initialize"></a>}}
30
+ \if{latex}{\out{\hypertarget{method-CommManagerClass-initialize}{}}}
31
+ \subsection{\code{CommManagerClass$new()}}{
32
+ \subsection{Usage}{
33
+ \if{html}{\out{<div class="r">}}
34
+ \preformatted{CommManagerClass$new(..., error_call = caller_env())}
35
+ \if{html}{\out{</div>}}
36
+ }
37
+ \subsection{Arguments}{
38
+ \if{html}{\out{<div class="arguments">}}
39
+ \describe{
40
+ \item{\code{...}}{currently unused}
41
+ \item{\code{error_call}}{see \code{\link[rlang:args_error_context]{rlang::args_error_context()}}}
42
+ }
43
+ \if{html}{\out{</div>}}
44
+ }
45
+ }
46
+
47
+ \if{html}{\out{<hr>}}
48
+ \if{html}{\out{<a id="method-CommManagerClass-register_comm_target"></a>}}
49
+ \if{latex}{\out{\hypertarget{method-CommManagerClass-register_comm_target}{}}}
50
+ \subsection{\code{CommManagerClass$register_comm_target()}}{
51
+ \subsection{Usage}{
52
+ \if{html}{\out{<div class="r">}}
53
+ \preformatted{CommManagerClass$register_comm_target(
54
+ target_name,
55
+ callback = function(comm, message) {
56
+ }
57
+ )}
58
+ \if{html}{\out{</div>}}
59
+ }
60
+ \subsection{Arguments}{
61
+ \if{html}{\out{<div class="arguments">}}
62
+ \describe{
63
+ \item{\code{target_name}}{name of the comm target, e.g. "jupyter.widgets"}
64
+ \item{\code{callback}}{callback function taking two arguments 'comm' and 'message'.}
65
+ }
66
+ \if{html}{\out{</div>}}
67
+ }
68
+ }
69
+
70
+ \if{html}{\out{<hr>}}
71
+ \if{html}{\out{<a id="method-CommManagerClass-unregister_comm_target"></a>}}
72
+ \if{latex}{\out{\hypertarget{method-CommManagerClass-unregister_comm_target}{}}}
73
+ \subsection{\code{CommManagerClass$unregister_comm_target()}}{
74
+ \subsection{Usage}{
75
+ \if{html}{\out{<div class="r">}}
76
+ \preformatted{CommManagerClass$unregister_comm_target(target_name)}
77
+ \if{html}{\out{</div>}}
78
+ }
79
+ \subsection{Arguments}{
80
+ \if{html}{\out{<div class="arguments">}}
81
+ \describe{
82
+ \item{\code{target_name}}{name of the comm target}
83
+ }
84
+ \if{html}{\out{</div>}}
85
+ }
86
+ }
87
+
88
+ \if{html}{\out{<hr>}}
89
+ \if{html}{\out{<a id="method-CommManagerClass-new_comm"></a>}}
90
+ \if{latex}{\out{\hypertarget{method-CommManagerClass-new_comm}{}}}
91
+ \subsection{\code{CommManagerClass$new_comm()}}{
92
+ \subsection{Usage}{
93
+ \if{html}{\out{<div class="r">}}
94
+ \preformatted{CommManagerClass$new_comm(target_name, description = "")}
95
+ \if{html}{\out{</div>}}
96
+ }
97
+ \subsection{Arguments}{
98
+ \if{html}{\out{<div class="arguments">}}
99
+ \describe{
100
+ \item{\code{target_name}}{name of the target}
101
+ \item{\code{description}}{description of the comm}
102
+ }
103
+ \if{html}{\out{</div>}}
104
+ }
105
+ }
106
+
107
+ \if{html}{\out{<hr>}}
108
+ \if{html}{\out{<a id="method-CommManagerClass-comms"></a>}}
109
+ \if{latex}{\out{\hypertarget{method-CommManagerClass-comms}{}}}
110
+ \subsection{\code{CommManagerClass$comms()}}{
111
+ \subsection{Usage}{
112
+ \if{html}{\out{<div class="r">}}
113
+ \preformatted{CommManagerClass$comms()}
114
+ \if{html}{\out{</div>}}
115
+ }
116
+ \subsection{Returns}{
117
+ the list of currently open comms
118
+ }
119
+ }
120
+
121
+ \if{html}{\out{<hr>}}
122
+ \if{html}{\out{<a id="method-CommManagerClass-target_callback"></a>}}
123
+ \if{latex}{\out{\hypertarget{method-CommManagerClass-target_callback}{}}}
124
+ \subsection{\code{CommManagerClass$target_callback()}}{
125
+ \subsection{Usage}{
126
+ \if{html}{\out{<div class="r">}}
127
+ \preformatted{CommManagerClass$target_callback(target_name)}
128
+ \if{html}{\out{</div>}}
129
+ }
130
+ \subsection{Arguments}{
131
+ \if{html}{\out{<div class="arguments">}}
132
+ \describe{
133
+ \item{\code{target_name}}{name of the comm target}
134
+ }
135
+ \if{html}{\out{</div>}}
136
+ }
137
+ \subsection{Returns}{
138
+ the callback for that target name
139
+ }
140
+ }
141
+
142
+ \if{html}{\out{<hr>}}
143
+ \if{html}{\out{<a id="method-CommManagerClass-preserve"></a>}}
144
+ \if{latex}{\out{\hypertarget{method-CommManagerClass-preserve}{}}}
145
+ \subsection{\code{CommManagerClass$preserve()}}{
146
+ \subsection{Usage}{
147
+ \if{html}{\out{<div class="r">}}
148
+ \preformatted{CommManagerClass$preserve(comm)}
149
+ \if{html}{\out{</div>}}
150
+ }
151
+ \subsection{Arguments}{
152
+ \if{html}{\out{<div class="arguments">}}
153
+ \describe{
154
+ \item{\code{comm}}{\link{Comm} instance to preserve}
155
+ }
156
+ \if{html}{\out{</div>}}
157
+ }
158
+ }
159
+
160
+ \if{html}{\out{<hr>}}
161
+ \if{html}{\out{<a id="method-CommManagerClass-release"></a>}}
162
+ \if{latex}{\out{\hypertarget{method-CommManagerClass-release}{}}}
163
+ \subsection{\code{CommManagerClass$release()}}{
164
+ \subsection{Usage}{
165
+ \if{html}{\out{<div class="r">}}
166
+ \preformatted{CommManagerClass$release(comm)}
167
+ \if{html}{\out{</div>}}
168
+ }
169
+ \subsection{Arguments}{
170
+ \if{html}{\out{<div class="arguments">}}
171
+ \describe{
172
+ \item{\code{comm}}{\link{Comm} instance to release}
173
+ }
174
+ \if{html}{\out{</div>}}
175
+ }
176
+ }
177
+
178
+ \if{html}{\out{<hr>}}
179
+ \if{html}{\out{<a id="method-CommManagerClass-get_comm_info"></a>}}
180
+ \if{latex}{\out{\hypertarget{method-CommManagerClass-get_comm_info}{}}}
181
+ \subsection{\code{CommManagerClass$get_comm_info()}}{
182
+ \subsection{Usage}{
183
+ \if{html}{\out{<div class="r">}}
184
+ \preformatted{CommManagerClass$get_comm_info(target_name = NULL)}
185
+ \if{html}{\out{</div>}}
186
+ }
187
+ \subsection{Arguments}{
188
+ \if{html}{\out{<div class="arguments">}}
189
+ \describe{
190
+ \item{\code{target_name}}{name of the target to get info about all comm opens. If NULL, info for comms for all targets are returned.}
191
+ }
192
+ \if{html}{\out{</div>}}
193
+ }
194
+ }
195
+
196
+ \if{html}{\out{<hr>}}
197
+ \if{html}{\out{<a id="method-CommManagerClass-clone"></a>}}
198
+ \if{latex}{\out{\hypertarget{method-CommManagerClass-clone}{}}}
199
+ \subsection{\code{CommManagerClass$clone()}}{
200
+ The objects of this class are cloneable with this method.
201
+ \subsection{Usage}{
202
+ \if{html}{\out{<div class="r">}}
203
+ \preformatted{CommManagerClass$clone(deep = FALSE)}
204
+ \if{html}{\out{</div>}}
205
+ }
206
+ \subsection{Arguments}{
207
+ \if{html}{\out{<div class="arguments">}}
208
+ \describe{
209
+ \item{\code{deep}}{Whether to make a deep clone.}
210
+ }
211
+ \if{html}{\out{</div>}}
212
+ }
213
+ }
214
+
215
+ }
@@ -0,0 +1,22 @@
1
+ % Generated by roxygen2: do not edit by hand
2
+ % Please edit documentation in R/routines.R
3
+ \name{View}
4
+ \alias{View}
5
+ \title{View}
6
+ \usage{
7
+ View(x, title)
8
+ }
9
+ \arguments{
10
+ \item{x}{something to display}
11
+
12
+ \item{title}{title of the display}
13
+ }
14
+ \description{
15
+ View
16
+ }
17
+ \examples{
18
+ \dontrun{
19
+ View(mtcars)
20
+ }
21
+
22
+ }
@@ -0,0 +1,20 @@
1
+ % Generated by roxygen2: do not edit by hand
2
+ % Please edit documentation in R/cell_options.R
3
+ \name{cell_options}
4
+ \alias{cell_options}
5
+ \title{Options for current jupyter cell}
6
+ \usage{
7
+ cell_options(...)
8
+ }
9
+ \arguments{
10
+ \item{...}{options to set locally to the notebook cell. Forwarded to \code{\link[rlang:local_options]{rlang::local_options()}}.}
11
+ }
12
+ \description{
13
+ Options for current jupyter cell
14
+ }
15
+ \examples{
16
+ \dontrun{
17
+ cell_options(repr.plot.bg = "gray")
18
+ }
19
+
20
+ }
@@ -0,0 +1,23 @@
1
+ % Generated by roxygen2: do not edit by hand
2
+ % Please edit documentation in R/routines.R
3
+ \name{clear_output}
4
+ \alias{clear_output}
5
+ \title{Clear output}
6
+ \usage{
7
+ clear_output(wait = FALSE)
8
+ }
9
+ \arguments{
10
+ \item{wait}{Should this wait}
11
+ }
12
+ \value{
13
+ NULL invisibly
14
+ }
15
+ \description{
16
+ Clear output
17
+ }
18
+ \examples{
19
+ \dontrun{
20
+ clear_output()
21
+ }
22
+
23
+ }
@@ -0,0 +1,23 @@
1
+ % Generated by roxygen2: do not edit by hand
2
+ % Please edit documentation in R/completion.R
3
+ \name{complete}
4
+ \alias{complete}
5
+ \title{Code completion}
6
+ \usage{
7
+ complete(code, cursor_pos = nchar(code))
8
+ }
9
+ \arguments{
10
+ \item{code}{R code to complete}
11
+
12
+ \item{cursor_pos}{position of the cursor}
13
+ }
14
+ \value{
15
+ a list that contains potential completions as the first item
16
+ }
17
+ \description{
18
+ Code completion
19
+ }
20
+ \examples{
21
+ complete("rnorm(")
22
+
23
+ }
@@ -0,0 +1,22 @@
1
+ % Generated by roxygen2: do not edit by hand
2
+ % Please edit documentation in R/routines.R
3
+ \name{display_data}
4
+ \alias{display_data}
5
+ \title{Display data}
6
+ \usage{
7
+ display_data(data = NULL, metadata = NULL)
8
+ }
9
+ \arguments{
10
+ \item{data}{data to display}
11
+
12
+ \item{metadata}{potential metadata}
13
+ }
14
+ \description{
15
+ Display data
16
+ }
17
+ \examples{
18
+ \dontrun{
19
+ display_data(mtcars)
20
+ }
21
+
22
+ }
@@ -0,0 +1,18 @@
1
+ % Generated by roxygen2: do not edit by hand
2
+ % Please edit documentation in R/zzz.R
3
+ \name{is_elara}
4
+ \alias{is_elara}
5
+ \title{Is this a running Elara jupyter kernel}
6
+ \usage{
7
+ is_elara()
8
+ }
9
+ \value{
10
+ TRUE if the current session is running in an Elara kernel
11
+ }
12
+ \description{
13
+ Is this a running Elara jupyter kernel
14
+ }
15
+ \examples{
16
+ is_elara()
17
+
18
+ }
@@ -0,0 +1,25 @@
1
+ % Generated by roxygen2: do not edit by hand
2
+ % Please edit documentation in R/mime_bundle.R
3
+ \name{mime_bundle}
4
+ \alias{mime_bundle}
5
+ \title{bundle an object}
6
+ \usage{
7
+ mime_bundle(x, mimetypes = mime_types(x), ...)
8
+ }
9
+ \arguments{
10
+ \item{x}{an object}
11
+
12
+ \item{mimetypes}{mime types}
13
+
14
+ \item{...}{extra currently unused parameters}
15
+ }
16
+ \description{
17
+ bundle an object
18
+ }
19
+ \examples{
20
+ mime_bundle(letters)
21
+
22
+ }
23
+ \seealso{
24
+ IRdisplay::prepare_mimebundle which this currently wraps around
25
+ }
@@ -0,0 +1,22 @@
1
+ % Generated by roxygen2: do not edit by hand
2
+ % Please edit documentation in R/mime_bundle.R
3
+ \name{mime_types}
4
+ \alias{mime_types}
5
+ \title{MIME types supported by an object}
6
+ \usage{
7
+ mime_types(x)
8
+ }
9
+ \arguments{
10
+ \item{x}{an object}
11
+ }
12
+ \value{
13
+ a character vector of its supported mime types
14
+ }
15
+ \description{
16
+ MIME types supported by an object
17
+ }
18
+ \examples{
19
+ mime_types(letters)
20
+ mime_types(mtcars)
21
+
22
+ }
@@ -0,0 +1,16 @@
1
+ % Generated by roxygen2: do not edit by hand
2
+ % Please edit documentation in R/zzz.R
3
+ \docType{import}
4
+ \name{reexports}
5
+ \alias{reexports}
6
+ \alias{display}
7
+ \title{Objects exported from other packages}
8
+ \keyword{internal}
9
+ \description{
10
+ These objects are imported from other packages. Follow the links
11
+ below to see their documentation.
12
+
13
+ \describe{
14
+ \item{IRdisplay}{\code{\link[IRdisplay:display]{display()}}}
15
+ }}
16
+