├── .eslintignore ├── .prettierignore ├── .gitignore ├── lib ├── index.d.ts └── index.js ├── .prettierrc.json ├── public ├── uv.png ├── favicon.ico ├── uv │ └── uv.config.js ├── error.js ├── register-sw.js ├── search.js ├── index.js ├── 404.html ├── index.css ├── index.html └── credits.html ├── .eslintrc.json ├── package.json ├── LICENSE └── README.md /.eslintignore: -------------------------------------------------------------------------------- 1 | dist -------------------------------------------------------------------------------- /.prettierignore: -------------------------------------------------------------------------------- 1 | dist -------------------------------------------------------------------------------- /.gitignore: -------------------------------------------------------------------------------- 1 | node_modules 2 | *.tgz 3 | -------------------------------------------------------------------------------- /lib/index.d.ts: -------------------------------------------------------------------------------- 1 | export const publicPath: string; 2 | -------------------------------------------------------------------------------- /.prettierrc.json: -------------------------------------------------------------------------------- 1 | { 2 | "useTabs": false, 3 | "singleQuote": false 4 | } 5 | -------------------------------------------------------------------------------- /public/uv.png: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/titaniumnetwork-dev/Ultraviolet-Static/HEAD/public/uv.png -------------------------------------------------------------------------------- /public/favicon.ico: -------------------------------------------------------------------------------- https://raw.githubusercontent.com/titaniumnetwork-dev/Ultraviolet-Static/HEAD/public/favicon.ico -------------------------------------------------------------------------------- /.eslintrc.json: -------------------------------------------------------------------------------- 1 | { 2 | "root": true, 3 | "parserOptions": { 4 | "ecmaVersion": "latest", 5 | "sourceType": "module" 6 | } 7 | } 8 | -------------------------------------------------------------------------------- /lib/index.js: -------------------------------------------------------------------------------- 1 | import { fileURLToPath } from "url"; 2 | 3 | export const publicPath = fileURLToPath(new URL("../public/", import.meta.url)); 4 | -------------------------------------------------------------------------------- /package.json: -------------------------------------------------------------------------------- 1 | { 2 | "name": "ultraviolet-static", 3 | "main": "lib/index.js", 4 | "version": "1.0.5", 5 | "type": "module", 6 | "files": [ 7 | "public", 8 | "lib" 9 | ], 10 | "devDependencies": { 11 | "eslint": "^8.23.0", 12 | "prettier": "^2.7.1" 13 | } 14 | } 15 | -------------------------------------------------------------------------------- /public/uv/uv.config.js: -------------------------------------------------------------------------------- 1 | // This file overwrites the stock UV config.js 2 | 3 | self.__uv$config = { 4 | prefix: "/uv/service/", 5 | encodeUrl: Ultraviolet.codec.xor.encode, 6 | decodeUrl: Ultraviolet.codec.xor.decode, 7 | handler: "/uv/uv.handler.js", 8 | client: "/uv/uv.client.js", 9 | bundle: "/uv/uv.bundle.js", 10 | config: "/uv/uv.config.js", 11 | sw: "/uv/uv.sw.js", 12 | }; 13 | -------------------------------------------------------------------------------- /public/error.js: -------------------------------------------------------------------------------- 1 | "use strict"; 2 | const error = document.getElementById("uv-error"); 3 | const errorCode = document.getElementById("uv-error-code"); 4 | const registerButton = document.getElementById("uv-register-sw"); 5 | 6 | if (location.pathname.startsWith(__uv$config.prefix)) { 7 | error.textContent = "Error: The service worker is not registered."; 8 | registerButton.classList.add("show"); 9 | } 10 | 11 | registerButton.addEventListener("click", async () => { 12 | try { 13 | await registerSW(); 14 | location.reload(); 15 | } catch (err) { 16 | error.textContent = "Failed to register service worker."; 17 | errorCode.textContent = err.toString(); 18 | registerButton.classList.remove("show"); 19 | } 20 | }); 21 | -------------------------------------------------------------------------------- /public/register-sw.js: -------------------------------------------------------------------------------- 1 | "use strict"; 2 | /** 3 | * Distributed with Ultraviolet and compatible with most configurations. 4 | */ 5 | const stockSW = "/uv/sw.js"; 6 | 7 | /** 8 | * List of hostnames that are allowed to run serviceworkers on http:// 9 | */ 10 | const swAllowedHostnames = ["localhost", "127.0.0.1"]; 11 | 12 | /** 13 | * Global util 14 | * Used in 404.html and index.html 15 | */ 16 | async function registerSW() { 17 | if (!navigator.serviceWorker) { 18 | if ( 19 | location.protocol !== "https:" && 20 | !swAllowedHostnames.includes(location.hostname) 21 | ) 22 | throw new Error("Service workers cannot be registered without https."); 23 | 24 | throw new Error("Your browser doesn't support service workers."); 25 | } 26 | 27 | await navigator.serviceWorker.register(stockSW); 28 | } 29 | -------------------------------------------------------------------------------- /public/search.js: -------------------------------------------------------------------------------- 1 | "use strict"; 2 | /** 3 | * 4 | * @param {string} input 5 | * @param {string} template Template for a search query. 6 | * @returns {string} Fully qualified URL 7 | */ 8 | function search(input, template) { 9 | try { 10 | // input is a valid URL: 11 | // eg: https://example.com, https://example.com/test?q=param 12 | return new URL(input).toString(); 13 | } catch (err) { 14 | // input was not a valid URL 15 | } 16 | 17 | try { 18 | // input is a valid URL when http:// is added to the start: 19 | // eg: example.com, https://example.com/test?q=param 20 | const url = new URL(`http://${input}`); 21 | // only if the hostname has a TLD/subdomain 22 | if (url.hostname.includes(".")) return url.toString(); 23 | } catch (err) { 24 | // input was not valid URL 25 | } 26 | 27 | // input may have been a valid URL, however the hostname was invalid 28 | 29 | // Attempts to convert the input to a fully qualified URL have failed 30 | // Treat the input as a search query 31 | return template.replace("%s", encodeURIComponent(input)); 32 | } 33 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2022 Titanium Network 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /public/index.js: -------------------------------------------------------------------------------- 1 | "use strict"; 2 | /** 3 | * @type {HTMLFormElement} 4 | */ 5 | const form = document.getElementById("uv-form"); 6 | /** 7 | * @type {HTMLInputElement} 8 | */ 9 | const address = document.getElementById("uv-address"); 10 | /** 11 | * @type {HTMLInputElement} 12 | */ 13 | const searchEngine = document.getElementById("uv-search-engine"); 14 | /** 15 | * @type {HTMLParagraphElement} 16 | */ 17 | const error = document.getElementById("uv-error"); 18 | /** 19 | * @type {HTMLPreElement} 20 | */ 21 | const errorCode = document.getElementById("uv-error-code"); 22 | const connection = new BareMux.BareMuxConnection("/baremux/worker.js") 23 | 24 | form.addEventListener("submit", async (event) => { 25 | event.preventDefault(); 26 | 27 | try { 28 | await registerSW(); 29 | } catch (err) { 30 | error.textContent = "Failed to register service worker."; 31 | errorCode.textContent = err.toString(); 32 | throw err; 33 | } 34 | 35 | const url = search(address.value, searchEngine.value); 36 | 37 | let frame = document.getElementById("uv-frame"); 38 | frame.style.display = "block"; 39 | let wispUrl = (location.protocol === "https:" ? "wss" : "ws") + "://" + location.host + "/wisp/"; 40 | if (await connection.getTransport() !== "/epoxy/index.mjs") { 41 | await connection.setTransport("/epoxy/index.mjs", [{ wisp: wispUrl }]); 42 | } 43 | frame.src = __uv$config.prefix + __uv$config.encodeUrl(url); 44 | }); 45 | -------------------------------------------------------------------------------- /README.md: -------------------------------------------------------------------------------- 1 |

2 | 3 |

Ultraviolet-Static

4 | 5 | Static files/assets used to spin up an Ultraviolet website. 6 | 7 | ## Install in [Ultraviolet-App](https://github.com/titaniumnetwork-dev/Ultraviolet-App.git) 8 | 9 | See [Ultraviolet-App's Wiki](https://github.com/titaniumnetwork-dev/Ultraviolet-App/wiki/Customizing-your-frontend). 10 | 11 | ## Usage outside of Ultraviolet-App/Static hosting 12 | 13 | ### Ultraviolet scripts 14 | 15 | This repository doesn't serve any Ultraviolet scripts. It has a `uv.config.js` to show how Ultraviolet is intended to work with this demo. Ultraviolet-App automatically merges our `uv.config.js` with the remaining UV scripts (`uv.sw.js`, `uv.client.js`, etc). **Some work has to be done in order to make this repository standalone.** 16 | 17 | Here's how to get the remaining scripts for the purpose of hosting this repository: 18 | 19 | 1. Go to the [Ultraviolet releases](https://github.com/titaniumnetwork-dev/Ultraviolet/releases/) 20 | 2. Find the latest release 21 | 3. Download the latest tarball (eg. `titaniumnetwork-dev-ultraviolet-x.x.x.tgz`) 22 | 4. Open the tarball, navigate to the `dist` directory, and extract all the scripts with the exception of `uv.config.js` (we already have a configuration) into the `public/uv/` directory in this repository. 23 | You may see `.map` files. These are used for debugging. If they're too large, you can omit them without any errors. 24 | 25 | Do not copy `uv.config.js` from the archive! 26 | 27 | -------------------------------------------------------------------------------- /public/404.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 9 | Ultraviolet | Error 10 | 14 | 19 | 20 | 21 | 22 | 23 | 24 | 25 | 26 |
27 |

Ultraviolet | Error

28 |
29 |
30 |

The server could not route your request.

31 |

32 | 33 | 36 |
37 | 46 | 47 | 48 | 49 | 50 | 51 | 52 | -------------------------------------------------------------------------------- /public/index.css: -------------------------------------------------------------------------------- 1 | @import url("https://fonts.googleapis.com/css2?family=Roboto:ital,wght@0,300;0,400;0,500;1,300;1,400&display=swap"); 2 | 3 | body { 4 | font-family: "Roboto", Arial, Helvetica, sans-serif; 5 | margin: 0; 6 | background: #111; 7 | display: flex; 8 | flex-direction: column; 9 | min-height: 100vh; 10 | } 11 | 12 | .fa-magnifying-glass { 13 | color: white; 14 | } 15 | 16 | .flex-center { 17 | display: flex; 18 | justify-content: center; 19 | } 20 | 21 | .header-center { 22 | align-items: center; 23 | flex-direction: column; 24 | margin-top: 10%; 25 | } 26 | 27 | .left-margin { 28 | margin: 0px 16px; 29 | } 30 | 31 | #uv-frame { 32 | border: none; 33 | position: absolute; 34 | top: 0; 35 | left: 0; 36 | width: 100vw; 37 | height: 100vh; 38 | background-color: #111; 39 | } 40 | 41 | #uv-error { 42 | color: #ff6666 !important; 43 | white-space: pre-wrap; 44 | } 45 | 46 | #uv-error-code { 47 | font-size: 12px; 48 | color: #fff; 49 | font-family: "Courier New", Courier, monospace; 50 | } 51 | 52 | #uv-register-sw { 53 | color: white; 54 | background: #555555; 55 | cursor: pointer; 56 | outline: none; 57 | border: none; 58 | border-radius: 6px; 59 | padding: 16px 20px; 60 | line-height: 16px; 61 | display: none; 62 | } 63 | 64 | #uv-register-sw:active { 65 | background: #333333; 66 | } 67 | 68 | #uv-register-sw.show { 69 | display: block; 70 | } 71 | 72 | .logo { 73 | width: 150px; 74 | height: 150px; 75 | } 76 | 77 | .logo-wrapper .text { 78 | font-size: 75px; 79 | color: #fff; 80 | } 81 | 82 | .logo-wrapper h1 { 83 | color: white; 84 | } 85 | 86 | footer { 87 | margin: 0 5vw; 88 | margin-top: auto; 89 | display: flex; 90 | flex-direction: column; 91 | line-height: 30px; 92 | margin-bottom: 20px; 93 | } 94 | 95 | footer > div { 96 | display: flex; 97 | justify-content: left; 98 | align-items: center; 99 | flex-wrap: wrap; 100 | margin-bottom: 15px; 101 | } 102 | 103 | footer a, 104 | footer span { 105 | margin: 0 15px; 106 | text-decoration: none; 107 | color: #fff; 108 | font-size: 15px; 109 | } 110 | 111 | footer a { 112 | cursor: pointer; 113 | } 114 | 115 | footer a:hover { 116 | text-decoration: underline; 117 | } 118 | 119 | .desc p { 120 | width: 560px; 121 | color: rgba(253, 253, 253, 0.514); 122 | } 123 | 124 | #uv-address { 125 | background: none; 126 | font-family: inherit; 127 | padding: 0px 17px; 128 | height: 48px; 129 | border: 1px solid rgb(255, 255, 255, 0.2); 130 | color: var(--text-color); 131 | border-radius: 3px; 132 | outline: none; 133 | width: 350px; 134 | margin-top: 5px; 135 | border-radius: 50px; 136 | color: #fff; 137 | transition: border-radius 0.1s; 138 | } 139 | 140 | #uv-address:focus { 141 | border: 1px solid rgba(253, 253, 253, 0.514); 142 | border-radius: 6px; 143 | } 144 | 145 | .credit { 146 | border-radius: 10px; 147 | padding: 10px; 148 | display: block; 149 | border: #fff 1px solid; 150 | color: #fff; 151 | display: flex; 152 | flex-wrap: wrap; 153 | margin-bottom: 15px; 154 | } 155 | 156 | .credit label { 157 | margin-left: auto; 158 | margin-right: 15px; 159 | } 160 | 161 | .credit a, 162 | .credit label { 163 | color: white; 164 | text-decoration: underline; 165 | text-align: right; 166 | } 167 | 168 | .credit pre { 169 | display: none; 170 | width: 100%; 171 | } 172 | 173 | .credit label::after { 174 | content: "show license"; 175 | cursor: pointer; 176 | } 177 | 178 | .credit input:checked + label::after { 179 | content: "hide license"; 180 | } 181 | 182 | .credit input:checked ~ pre { 183 | display: block; 184 | } 185 | -------------------------------------------------------------------------------- /public/index.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 9 | Ultraviolet | Sophisticated Web Proxy 10 | 14 | 18 | 23 | 24 | 25 | 26 | 27 | 28 | 29 | 30 | 31 | 32 | 33 | 65 | 66 | 67 | 68 |
72 | 73 |

Ultraviolet | TN

74 |
75 |
76 |

77 | Ultraviolet is highly sophisticated proxy used for evading internet 78 | censorship. 79 |

80 |
81 | 82 |
83 | 88 | 89 |
90 |
91 |

92 |

 93 |     
94 | 120 | 121 | 122 | 123 | -------------------------------------------------------------------------------- /public/credits.html: -------------------------------------------------------------------------------- 1 | 2 | 3 | 4 | 5 | 9 | Ultraviolet | Licenses 10 | 14 | 18 | 23 | 24 | 25 | 26 | 27 | 28 | 29 |
30 |

Ultraviolet | Credits

31 |
32 |
33 |
34 | Ultraviolet-App 35 | 36 | 37 | homepage 40 |
 41 | MIT License
 42 | 
 43 | Copyright (c) 2022 Titanium Network
 44 | 
 45 | Permission is hereby granted, free of charge, to any person obtaining a copy
 46 | of this software and associated documentation files (the "Software"), to deal
 47 | in the Software without restriction, including without limitation the rights
 48 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 49 | copies of the Software, and to permit persons to whom the Software is
 50 | furnished to do so, subject to the following conditions:
 51 | 
 52 | The above copyright notice and this permission notice shall be included in all
 53 | copies or substantial portions of the Software.
 54 | 
 55 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 56 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 57 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 58 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 59 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 60 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 61 | SOFTWARE.
63 |
64 |
65 | Ultraviolet 66 | 67 | 68 | homepage 71 |
 72 |                     GNU AFFERO GENERAL PUBLIC LICENSE
 73 |                        Version 3, 19 November 2007
 74 | 
 75 |  Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
 76 |  Everyone is permitted to copy and distribute verbatim copies
 77 |  of this license document, but changing it is not allowed.
 78 | 
 79 |                             Preamble
 80 | 
 81 |   The GNU Affero General Public License is a free, copyleft license for
 82 | software and other kinds of works, specifically designed to ensure
 83 | cooperation with the community in the case of network server software.
 84 | 
 85 |   The licenses for most software and other practical works are designed
 86 | to take away your freedom to share and change the works.  By contrast,
 87 | our General Public Licenses are intended to guarantee your freedom to
 88 | share and change all versions of a program--to make sure it remains free
 89 | software for all its users.
 90 | 
 91 |   When we speak of free software, we are referring to freedom, not
 92 | price.  Our General Public Licenses are designed to make sure that you
 93 | have the freedom to distribute copies of free software (and charge for
 94 | them if you wish), that you receive source code or can get it if you
 95 | want it, that you can change the software or use pieces of it in new
 96 | free programs, and that you know you can do these things.
 97 | 
 98 |   Developers that use our General Public Licenses protect your rights
 99 | with two steps: (1) assert copyright on the software, and (2) offer
100 | you this License which gives you legal permission to copy, distribute
101 | and/or modify the software.
102 | 
103 |   A secondary benefit of defending all users' freedom is that
104 | improvements made in alternate versions of the program, if they
105 | receive widespread use, become available for other developers to
106 | incorporate.  Many developers of free software are heartened and
107 | encouraged by the resulting cooperation.  However, in the case of
108 | software used on network servers, this result may fail to come about.
109 | The GNU General Public License permits making a modified version and
110 | letting the public access it on a server without ever releasing its
111 | source code to the public.
112 | 
113 |   The GNU Affero General Public License is designed specifically to
114 | ensure that, in such cases, the modified source code becomes available
115 | to the community.  It requires the operator of a network server to
116 | provide the source code of the modified version running there to the
117 | users of that server.  Therefore, public use of a modified version, on
118 | a publicly accessible server, gives the public access to the source
119 | code of the modified version.
120 | 
121 |   An older license, called the Affero General Public License and
122 | published by Affero, was designed to accomplish similar goals.  This is
123 | a different license, not a version of the Affero GPL, but Affero has
124 | released a new version of the Affero GPL which permits relicensing under
125 | this license.
126 | 
127 |   The precise terms and conditions for copying, distribution and
128 | modification follow.
129 | 
130 |                        TERMS AND CONDITIONS
131 | 
132 |   0. Definitions.
133 | 
134 |   "This License" refers to version 3 of the GNU Affero General Public License.
135 | 
136 |   "Copyright" also means copyright-like laws that apply to other kinds of
137 | works, such as semiconductor masks.
138 | 
139 |   "The Program" refers to any copyrightable work licensed under this
140 | License.  Each licensee is addressed as "you".  "Licensees" and
141 | "recipients" may be individuals or organizations.
142 | 
143 |   To "modify" a work means to copy from or adapt all or part of the work
144 | in a fashion requiring copyright permission, other than the making of an
145 | exact copy.  The resulting work is called a "modified version" of the
146 | earlier work or a work "based on" the earlier work.
147 | 
148 |   A "covered work" means either the unmodified Program or a work based
149 | on the Program.
150 | 
151 |   To "propagate" a work means to do anything with it that, without
152 | permission, would make you directly or secondarily liable for
153 | infringement under applicable copyright law, except executing it on a
154 | computer or modifying a private copy.  Propagation includes copying,
155 | distribution (with or without modification), making available to the
156 | public, and in some countries other activities as well.
157 | 
158 |   To "convey" a work means any kind of propagation that enables other
159 | parties to make or receive copies.  Mere interaction with a user through
160 | a computer network, with no transfer of a copy, is not conveying.
161 | 
162 |   An interactive user interface displays "Appropriate Legal Notices"
163 | to the extent that it includes a convenient and prominently visible
164 | feature that (1) displays an appropriate copyright notice, and (2)
165 | tells the user that there is no warranty for the work (except to the
166 | extent that warranties are provided), that licensees may convey the
167 | work under this License, and how to view a copy of this License.  If
168 | the interface presents a list of user commands or options, such as a
169 | menu, a prominent item in the list meets this criterion.
170 | 
171 |   1. Source Code.
172 | 
173 |   The "source code" for a work means the preferred form of the work
174 | for making modifications to it.  "Object code" means any non-source
175 | form of a work.
176 | 
177 |   A "Standard Interface" means an interface that either is an official
178 | standard defined by a recognized standards body, or, in the case of
179 | interfaces specified for a particular programming language, one that
180 | is widely used among developers working in that language.
181 | 
182 |   The "System Libraries" of an executable work include anything, other
183 | than the work as a whole, that (a) is included in the normal form of
184 | packaging a Major Component, but which is not part of that Major
185 | Component, and (b) serves only to enable use of the work with that
186 | Major Component, or to implement a Standard Interface for which an
187 | implementation is available to the public in source code form.  A
188 | "Major Component", in this context, means a major essential component
189 | (kernel, window system, and so on) of the specific operating system
190 | (if any) on which the executable work runs, or a compiler used to
191 | produce the work, or an object code interpreter used to run it.
192 | 
193 |   The "Corresponding Source" for a work in object code form means all
194 | the source code needed to generate, install, and (for an executable
195 | work) run the object code and to modify the work, including scripts to
196 | control those activities.  However, it does not include the work's
197 | System Libraries, or general-purpose tools or generally available free
198 | programs which are used unmodified in performing those activities but
199 | which are not part of the work.  For example, Corresponding Source
200 | includes interface definition files associated with source files for
201 | the work, and the source code for shared libraries and dynamically
202 | linked subprograms that the work is specifically designed to require,
203 | such as by intimate data communication or control flow between those
204 | subprograms and other parts of the work.
205 | 
206 |   The Corresponding Source need not include anything that users
207 | can regenerate automatically from other parts of the Corresponding
208 | Source.
209 | 
210 |   The Corresponding Source for a work in source code form is that
211 | same work.
212 | 
213 |   2. Basic Permissions.
214 | 
215 |   All rights granted under this License are granted for the term of
216 | copyright on the Program, and are irrevocable provided the stated
217 | conditions are met.  This License explicitly affirms your unlimited
218 | permission to run the unmodified Program.  The output from running a
219 | covered work is covered by this License only if the output, given its
220 | content, constitutes a covered work.  This License acknowledges your
221 | rights of fair use or other equivalent, as provided by copyright law.
222 | 
223 |   You may make, run and propagate covered works that you do not
224 | convey, without conditions so long as your license otherwise remains
225 | in force.  You may convey covered works to others for the sole purpose
226 | of having them make modifications exclusively for you, or provide you
227 | with facilities for running those works, provided that you comply with
228 | the terms of this License in conveying all material for which you do
229 | not control copyright.  Those thus making or running the covered works
230 | for you must do so exclusively on your behalf, under your direction
231 | and control, on terms that prohibit them from making any copies of
232 | your copyrighted material outside their relationship with you.
233 | 
234 |   Conveying under any other circumstances is permitted solely under
235 | the conditions stated below.  Sublicensing is not allowed; section 10
236 | makes it unnecessary.
237 | 
238 |   3. Protecting Users' Legal Rights From Anti-Circumvention Law.
239 | 
240 |   No covered work shall be deemed part of an effective technological
241 | measure under any applicable law fulfilling obligations under article
242 | 11 of the WIPO copyright treaty adopted on 20 December 1996, or
243 | similar laws prohibiting or restricting circumvention of such
244 | measures.
245 | 
246 |   When you convey a covered work, you waive any legal power to forbid
247 | circumvention of technological measures to the extent such circumvention
248 | is effected by exercising rights under this License with respect to
249 | the covered work, and you disclaim any intention to limit operation or
250 | modification of the work as a means of enforcing, against the work's
251 | users, your or third parties' legal rights to forbid circumvention of
252 | technological measures.
253 | 
254 |   4. Conveying Verbatim Copies.
255 | 
256 |   You may convey verbatim copies of the Program's source code as you
257 | receive it, in any medium, provided that you conspicuously and
258 | appropriately publish on each copy an appropriate copyright notice;
259 | keep intact all notices stating that this License and any
260 | non-permissive terms added in accord with section 7 apply to the code;
261 | keep intact all notices of the absence of any warranty; and give all
262 | recipients a copy of this License along with the Program.
263 | 
264 |   You may charge any price or no price for each copy that you convey,
265 | and you may offer support or warranty protection for a fee.
266 | 
267 |   5. Conveying Modified Source Versions.
268 | 
269 |   You may convey a work based on the Program, or the modifications to
270 | produce it from the Program, in the form of source code under the
271 | terms of section 4, provided that you also meet all of these conditions:
272 | 
273 |     a) The work must carry prominent notices stating that you modified
274 |     it, and giving a relevant date.
275 | 
276 |     b) The work must carry prominent notices stating that it is
277 |     released under this License and any conditions added under section
278 |     7.  This requirement modifies the requirement in section 4 to
279 |     "keep intact all notices".
280 | 
281 |     c) You must license the entire work, as a whole, under this
282 |     License to anyone who comes into possession of a copy.  This
283 |     License will therefore apply, along with any applicable section 7
284 |     additional terms, to the whole of the work, and all its parts,
285 |     regardless of how they are packaged.  This License gives no
286 |     permission to license the work in any other way, but it does not
287 |     invalidate such permission if you have separately received it.
288 | 
289 |     d) If the work has interactive user interfaces, each must display
290 |     Appropriate Legal Notices; however, if the Program has interactive
291 |     interfaces that do not display Appropriate Legal Notices, your
292 |     work need not make them do so.
293 | 
294 |   A compilation of a covered work with other separate and independent
295 | works, which are not by their nature extensions of the covered work,
296 | and which are not combined with it such as to form a larger program,
297 | in or on a volume of a storage or distribution medium, is called an
298 | "aggregate" if the compilation and its resulting copyright are not
299 | used to limit the access or legal rights of the compilation's users
300 | beyond what the individual works permit.  Inclusion of a covered work
301 | in an aggregate does not cause this License to apply to the other
302 | parts of the aggregate.
303 | 
304 |   6. Conveying Non-Source Forms.
305 | 
306 |   You may convey a covered work in object code form under the terms
307 | of sections 4 and 5, provided that you also convey the
308 | machine-readable Corresponding Source under the terms of this License,
309 | in one of these ways:
310 | 
311 |     a) Convey the object code in, or embodied in, a physical product
312 |     (including a physical distribution medium), accompanied by the
313 |     Corresponding Source fixed on a durable physical medium
314 |     customarily used for software interchange.
315 | 
316 |     b) Convey the object code in, or embodied in, a physical product
317 |     (including a physical distribution medium), accompanied by a
318 |     written offer, valid for at least three years and valid for as
319 |     long as you offer spare parts or customer support for that product
320 |     model, to give anyone who possesses the object code either (1) a
321 |     copy of the Corresponding Source for all the software in the
322 |     product that is covered by this License, on a durable physical
323 |     medium customarily used for software interchange, for a price no
324 |     more than your reasonable cost of physically performing this
325 |     conveying of source, or (2) access to copy the
326 |     Corresponding Source from a network server at no charge.
327 | 
328 |     c) Convey individual copies of the object code with a copy of the
329 |     written offer to provide the Corresponding Source.  This
330 |     alternative is allowed only occasionally and noncommercially, and
331 |     only if you received the object code with such an offer, in accord
332 |     with subsection 6b.
333 | 
334 |     d) Convey the object code by offering access from a designated
335 |     place (gratis or for a charge), and offer equivalent access to the
336 |     Corresponding Source in the same way through the same place at no
337 |     further charge.  You need not require recipients to copy the
338 |     Corresponding Source along with the object code.  If the place to
339 |     copy the object code is a network server, the Corresponding Source
340 |     may be on a different server (operated by you or a third party)
341 |     that supports equivalent copying facilities, provided you maintain
342 |     clear directions next to the object code saying where to find the
343 |     Corresponding Source.  Regardless of what server hosts the
344 |     Corresponding Source, you remain obligated to ensure that it is
345 |     available for as long as needed to satisfy these requirements.
346 | 
347 |     e) Convey the object code using peer-to-peer transmission, provided
348 |     you inform other peers where the object code and Corresponding
349 |     Source of the work are being offered to the general public at no
350 |     charge under subsection 6d.
351 | 
352 |   A separable portion of the object code, whose source code is excluded
353 | from the Corresponding Source as a System Library, need not be
354 | included in conveying the object code work.
355 | 
356 |   A "User Product" is either (1) a "consumer product", which means any
357 | tangible personal property which is normally used for personal, family,
358 | or household purposes, or (2) anything designed or sold for incorporation
359 | into a dwelling.  In determining whether a product is a consumer product,
360 | doubtful cases shall be resolved in favor of coverage.  For a particular
361 | product received by a particular user, "normally used" refers to a
362 | typical or common use of that class of product, regardless of the status
363 | of the particular user or of the way in which the particular user
364 | actually uses, or expects or is expected to use, the product.  A product
365 | is a consumer product regardless of whether the product has substantial
366 | commercial, industrial or non-consumer uses, unless such uses represent
367 | the only significant mode of use of the product.
368 | 
369 |   "Installation Information" for a User Product means any methods,
370 | procedures, authorization keys, or other information required to install
371 | and execute modified versions of a covered work in that User Product from
372 | a modified version of its Corresponding Source.  The information must
373 | suffice to ensure that the continued functioning of the modified object
374 | code is in no case prevented or interfered with solely because
375 | modification has been made.
376 | 
377 |   If you convey an object code work under this section in, or with, or
378 | specifically for use in, a User Product, and the conveying occurs as
379 | part of a transaction in which the right of possession and use of the
380 | User Product is transferred to the recipient in perpetuity or for a
381 | fixed term (regardless of how the transaction is characterized), the
382 | Corresponding Source conveyed under this section must be accompanied
383 | by the Installation Information.  But this requirement does not apply
384 | if neither you nor any third party retains the ability to install
385 | modified object code on the User Product (for example, the work has
386 | been installed in ROM).
387 | 
388 |   The requirement to provide Installation Information does not include a
389 | requirement to continue to provide support service, warranty, or updates
390 | for a work that has been modified or installed by the recipient, or for
391 | the User Product in which it has been modified or installed.  Access to a
392 | network may be denied when the modification itself materially and
393 | adversely affects the operation of the network or violates the rules and
394 | protocols for communication across the network.
395 | 
396 |   Corresponding Source conveyed, and Installation Information provided,
397 | in accord with this section must be in a format that is publicly
398 | documented (and with an implementation available to the public in
399 | source code form), and must require no special password or key for
400 | unpacking, reading or copying.
401 | 
402 |   7. Additional Terms.
403 | 
404 |   "Additional permissions" are terms that supplement the terms of this
405 | License by making exceptions from one or more of its conditions.
406 | Additional permissions that are applicable to the entire Program shall
407 | be treated as though they were included in this License, to the extent
408 | that they are valid under applicable law.  If additional permissions
409 | apply only to part of the Program, that part may be used separately
410 | under those permissions, but the entire Program remains governed by
411 | this License without regard to the additional permissions.
412 | 
413 |   When you convey a copy of a covered work, you may at your option
414 | remove any additional permissions from that copy, or from any part of
415 | it.  (Additional permissions may be written to require their own
416 | removal in certain cases when you modify the work.)  You may place
417 | additional permissions on material, added by you to a covered work,
418 | for which you have or can give appropriate copyright permission.
419 | 
420 |   Notwithstanding any other provision of this License, for material you
421 | add to a covered work, you may (if authorized by the copyright holders of
422 | that material) supplement the terms of this License with terms:
423 | 
424 |     a) Disclaiming warranty or limiting liability differently from the
425 |     terms of sections 15 and 16 of this License; or
426 | 
427 |     b) Requiring preservation of specified reasonable legal notices or
428 |     author attributions in that material or in the Appropriate Legal
429 |     Notices displayed by works containing it; or
430 | 
431 |     c) Prohibiting misrepresentation of the origin of that material, or
432 |     requiring that modified versions of such material be marked in
433 |     reasonable ways as different from the original version; or
434 | 
435 |     d) Limiting the use for publicity purposes of names of licensors or
436 |     authors of the material; or
437 | 
438 |     e) Declining to grant rights under trademark law for use of some
439 |     trade names, trademarks, or service marks; or
440 | 
441 |     f) Requiring indemnification of licensors and authors of that
442 |     material by anyone who conveys the material (or modified versions of
443 |     it) with contractual assumptions of liability to the recipient, for
444 |     any liability that these contractual assumptions directly impose on
445 |     those licensors and authors.
446 | 
447 |   All other non-permissive additional terms are considered "further
448 | restrictions" within the meaning of section 10.  If the Program as you
449 | received it, or any part of it, contains a notice stating that it is
450 | governed by this License along with a term that is a further
451 | restriction, you may remove that term.  If a license document contains
452 | a further restriction but permits relicensing or conveying under this
453 | License, you may add to a covered work material governed by the terms
454 | of that license document, provided that the further restriction does
455 | not survive such relicensing or conveying.
456 | 
457 |   If you add terms to a covered work in accord with this section, you
458 | must place, in the relevant source files, a statement of the
459 | additional terms that apply to those files, or a notice indicating
460 | where to find the applicable terms.
461 | 
462 |   Additional terms, permissive or non-permissive, may be stated in the
463 | form of a separately written license, or stated as exceptions;
464 | the above requirements apply either way.
465 | 
466 |   8. Termination.
467 | 
468 |   You may not propagate or modify a covered work except as expressly
469 | provided under this License.  Any attempt otherwise to propagate or
470 | modify it is void, and will automatically terminate your rights under
471 | this License (including any patent licenses granted under the third
472 | paragraph of section 11).
473 | 
474 |   However, if you cease all violation of this License, then your
475 | license from a particular copyright holder is reinstated (a)
476 | provisionally, unless and until the copyright holder explicitly and
477 | finally terminates your license, and (b) permanently, if the copyright
478 | holder fails to notify you of the violation by some reasonable means
479 | prior to 60 days after the cessation.
480 | 
481 |   Moreover, your license from a particular copyright holder is
482 | reinstated permanently if the copyright holder notifies you of the
483 | violation by some reasonable means, this is the first time you have
484 | received notice of violation of this License (for any work) from that
485 | copyright holder, and you cure the violation prior to 30 days after
486 | your receipt of the notice.
487 | 
488 |   Termination of your rights under this section does not terminate the
489 | licenses of parties who have received copies or rights from you under
490 | this License.  If your rights have been terminated and not permanently
491 | reinstated, you do not qualify to receive new licenses for the same
492 | material under section 10.
493 | 
494 |   9. Acceptance Not Required for Having Copies.
495 | 
496 |   You are not required to accept this License in order to receive or
497 | run a copy of the Program.  Ancillary propagation of a covered work
498 | occurring solely as a consequence of using peer-to-peer transmission
499 | to receive a copy likewise does not require acceptance.  However,
500 | nothing other than this License grants you permission to propagate or
501 | modify any covered work.  These actions infringe copyright if you do
502 | not accept this License.  Therefore, by modifying or propagating a
503 | covered work, you indicate your acceptance of this License to do so.
504 | 
505 |   10. Automatic Licensing of Downstream Recipients.
506 | 
507 |   Each time you convey a covered work, the recipient automatically
508 | receives a license from the original licensors, to run, modify and
509 | propagate that work, subject to this License.  You are not responsible
510 | for enforcing compliance by third parties with this License.
511 | 
512 |   An "entity transaction" is a transaction transferring control of an
513 | organization, or substantially all assets of one, or subdividing an
514 | organization, or merging organizations.  If propagation of a covered
515 | work results from an entity transaction, each party to that
516 | transaction who receives a copy of the work also receives whatever
517 | licenses to the work the party's predecessor in interest had or could
518 | give under the previous paragraph, plus a right to possession of the
519 | Corresponding Source of the work from the predecessor in interest, if
520 | the predecessor has it or can get it with reasonable efforts.
521 | 
522 |   You may not impose any further restrictions on the exercise of the
523 | rights granted or affirmed under this License.  For example, you may
524 | not impose a license fee, royalty, or other charge for exercise of
525 | rights granted under this License, and you may not initiate litigation
526 | (including a cross-claim or counterclaim in a lawsuit) alleging that
527 | any patent claim is infringed by making, using, selling, offering for
528 | sale, or importing the Program or any portion of it.
529 | 
530 |   11. Patents.
531 | 
532 |   A "contributor" is a copyright holder who authorizes use under this
533 | License of the Program or a work on which the Program is based.  The
534 | work thus licensed is called the contributor's "contributor version".
535 | 
536 |   A contributor's "essential patent claims" are all patent claims
537 | owned or controlled by the contributor, whether already acquired or
538 | hereafter acquired, that would be infringed by some manner, permitted
539 | by this License, of making, using, or selling its contributor version,
540 | but do not include claims that would be infringed only as a
541 | consequence of further modification of the contributor version.  For
542 | purposes of this definition, "control" includes the right to grant
543 | patent sublicenses in a manner consistent with the requirements of
544 | this License.
545 | 
546 |   Each contributor grants you a non-exclusive, worldwide, royalty-free
547 | patent license under the contributor's essential patent claims, to
548 | make, use, sell, offer for sale, import and otherwise run, modify and
549 | propagate the contents of its contributor version.
550 | 
551 |   In the following three paragraphs, a "patent license" is any express
552 | agreement or commitment, however denominated, not to enforce a patent
553 | (such as an express permission to practice a patent or covenant not to
554 | sue for patent infringement).  To "grant" such a patent license to a
555 | party means to make such an agreement or commitment not to enforce a
556 | patent against the party.
557 | 
558 |   If you convey a covered work, knowingly relying on a patent license,
559 | and the Corresponding Source of the work is not available for anyone
560 | to copy, free of charge and under the terms of this License, through a
561 | publicly available network server or other readily accessible means,
562 | then you must either (1) cause the Corresponding Source to be so
563 | available, or (2) arrange to deprive yourself of the benefit of the
564 | patent license for this particular work, or (3) arrange, in a manner
565 | consistent with the requirements of this License, to extend the patent
566 | license to downstream recipients.  "Knowingly relying" means you have
567 | actual knowledge that, but for the patent license, your conveying the
568 | covered work in a country, or your recipient's use of the covered work
569 | in a country, would infringe one or more identifiable patents in that
570 | country that you have reason to believe are valid.
571 | 
572 |   If, pursuant to or in connection with a single transaction or
573 | arrangement, you convey, or propagate by procuring conveyance of, a
574 | covered work, and grant a patent license to some of the parties
575 | receiving the covered work authorizing them to use, propagate, modify
576 | or convey a specific copy of the covered work, then the patent license
577 | you grant is automatically extended to all recipients of the covered
578 | work and works based on it.
579 | 
580 |   A patent license is "discriminatory" if it does not include within
581 | the scope of its coverage, prohibits the exercise of, or is
582 | conditioned on the non-exercise of one or more of the rights that are
583 | specifically granted under this License.  You may not convey a covered
584 | work if you are a party to an arrangement with a third party that is
585 | in the business of distributing software, under which you make payment
586 | to the third party based on the extent of your activity of conveying
587 | the work, and under which the third party grants, to any of the
588 | parties who would receive the covered work from you, a discriminatory
589 | patent license (a) in connection with copies of the covered work
590 | conveyed by you (or copies made from those copies), or (b) primarily
591 | for and in connection with specific products or compilations that
592 | contain the covered work, unless you entered into that arrangement,
593 | or that patent license was granted, prior to 28 March 2007.
594 | 
595 |   Nothing in this License shall be construed as excluding or limiting
596 | any implied license or other defenses to infringement that may
597 | otherwise be available to you under applicable patent law.
598 | 
599 |   12. No Surrender of Others' Freedom.
600 | 
601 |   If conditions are imposed on you (whether by court order, agreement or
602 | otherwise) that contradict the conditions of this License, they do not
603 | excuse you from the conditions of this License.  If you cannot convey a
604 | covered work so as to satisfy simultaneously your obligations under this
605 | License and any other pertinent obligations, then as a consequence you may
606 | not convey it at all.  For example, if you agree to terms that obligate you
607 | to collect a royalty for further conveying from those to whom you convey
608 | the Program, the only way you could satisfy both those terms and this
609 | License would be to refrain entirely from conveying the Program.
610 | 
611 |   13. Remote Network Interaction; Use with the GNU General Public License.
612 | 
613 |   Notwithstanding any other provision of this License, if you modify the
614 | Program, your modified version must prominently offer all users
615 | interacting with it remotely through a computer network (if your version
616 | supports such interaction) an opportunity to receive the Corresponding
617 | Source of your version by providing access to the Corresponding Source
618 | from a network server at no charge, through some standard or customary
619 | means of facilitating copying of software.  This Corresponding Source
620 | shall include the Corresponding Source for any work covered by version 3
621 | of the GNU General Public License that is incorporated pursuant to the
622 | following paragraph.
623 | 
624 |   Notwithstanding any other provision of this License, you have
625 | permission to link or combine any covered work with a work licensed
626 | under version 3 of the GNU General Public License into a single
627 | combined work, and to convey the resulting work.  The terms of this
628 | License will continue to apply to the part which is the covered work,
629 | but the work with which it is combined will remain governed by version
630 | 3 of the GNU General Public License.
631 | 
632 |   14. Revised Versions of this License.
633 | 
634 |   The Free Software Foundation may publish revised and/or new versions of
635 | the GNU Affero General Public License from time to time.  Such new versions
636 | will be similar in spirit to the present version, but may differ in detail to
637 | address new problems or concerns.
638 | 
639 |   Each version is given a distinguishing version number.  If the
640 | Program specifies that a certain numbered version of the GNU Affero General
641 | Public License "or any later version" applies to it, you have the
642 | option of following the terms and conditions either of that numbered
643 | version or of any later version published by the Free Software
644 | Foundation.  If the Program does not specify a version number of the
645 | GNU Affero General Public License, you may choose any version ever published
646 | by the Free Software Foundation.
647 | 
648 |   If the Program specifies that a proxy can decide which future
649 | versions of the GNU Affero General Public License can be used, that proxy's
650 | public statement of acceptance of a version permanently authorizes you
651 | to choose that version for the Program.
652 | 
653 |   Later license versions may give you additional or different
654 | permissions.  However, no additional obligations are imposed on any
655 | author or copyright holder as a result of your choosing to follow a
656 | later version.
657 | 
658 |   15. Disclaimer of Warranty.
659 | 
660 |   THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
661 | APPLICABLE LAW.  EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
662 | HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
663 | OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
664 | THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
665 | PURPOSE.  THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
666 | IS WITH YOU.  SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
667 | ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
668 | 
669 |   16. Limitation of Liability.
670 | 
671 |   IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
672 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
673 | THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
674 | GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
675 | USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
676 | DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
677 | PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
678 | EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
679 | SUCH DAMAGES.
680 | 
681 |   17. Interpretation of Sections 15 and 16.
682 | 
683 |   If the disclaimer of warranty and limitation of liability provided
684 | above cannot be given local legal effect according to their terms,
685 | reviewing courts shall apply local law that most closely approximates
686 | an absolute waiver of all civil liability in connection with the
687 | Program, unless a warranty or assumption of liability accompanies a
688 | copy of the Program in return for a fee.
689 | 
690 |                      END OF TERMS AND CONDITIONS
691 | 
692 |             How to Apply These Terms to Your New Programs
693 | 
694 |   If you develop a new program, and you want it to be of the greatest
695 | possible use to the public, the best way to achieve this is to make it
696 | free software which everyone can redistribute and change under these terms.
697 | 
698 |   To do so, attach the following notices to the program.  It is safest
699 | to attach them to the start of each source file to most effectively
700 | state the exclusion of warranty; and each file should have at least
701 | the "copyright" line and a pointer to where the full notice is found.
702 | 
703 |     <one line to give the program's name and a brief idea of what it does.>
704 |     Copyright (C) <year>  <name of author>
705 | 
706 |     This program is free software: you can redistribute it and/or modify
707 |     it under the terms of the GNU Affero General Public License as published
708 |     by the Free Software Foundation, either version 3 of the License, or
709 |     (at your option) any later version.
710 | 
711 |     This program is distributed in the hope that it will be useful,
712 |     but WITHOUT ANY WARRANTY; without even the implied warranty of
713 |     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
714 |     GNU Affero General Public License for more details.
715 | 
716 |     You should have received a copy of the GNU Affero General Public License
717 |     along with this program.  If not, see <https://www.gnu.org/licenses/>.
718 | 
719 | Also add information on how to contact you by electronic and paper mail.
720 | 
721 |   If your software can interact with users remotely through a computer
722 | network, you should also make sure that it provides a way for users to
723 | get its source.  For example, if your program is a web application, its
724 | interface could display a "Source" link that leads users to an archive
725 | of the code.  There are many ways you could offer source, and different
726 | solutions will be better for different programs; see section 13 for the
727 | specific requirements.
728 | 
729 |   You should also get your employer (if you work as a programmer) or school,
730 | if any, to sign a "copyright disclaimer" for the program, if necessary.
731 | For more information on this, and how to apply and follow the GNU AGPL, see
732 | <https://www.gnu.org/licenses/>.
734 |
735 |
736 | 737 | 738 | --------------------------------------------------------------------------------