this repo has no description
feat: initial commit
+862
+28
.gitignore
+28
.gitignore
···
1
+
# Created by https://www.toptal.com/developers/gitignore/api/go
2
+
# Edit at https://www.toptal.com/developers/gitignore?templates=go
3
+
4
+
### Go ###
5
+
# If you prefer the allow list template instead of the deny list, see community template:
6
+
# https://github.com/github/gitignore/blob/main/community/Golang/Go.AllowList.gitignore
7
+
#
8
+
# Binaries for programs and plugins
9
+
*.exe
10
+
*.exe~
11
+
*.dll
12
+
*.so
13
+
*.dylib
14
+
15
+
# Test binary, built with `go test -c`
16
+
*.test
17
+
18
+
# Output of the go coverage tool, specifically when used with LiteIDE
19
+
*.out
20
+
21
+
# Dependency directories (remove the comment below to include it)
22
+
# vendor/
23
+
24
+
# Go workspace file
25
+
go.work
26
+
27
+
# End of https://www.toptal.com/developers/gitignore/api/go
28
+
.env
+613
LICENSE
+613
LICENSE
···
1
+
GNU AFFERO GENERAL PUBLIC LICENSE
2
+
3
+
Version 3, 19 November 2007
4
+
5
+
Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
6
+
7
+
Everyone is permitted to copy and distribute verbatim copies of this license
8
+
document, but changing it is not allowed.
9
+
10
+
Preamble
11
+
12
+
The GNU Affero General Public License is a free, copyleft license for software
13
+
and other kinds of works, specifically designed to ensure cooperation with
14
+
the community in the case of network server software.
15
+
16
+
The licenses for most software and other practical works are designed to take
17
+
away your freedom to share and change the works. By contrast, our General
18
+
Public Licenses are intended to guarantee your freedom to share and change
19
+
all versions of a program--to make sure it remains free software for all its
20
+
users.
21
+
22
+
When we speak of free software, we are referring to freedom, not price. Our
23
+
General Public Licenses are designed to make sure that you have the freedom
24
+
to distribute copies of free software (and charge for them if you wish), that
25
+
you receive source code or can get it if you want it, that you can change
26
+
the software or use pieces of it in new free programs, and that you know you
27
+
can do these things.
28
+
29
+
Developers that use our General Public Licenses protect your rights with two
30
+
steps: (1) assert copyright on the software, and (2) offer you this License
31
+
which gives you legal permission to copy, distribute and/or modify the software.
32
+
33
+
A secondary benefit of defending all users' freedom is that improvements made
34
+
in alternate versions of the program, if they receive widespread use, become
35
+
available for other developers to incorporate. Many developers of free software
36
+
are heartened and encouraged by the resulting cooperation. However, in the
37
+
case of software used on network servers, this result may fail to come about.
38
+
The GNU General Public License permits making a modified version and letting
39
+
the public access it on a server without ever releasing its source code to
40
+
the public.
41
+
42
+
The GNU Affero General Public License is designed specifically to ensure that,
43
+
in such cases, the modified source code becomes available to the community.
44
+
It requires the operator of a network server to provide the source code of
45
+
the modified version running there to the users of that server. Therefore,
46
+
public use of a modified version, on a publicly accessible server, gives the
47
+
public access to the source code of the modified version.
48
+
49
+
An older license, called the Affero General Public License and published by
50
+
Affero, was designed to accomplish similar goals. This is a different license,
51
+
not a version of the Affero GPL, but Affero has released a new version of
52
+
the Affero GPL which permits relicensing under this license.
53
+
54
+
The precise terms and conditions for copying, distribution and modification
55
+
follow.
56
+
57
+
TERMS AND CONDITIONS
58
+
59
+
0. Definitions.
60
+
61
+
"This License" refers to version 3 of the GNU Affero General Public License.
62
+
63
+
"Copyright" also means copyright-like laws that apply to other kinds of works,
64
+
such as semiconductor masks.
65
+
66
+
"The Program" refers to any copyrightable work licensed under this License.
67
+
Each licensee is addressed as "you". "Licensees" and "recipients" may be individuals
68
+
or organizations.
69
+
70
+
To "modify" a work means to copy from or adapt all or part of the work in
71
+
a fashion requiring copyright permission, other than the making of an exact
72
+
copy. The resulting work is called a "modified version" of the earlier work
73
+
or a work "based on" the earlier work.
74
+
75
+
A "covered work" means either the unmodified Program or a work based on the
76
+
Program.
77
+
78
+
To "propagate" a work means to do anything with it that, without permission,
79
+
would make you directly or secondarily liable for infringement under applicable
80
+
copyright law, except executing it on a computer or modifying a private copy.
81
+
Propagation includes copying, distribution (with or without modification),
82
+
making available to the public, and in some countries other activities as
83
+
well.
84
+
85
+
To "convey" a work means any kind of propagation that enables other parties
86
+
to make or receive copies. Mere interaction with a user through a computer
87
+
network, with no transfer of a copy, is not conveying.
88
+
89
+
An interactive user interface displays "Appropriate Legal Notices" to the
90
+
extent that it includes a convenient and prominently visible feature that
91
+
(1) displays an appropriate copyright notice, and (2) tells the user that
92
+
there is no warranty for the work (except to the extent that warranties are
93
+
provided), that licensees may convey the work under this License, and how
94
+
to view a copy of this License. If the interface presents a list of user commands
95
+
or options, such as a menu, a prominent item in the list meets this criterion.
96
+
97
+
1. Source Code.
98
+
99
+
The "source code" for a work means the preferred form of the work for making
100
+
modifications to it. "Object code" means any non-source form of a work.
101
+
102
+
A "Standard Interface" means an interface that either is an official standard
103
+
defined by a recognized standards body, or, in the case of interfaces specified
104
+
for a particular programming language, one that is widely used among developers
105
+
working in that language.
106
+
107
+
The "System Libraries" of an executable work include anything, other than
108
+
the work as a whole, that (a) is included in the normal form of packaging
109
+
a Major Component, but which is not part of that Major Component, and (b)
110
+
serves only to enable use of the work with that Major Component, or to implement
111
+
a Standard Interface for which an implementation is available to the public
112
+
in source code form. A "Major Component", in this context, means a major essential
113
+
component (kernel, window system, and so on) of the specific operating system
114
+
(if any) on which the executable work runs, or a compiler used to produce
115
+
the work, or an object code interpreter used to run it.
116
+
117
+
The "Corresponding Source" for a work in object code form means all the source
118
+
code needed to generate, install, and (for an executable work) run the object
119
+
code and to modify the work, including scripts to control those activities.
120
+
However, it does not include the work's System Libraries, or general-purpose
121
+
tools or generally available free programs which are used unmodified in performing
122
+
those activities but which are not part of the work. For example, Corresponding
123
+
Source includes interface definition files associated with source files for
124
+
the work, and the source code for shared libraries and dynamically linked
125
+
subprograms that the work is specifically designed to require, such as by
126
+
intimate data communication or control flow between those
127
+
128
+
subprograms and other parts of the work.
129
+
130
+
The Corresponding Source need not include anything that users can regenerate
131
+
automatically from other parts of the Corresponding Source.
132
+
133
+
The Corresponding Source for a work in source code form is that same work.
134
+
135
+
2. Basic Permissions.
136
+
137
+
All rights granted under this License are granted for the term of copyright
138
+
on the Program, and are irrevocable provided the stated conditions are met.
139
+
This License explicitly affirms your unlimited permission to run the unmodified
140
+
Program. The output from running a covered work is covered by this License
141
+
only if the output, given its content, constitutes a covered work. This License
142
+
acknowledges your rights of fair use or other equivalent, as provided by copyright
143
+
law.
144
+
145
+
You may make, run and propagate covered works that you do not convey, without
146
+
conditions so long as your license otherwise remains in force. You may convey
147
+
covered works to others for the sole purpose of having them make modifications
148
+
exclusively for you, or provide you with facilities for running those works,
149
+
provided that you comply with the terms of this License in conveying all material
150
+
for which you do not control copyright. Those thus making or running the covered
151
+
works for you must do so exclusively on your behalf, under your direction
152
+
and control, on terms that prohibit them from making any copies of your copyrighted
153
+
material outside their relationship with you.
154
+
155
+
Conveying under any other circumstances is permitted solely under the conditions
156
+
stated below. Sublicensing is not allowed; section 10 makes it unnecessary.
157
+
158
+
3. Protecting Users' Legal Rights From Anti-Circumvention Law.
159
+
160
+
No covered work shall be deemed part of an effective technological measure
161
+
under any applicable law fulfilling obligations under article 11 of the WIPO
162
+
copyright treaty adopted on 20 December 1996, or similar laws prohibiting
163
+
or restricting circumvention of such measures.
164
+
165
+
When you convey a covered work, you waive any legal power to forbid circumvention
166
+
of technological measures to the extent such circumvention is effected by
167
+
exercising rights under this License with respect to the covered work, and
168
+
you disclaim any intention to limit operation or modification of the work
169
+
as a means of enforcing, against the work's users, your or third parties'
170
+
legal rights to forbid circumvention of technological measures.
171
+
172
+
4. Conveying Verbatim Copies.
173
+
174
+
You may convey verbatim copies of the Program's source code as you receive
175
+
it, in any medium, provided that you conspicuously and appropriately publish
176
+
on each copy an appropriate copyright notice; keep intact all notices stating
177
+
that this License and any non-permissive terms added in accord with section
178
+
7 apply to the code; keep intact all notices of the absence of any warranty;
179
+
and give all recipients a copy of this License along with the Program.
180
+
181
+
You may charge any price or no price for each copy that you convey, and you
182
+
may offer support or warranty protection for a fee.
183
+
184
+
5. Conveying Modified Source Versions.
185
+
186
+
You may convey a work based on the Program, or the modifications to produce
187
+
it from the Program, in the form of source code under the terms of section
188
+
4, provided that you also meet all of these conditions:
189
+
190
+
a) The work must carry prominent notices stating that you modified it, and
191
+
giving a relevant date.
192
+
193
+
b) The work must carry prominent notices stating that it is released under
194
+
this License and any conditions added under section 7. This requirement modifies
195
+
the requirement in section 4 to "keep intact all notices".
196
+
197
+
c) You must license the entire work, as a whole, under this License to anyone
198
+
who comes into possession of a copy. This License will therefore apply, along
199
+
with any applicable section 7 additional terms, to the whole of the work,
200
+
and all its parts, regardless of how they are packaged. This License gives
201
+
no permission to license the work in any other way, but it does not invalidate
202
+
such permission if you have separately received it.
203
+
204
+
d) If the work has interactive user interfaces, each must display Appropriate
205
+
Legal Notices; however, if the Program has interactive interfaces that do
206
+
not display Appropriate Legal Notices, your work need not make them do so.
207
+
208
+
A compilation of a covered work with other separate and independent works,
209
+
which are not by their nature extensions of the covered work, and which are
210
+
not combined with it such as to form a larger program, in or on a volume of
211
+
a storage or distribution medium, is called an "aggregate" if the compilation
212
+
and its resulting copyright are not used to limit the access or legal rights
213
+
of the compilation's users beyond what the individual works permit. Inclusion
214
+
of a covered work in an aggregate does not cause this License to apply to
215
+
the other parts of the aggregate.
216
+
217
+
6. Conveying Non-Source Forms.
218
+
219
+
You may convey a covered work in object code form under the terms of sections
220
+
4 and 5, provided that you also convey the machine-readable Corresponding
221
+
Source under the terms of this License, in one of these ways:
222
+
223
+
a) Convey the object code in, or embodied in, a physical product (including
224
+
a physical distribution medium), accompanied by the Corresponding Source fixed
225
+
on a durable physical medium customarily used for software interchange.
226
+
227
+
b) Convey the object code in, or embodied in, a physical product (including
228
+
a physical distribution medium), accompanied by a written offer, valid for
229
+
at least three years and valid for as long as you offer spare parts or customer
230
+
support for that product model, to give anyone who possesses the object code
231
+
either (1) a copy of the Corresponding Source for all the software in the
232
+
product that is covered by this License, on a durable physical medium customarily
233
+
used for software interchange, for a price no more than your reasonable cost
234
+
of physically performing this conveying of source, or (2) access to copy the
235
+
Corresponding Source from a network server at no charge.
236
+
237
+
c) Convey individual copies of the object code with a copy of the written
238
+
offer to provide the Corresponding Source. This alternative is allowed only
239
+
occasionally and noncommercially, and only if you received the object code
240
+
with such an offer, in accord with subsection 6b.
241
+
242
+
d) Convey the object code by offering access from a designated place (gratis
243
+
or for a charge), and offer equivalent access to the Corresponding Source
244
+
in the same way through the same place at no further charge. You need not
245
+
require recipients to copy the Corresponding Source along with the object
246
+
code. If the place to copy the object code is a network server, the Corresponding
247
+
Source may be on a different server (operated by you or a third party) that
248
+
supports equivalent copying facilities, provided you maintain clear directions
249
+
next to the object code saying where to find the Corresponding Source. Regardless
250
+
of what server hosts the Corresponding Source, you remain obligated to ensure
251
+
that it is available for as long as needed to satisfy these requirements.
252
+
253
+
e) Convey the object code using peer-to-peer transmission, provided you inform
254
+
other peers where the object code and Corresponding Source of the work are
255
+
being offered to the general public at no charge under subsection 6d.
256
+
257
+
A separable portion of the object code, whose source code is excluded from
258
+
the Corresponding Source as a System Library, need not be included in conveying
259
+
the object code work.
260
+
261
+
A "User Product" is either (1) a "consumer product", which means any tangible
262
+
personal property which is normally used for personal, family, or household
263
+
purposes, or (2) anything designed or sold for incorporation into a dwelling.
264
+
In determining whether a product is a consumer product, doubtful cases shall
265
+
be resolved in favor of coverage. For a particular product received by a particular
266
+
user, "normally used" refers to a typical or common use of that class of product,
267
+
regardless of the status of the particular user or of the way in which the
268
+
particular user actually uses, or expects or is expected to use, the product.
269
+
A product is a consumer product regardless of whether the product has substantial
270
+
commercial, industrial or non-consumer uses, unless such uses represent the
271
+
only significant mode of use of the product.
272
+
273
+
"Installation Information" for a User Product means any methods, procedures,
274
+
authorization keys, or other information required to install and execute modified
275
+
versions of a covered work in that User Product from a modified version of
276
+
its Corresponding Source. The information must suffice to ensure that the
277
+
continued functioning of the modified object code is in no case prevented
278
+
or interfered with solely because modification has been made.
279
+
280
+
If you convey an object code work under this section in, or with, or specifically
281
+
for use in, a User Product, and the conveying occurs as part of a transaction
282
+
in which the right of possession and use of the User Product is transferred
283
+
to the recipient in perpetuity or for a fixed term (regardless of how the
284
+
transaction is characterized), the Corresponding Source conveyed under this
285
+
section must be accompanied by the Installation Information. But this requirement
286
+
does not apply if neither you nor any third party retains the ability to install
287
+
modified object code on the User Product (for example, the work has been installed
288
+
in ROM).
289
+
290
+
The requirement to provide Installation Information does not include a requirement
291
+
to continue to provide support service, warranty, or updates for a work that
292
+
has been modified or installed by the recipient, or for the User Product in
293
+
which it has been modified or installed. Access to a network may be denied
294
+
when the modification itself materially and adversely affects the operation
295
+
of the network or violates the rules and protocols for communication across
296
+
the network.
297
+
298
+
Corresponding Source conveyed, and Installation Information provided, in accord
299
+
with this section must be in a format that is publicly documented (and with
300
+
an implementation available to the public in source code form), and must require
301
+
no special password or key for unpacking, reading or copying.
302
+
303
+
7. Additional Terms.
304
+
305
+
"Additional permissions" are terms that supplement the terms of this License
306
+
by making exceptions from one or more of its conditions. Additional permissions
307
+
that are applicable to the entire Program shall be treated as though they
308
+
were included in this License, to the extent that they are valid under applicable
309
+
law. If additional permissions apply only to part of the Program, that part
310
+
may be used separately under those permissions, but the entire Program remains
311
+
governed by this License without regard to the additional permissions.
312
+
313
+
When you convey a copy of a covered work, you may at your option remove any
314
+
additional permissions from that copy, or from any part of it. (Additional
315
+
permissions may be written to require their own removal in certain cases when
316
+
you modify the work.) You may place additional permissions on material, added
317
+
by you to a covered work, for which you have or can give appropriate copyright
318
+
permission.
319
+
320
+
Notwithstanding any other provision of this License, for material you add
321
+
to a covered work, you may (if authorized by the copyright holders of that
322
+
material) supplement the terms of this License with terms:
323
+
324
+
a) Disclaiming warranty or limiting liability differently from the terms of
325
+
sections 15 and 16 of this License; or
326
+
327
+
b) Requiring preservation of specified reasonable legal notices or author
328
+
attributions in that material or in the Appropriate Legal Notices displayed
329
+
by works containing it; or
330
+
331
+
c) Prohibiting misrepresentation of the origin of that material, or requiring
332
+
that modified versions of such material be marked in reasonable ways as different
333
+
from the original version; or
334
+
335
+
d) Limiting the use for publicity purposes of names of licensors or authors
336
+
of the material; or
337
+
338
+
e) Declining to grant rights under trademark law for use of some trade names,
339
+
trademarks, or service marks; or
340
+
341
+
f) Requiring indemnification of licensors and authors of that material by
342
+
anyone who conveys the material (or modified versions of it) with contractual
343
+
assumptions of liability to the recipient, for any liability that these contractual
344
+
assumptions directly impose on those licensors and authors.
345
+
346
+
All other non-permissive additional terms are considered "further restrictions"
347
+
within the meaning of section 10. If the Program as you received it, or any
348
+
part of it, contains a notice stating that it is governed by this License
349
+
along with a term that is a further restriction, you may remove that term.
350
+
If a license document contains a further restriction but permits relicensing
351
+
or conveying under this License, you may add to a covered work material governed
352
+
by the terms of that license document, provided that the further restriction
353
+
does not survive such relicensing or conveying.
354
+
355
+
If you add terms to a covered work in accord with this section, you must place,
356
+
in the relevant source files, a statement of the additional terms that apply
357
+
to those files, or a notice indicating where to find the applicable terms.
358
+
359
+
Additional terms, permissive or non-permissive, may be stated in the form
360
+
of a separately written license, or stated as exceptions; the above requirements
361
+
apply either way.
362
+
363
+
8. Termination.
364
+
365
+
You may not propagate or modify a covered work except as expressly provided
366
+
under this License. Any attempt otherwise to propagate or modify it is void,
367
+
and will automatically terminate your rights under this License (including
368
+
any patent licenses granted under the third paragraph of section 11).
369
+
370
+
However, if you cease all violation of this License, then your license from
371
+
a particular copyright holder is reinstated (a) provisionally, unless and
372
+
until the copyright holder explicitly and finally terminates your license,
373
+
and (b) permanently, if the copyright holder fails to notify you of the violation
374
+
by some reasonable means prior to 60 days after the cessation.
375
+
376
+
Moreover, your license from a particular copyright holder is reinstated permanently
377
+
if the copyright holder notifies you of the violation by some reasonable means,
378
+
this is the first time you have received notice of violation of this License
379
+
(for any work) from that copyright holder, and you cure the violation prior
380
+
to 30 days after your receipt of the notice.
381
+
382
+
Termination of your rights under this section does not terminate the licenses
383
+
of parties who have received copies or rights from you under this License.
384
+
If your rights have been terminated and not permanently reinstated, you do
385
+
not qualify to receive new licenses for the same material under section 10.
386
+
387
+
9. Acceptance Not Required for Having Copies.
388
+
389
+
You are not required to accept this License in order to receive or run a copy
390
+
of the Program. Ancillary propagation of a covered work occurring solely as
391
+
a consequence of using peer-to-peer transmission to receive a copy likewise
392
+
does not require acceptance. However, nothing other than this License grants
393
+
you permission to propagate or modify any covered work. These actions infringe
394
+
copyright if you do not accept this License. Therefore, by modifying or propagating
395
+
a covered work, you indicate your acceptance of this License to do so.
396
+
397
+
10. Automatic Licensing of Downstream Recipients.
398
+
399
+
Each time you convey a covered work, the recipient automatically receives
400
+
a license from the original licensors, to run, modify and propagate that work,
401
+
subject to this License. You are not responsible for enforcing compliance
402
+
by third parties with this License.
403
+
404
+
An "entity transaction" is a transaction transferring control of an organization,
405
+
or substantially all assets of one, or subdividing an organization, or merging
406
+
organizations. If propagation of a covered work results from an entity transaction,
407
+
each party to that transaction who receives a copy of the work also receives
408
+
whatever licenses to the work the party's predecessor in interest had or could
409
+
give under the previous paragraph, plus a right to possession of the Corresponding
410
+
Source of the work from the predecessor in interest, if the predecessor has
411
+
it or can get it with reasonable efforts.
412
+
413
+
You may not impose any further restrictions on the exercise of the rights
414
+
granted or affirmed under this License. For example, you may not impose a
415
+
license fee, royalty, or other charge for exercise of rights granted under
416
+
this License, and you may not initiate litigation (including a cross-claim
417
+
or counterclaim in a lawsuit) alleging that any patent claim is infringed
418
+
by making, using, selling, offering for sale, or importing the Program or
419
+
any portion of it.
420
+
421
+
11. Patents.
422
+
423
+
A "contributor" is a copyright holder who authorizes use under this License
424
+
of the Program or a work on which the Program is based. The work thus licensed
425
+
is called the contributor's "contributor version".
426
+
427
+
A contributor's "essential patent claims" are all patent claims owned or controlled
428
+
by the contributor, whether already acquired or hereafter acquired, that would
429
+
be infringed by some manner, permitted by this License, of making, using,
430
+
or selling its contributor version, but do not include claims that would be
431
+
infringed only as a consequence of further modification of the contributor
432
+
version. For purposes of this definition, "control" includes the right to
433
+
grant patent sublicenses in a manner consistent with the requirements of this
434
+
License.
435
+
436
+
Each contributor grants you a non-exclusive, worldwide, royalty-free patent
437
+
license under the contributor's essential patent claims, to make, use, sell,
438
+
offer for sale, import and otherwise run, modify and propagate the contents
439
+
of its contributor version.
440
+
441
+
In the following three paragraphs, a "patent license" is any express agreement
442
+
or commitment, however denominated, not to enforce a patent (such as an express
443
+
permission to practice a patent or covenant not to s ue for patent infringement).
444
+
To "grant" such a patent license to a party means to make such an agreement
445
+
or commitment not to enforce a patent against the party.
446
+
447
+
If you convey a covered work, knowingly relying on a patent license, and the
448
+
Corresponding Source of the work is not available for anyone to copy, free
449
+
of charge and under the terms of this License, through a publicly available
450
+
network server or other readily accessible means, then you must either (1)
451
+
cause the Corresponding Source to be so available, or (2) arrange to deprive
452
+
yourself of the benefit of the patent license for this particular work, or
453
+
(3) arrange, in a manner consistent with the requirements of this License,
454
+
to extend the patent
455
+
456
+
license to downstream recipients. "Knowingly relying" means you have actual
457
+
knowledge that, but for the patent license, your conveying the covered work
458
+
in a country, or your recipient's use of the covered work in a country, would
459
+
infringe one or more identifiable patents in that country that you have reason
460
+
to believe are valid.
461
+
462
+
If, pursuant to or in connection with a single transaction or arrangement,
463
+
you convey, or propagate by procuring conveyance of, a covered work, and grant
464
+
a patent license to some of the parties receiving the covered work authorizing
465
+
them to use, propagate, modify or convey a specific copy of the covered work,
466
+
then the patent license you grant is automatically extended to all recipients
467
+
of the covered work and works based on it.
468
+
469
+
A patent license is "discriminatory" if it does not include within the scope
470
+
of its coverage, prohibits the exercise of, or is conditioned on the non-exercise
471
+
of one or more of the rights that are specifically granted under this License.
472
+
You may not convey a covered work if you are a party to an arrangement with
473
+
a third party that is in the business of distributing software, under which
474
+
you make payment to the third party based on the extent of your activity of
475
+
conveying the work, and under which the third party grants, to any of the
476
+
parties who would receive the covered work from you, a discriminatory patent
477
+
license (a) in connection with copies of the covered work conveyed by you
478
+
(or copies made from those copies), or (b) primarily for and in connection
479
+
with specific products or compilations that contain the covered work, unless
480
+
you entered into that arrangement, or that patent license was granted, prior
481
+
to 28 March 2007.
482
+
483
+
Nothing in this License shall be construed as excluding or limiting any implied
484
+
license or other defenses to infringement that may otherwise be available
485
+
to you under applicable patent law.
486
+
487
+
12. No Surrender of Others' Freedom.
488
+
489
+
If conditions are imposed on you (whether by court order, agreement or otherwise)
490
+
that contradict the conditions of this License, they do not excuse you from
491
+
the conditions of this License. If you cannot convey a covered work so as
492
+
to satisfy simultaneously your obligations under this License and any other
493
+
pertinent obligations, then as a consequence you may
494
+
495
+
not convey it at all. For example, if you agree to terms that obligate you
496
+
to collect a royalty for further conveying from those to whom you convey the
497
+
Program, the only way you could satisfy both those terms and this License
498
+
would be to refrain entirely from conveying the Program.
499
+
500
+
13. Remote Network Interaction; Use with the GNU General Public License.
501
+
502
+
Notwithstanding any other provision of this License, if you modify the Program,
503
+
your modified version must prominently offer all users interacting with it
504
+
remotely through a computer network (if your version supports such interaction)
505
+
an opportunity to receive the Corresponding Source of your version by providing
506
+
access to the Corresponding Source from a network server at no charge, through
507
+
some standard or customary means of facilitating copying of software. This
508
+
Corresponding Source shall include the Corresponding Source for any work covered
509
+
by version 3 of the GNU General Public License that is incorporated pursuant
510
+
to the following paragraph.
511
+
512
+
Notwithstanding any other provision of this License, you have permission to
513
+
link or combine any covered work with a work licensed under version 3 of the
514
+
GNU General Public License into a single combined work, and to convey the
515
+
resulting work. The terms of this License will continue to apply to the part
516
+
which is the covered work, but the work with which it is combined will remain
517
+
governed by version 3 of the GNU General Public License.
518
+
519
+
14. Revised Versions of this License.
520
+
521
+
The Free Software Foundation may publish revised and/or new versions of the
522
+
GNU Affero General Public License from time to time. Such new versions will
523
+
be similar in spirit to the present version, but may differ in detail to address
524
+
new problems or concerns.
525
+
526
+
Each version is given a distinguishing version number. If the Program specifies
527
+
that a certain numbered version of the GNU Affero General Public License "or
528
+
any later version" applies to it, you have the option of following the terms
529
+
and conditions either of that numbered version or of any later version published
530
+
by the Free Software Foundation. If the Program does not specify a version
531
+
number of the GNU Affero General Public License, you may choose any version
532
+
ever published by the Free Software Foundation.
533
+
534
+
If the Program specifies that a proxy can decide which future versions of
535
+
the GNU Affero General Public License can be used, that proxy's public statement
536
+
of acceptance of a version permanently authorizes you to choose that version
537
+
for the Program.
538
+
539
+
Later license versions may give you additional or different permissions. However,
540
+
no additional obligations are imposed on any author or copyright holder as
541
+
a result of your choosing to follow a later version.
542
+
543
+
15. Disclaimer of Warranty.
544
+
545
+
THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE
546
+
LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR
547
+
OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER
548
+
EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
549
+
OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS
550
+
TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM
551
+
PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR
552
+
CORRECTION.
553
+
554
+
16. Limitation of Liability.
555
+
556
+
IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING WILL
557
+
ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS THE PROGRAM
558
+
AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY GENERAL, SPECIAL,
559
+
INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE USE OR INABILITY TO
560
+
USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR DATA BEING RENDERED
561
+
INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD PARTIES OR A FAILURE OF THE
562
+
PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS), EVEN IF SUCH HOLDER OR OTHER
563
+
PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
564
+
565
+
17. Interpretation of Sections 15 and 16.
566
+
567
+
If the disclaimer of warranty and limitation of liability provided above cannot
568
+
be given local legal effect according to their terms, reviewing courts shall
569
+
apply local law that most closely approximates an absolute waiver of all civil
570
+
liability in connection with the Program, unless a warranty or assumption
571
+
of liability accompanies a copy of the Program in return for a fee. END OF
572
+
TERMS AND CONDITIONS
573
+
574
+
How to Apply These Terms to Your New Programs
575
+
576
+
If you develop a new program, and you want it to be of the greatest possible
577
+
use to the public, the best way to achieve this is to make it free software
578
+
which everyone can redistribute and change under these terms.
579
+
580
+
To do so, attach the following notices to the program. It is safest to attach
581
+
them to the start of each source file to most effectively state the exclusion
582
+
of warranty; and each file should have at least the "copyright" line and a
583
+
pointer to where the full notice is found.
584
+
585
+
<one line to give the program's name and a brief idea of what it does.>
586
+
587
+
Copyright (C) <year> <name of author>
588
+
589
+
This program is free software: you can redistribute it and/or modify it under
590
+
the terms of the GNU Affero General Public License as published by the Free
591
+
Software Foundation, either version 3 of the License, or (at your option)
592
+
any later version.
593
+
594
+
This program is distributed in the hope that it will be useful, but WITHOUT
595
+
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
596
+
FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
597
+
details.
598
+
599
+
You should have received a copy of the GNU Affero General Public License along
600
+
with this program. If not, see <https://www.gnu.org/licenses/>.
601
+
602
+
Also add information on how to contact you by electronic and paper mail.
603
+
604
+
If your software can interact with users remotely through a computer network,
605
+
you should also make sure that it provides a way for users to get its source.
606
+
For example, if your program is a web application, its interface could display
607
+
a "Source" link that leads users to an archive of the code. There are many
608
+
ways you could offer source, and different solutions will be better for different
609
+
programs; see section 13 for the specific requirements.
610
+
611
+
You should also get your employer (if you work as a programmer) or school,
612
+
if any, to sign a "copyright disclaimer" for the program, if necessary. For
613
+
more information on this, and how to apply and follow the GNU AGPL, see <https://www.gnu.org/licenses/>.
+3
README.md
+3
README.md
+40
churros.go
+40
churros.go
···
1
+
package notella
2
+
3
+
import (
4
+
"fmt"
5
+
"github.com/SherClockHolmes/webpush-go"
6
+
"strings"
7
+
)
8
+
9
+
type ChurrosId struct {
10
+
Type string
11
+
LocalID string
12
+
}
13
+
14
+
func ParseChurrosId(churrosId string) (ChurrosId, error) {
15
+
parts := strings.Split(churrosId, ":")
16
+
if len(parts) != 2 {
17
+
return ChurrosId{}, fmt.Errorf("malformed churros global id: %q", churrosId)
18
+
}
19
+
20
+
return ChurrosId{
21
+
Type: parts[0],
22
+
LocalID: parts[1],
23
+
}, nil
24
+
}
25
+
26
+
// UnmarshalText implements the encoding.TextUnmarshaler interface for ChurrosId.
27
+
func (id ChurrosId) UnmarshalText(text []byte) (err error) {
28
+
s := string(text)
29
+
30
+
id, err = ParseChurrosId(s)
31
+
if err != nil {
32
+
return err
33
+
}
34
+
35
+
return nil
36
+
}
37
+
38
+
func notificationSubscriptionsOf(userUid string) []webpush.Subscription {
39
+
return []webpush.Subscription{}
40
+
}
+23
go.mod
+23
go.mod
···
1
+
module git.inpt.fr/churros/notella
2
+
3
+
go 1.23.2
4
+
5
+
require (
6
+
github.com/caarlos0/env/v11 v11.2.2
7
+
github.com/ewen-lbh/label-logger-go v0.0.0-20241011201023-2c63f6a50d58
8
+
)
9
+
10
+
require (
11
+
github.com/golang-jwt/jwt v3.2.2+incompatible // indirect
12
+
golang.org/x/crypto v0.9.0 // indirect
13
+
)
14
+
15
+
require (
16
+
github.com/SherClockHolmes/webpush-go v1.3.0
17
+
github.com/common-nighthawk/go-figure v0.0.0-20210622060536-734e95fb86be
18
+
github.com/gosuri/uilive v0.0.4 // indirect
19
+
github.com/gosuri/uiprogress v0.0.1 // indirect
20
+
github.com/mattn/go-isatty v0.0.20 // indirect
21
+
github.com/mitchellh/colorstring v0.0.0-20190213212951-d06e56a500db // indirect
22
+
golang.org/x/sys v0.8.0 // indirect
23
+
)
+56
go.sum
+56
go.sum
···
1
+
github.com/SherClockHolmes/webpush-go v1.3.0 h1:CAu3FvEE9QS4drc3iKNgpBWFfGqNthKlZhp5QpYnu6k=
2
+
github.com/SherClockHolmes/webpush-go v1.3.0/go.mod h1:AxRHmJuYwKGG1PVgYzToik1lphQvDnqFYDqimHvwhIw=
3
+
github.com/caarlos0/env/v11 v11.2.2 h1:95fApNrUyueipoZN/EhA8mMxiNxrBwDa+oAZrMWl3Kg=
4
+
github.com/caarlos0/env/v11 v11.2.2/go.mod h1:JBfcdeQiBoI3Zh1QRAWfe+tpiNTmDtcCj/hHHHMx0vc=
5
+
github.com/common-nighthawk/go-figure v0.0.0-20210622060536-734e95fb86be h1:J5BL2kskAlV9ckgEsNQXscjIaLiOYiZ75d4e94E6dcQ=
6
+
github.com/common-nighthawk/go-figure v0.0.0-20210622060536-734e95fb86be/go.mod h1:mk5IQ+Y0ZeO87b858TlA645sVcEcbiX6YqP98kt+7+w=
7
+
github.com/ewen-lbh/label-logger-go v0.0.0-20241011201023-2c63f6a50d58 h1:oS+iVtATEd6oi6vA0Zn8tWhL7K1KEyE5jS2u6K3I0cU=
8
+
github.com/ewen-lbh/label-logger-go v0.0.0-20241011201023-2c63f6a50d58/go.mod h1:ORVakjovWm+MfrGXmHBZAJvxNqYwAxdG3Sev8CXXChM=
9
+
github.com/golang-jwt/jwt v3.2.2+incompatible h1:IfV12K8xAKAnZqdXVzCZ+TOjboZ2keLg81eXfW3O+oY=
10
+
github.com/golang-jwt/jwt v3.2.2+incompatible/go.mod h1:8pz2t5EyA70fFQQSrl6XZXzqecmYZeUEB8OUGHkxJ+I=
11
+
github.com/gosuri/uilive v0.0.4 h1:hUEBpQDj8D8jXgtCdBu7sWsy5sbW/5GhuO8KBwJ2jyY=
12
+
github.com/gosuri/uilive v0.0.4/go.mod h1:V/epo5LjjlDE5RJUcqx8dbw+zc93y5Ya3yg8tfZ74VI=
13
+
github.com/gosuri/uiprogress v0.0.1 h1:0kpv/XY/qTmFWl/SkaJykZXrBBzwwadmW8fRb7RJSxw=
14
+
github.com/gosuri/uiprogress v0.0.1/go.mod h1:C1RTYn4Sc7iEyf6j8ft5dyoZ4212h8G1ol9QQluh5+0=
15
+
github.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=
16
+
github.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=
17
+
github.com/mitchellh/colorstring v0.0.0-20190213212951-d06e56a500db h1:62I3jR2EmQ4l5rM/4FEfDWcRD+abF5XlKShorW5LRoQ=
18
+
github.com/mitchellh/colorstring v0.0.0-20190213212951-d06e56a500db/go.mod h1:l0dey0ia/Uv7NcFFVbCLtqEBQbrT4OCwCSKTEv6enCw=
19
+
github.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY=
20
+
golang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=
21
+
golang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=
22
+
golang.org/x/crypto v0.9.0 h1:LF6fAI+IutBocDJ2OT0Q1g8plpYljMZ4+lty+dsqw3g=
23
+
golang.org/x/crypto v0.9.0/go.mod h1:yrmDGqONDYtNj3tH8X9dzUun2m2lzPa9ngI6/RUPGR0=
24
+
golang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4=
25
+
golang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs=
26
+
golang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=
27
+
golang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=
28
+
golang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug+ECip1KBveYUHfp+8e9klMJ9c=
29
+
golang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs=
30
+
golang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg=
31
+
golang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
32
+
golang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
33
+
golang.org/x/sync v0.1.0/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=
34
+
golang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=
35
+
golang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=
36
+
golang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
37
+
golang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
38
+
golang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
39
+
golang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
40
+
golang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
41
+
golang.org/x/sys v0.8.0 h1:EBmGv8NaZBZTWvrbjNoL6HVt+IVy3QDQpJs7VRIw3tU=
42
+
golang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=
43
+
golang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=
44
+
golang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=
45
+
golang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k=
46
+
golang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo=
47
+
golang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=
48
+
golang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=
49
+
golang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=
50
+
golang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=
51
+
golang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8=
52
+
golang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=
53
+
golang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=
54
+
golang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc=
55
+
golang.org/x/tools v0.6.0/go.mod h1:Xwgl3UAJ/d3gWutnCtw505GrjyAbvKui8lOU390QaIU=
56
+
golang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=
+17
jobs.go
+17
jobs.go
···
1
+
package notella
2
+
3
+
import "time"
4
+
5
+
type ScheduledJob struct {
6
+
ID string
7
+
When time.Time
8
+
ChurrosObjectId ChurrosId
9
+
}
10
+
11
+
func (job ScheduledJob) ShouldRun() bool {
12
+
return time.Now().After(job.When)
13
+
}
14
+
15
+
func (job ScheduledJob) Run() {
16
+
17
+
}
+27
scheduler.go
+27
scheduler.go
···
1
+
package notella
2
+
3
+
var schedules = make(map[string]ScheduledJob)
4
+
5
+
func (job ScheduledJob) Unschedule() {
6
+
delete(schedules, job.ID)
7
+
}
8
+
9
+
func (job ScheduledJob) Schedule() {
10
+
schedules[job.ID] = job
11
+
}
12
+
13
+
func (job ScheduledJob) IsScheduled() bool {
14
+
_, ok := schedules[job.ID]
15
+
return ok
16
+
}
17
+
18
+
// StartScheduler starts the scheduler loop, which runs forever
19
+
func StartScheduler() {
20
+
for {
21
+
for _, job := range schedules {
22
+
if job.ShouldRun() {
23
+
job.Run()
24
+
}
25
+
}
26
+
}
27
+
}
+49
server/main.go
+49
server/main.go
···
1
+
package main
2
+
3
+
import (
4
+
"fmt"
5
+
"net/http"
6
+
"time"
7
+
8
+
"git.inpt.fr/churros/notella"
9
+
"github.com/caarlos0/env/v11"
10
+
"github.com/common-nighthawk/go-figure"
11
+
ll "github.com/ewen-lbh/label-logger-go"
12
+
)
13
+
14
+
type Configuration struct {
15
+
Port int `env:"PORT" envDefault:"8080"`
16
+
ChurrosApiUrl string `env:"CHURROS_API_URL" envDefault:"http://localhost:4000/graphql"`
17
+
PollInterval int `env:"POLL_INTERVAL_MS" envDefault:"500"`
18
+
}
19
+
20
+
type PostScheduleRequest struct {
21
+
When time.Time `json:"when"`
22
+
Ressource notella.ChurrosId `json:"ressource"`
23
+
}
24
+
25
+
func main() {
26
+
figure.NewColorFigure("Notella", "", "yellow", true).Print()
27
+
fmt.Println()
28
+
29
+
config := Configuration{}
30
+
err := env.Parse(&config)
31
+
if err != nil {
32
+
ll.ErrorDisplay("could not load env variables", err)
33
+
}
34
+
35
+
ll.Info("Running with config ")
36
+
ll.Log("", "reset", "port: [bold]%d[reset]", config.Port)
37
+
ll.Log("", "reset", "Churros API URL: [bold]%s[reset]", config.ChurrosApiUrl)
38
+
ll.Log("", "reset", "Poll interval: [bold]%d[reset] ms", config.PollInterval)
39
+
fmt.Println()
40
+
41
+
http.HandleFunc("POST /schedule/{when}", func(w http.ResponseWriter, r *http.Request) {
42
+
43
+
})
44
+
45
+
ll.Info("starting scheduler")
46
+
go notella.StartScheduler()
47
+
ll.Info("starting server on port %d", config.Port)
48
+
http.ListenAndServe(fmt.Sprintf(":%d", config.Port), nil)
49
+
}