local-devops-workbench 0.2.1__py3-none-any.whl
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- local_devops_workbench-0.2.1.dist-info/METADATA +281 -0
- local_devops_workbench-0.2.1.dist-info/RECORD +6 -0
- local_devops_workbench-0.2.1.dist-info/WHEEL +4 -0
- local_devops_workbench-0.2.1.dist-info/entry_points.txt +2 -0
- local_devops_workbench-0.2.1.dist-info/licenses/LICENSE +201 -0
- local_devops_workbench-0.2.1.dist-info/licenses/NOTICE +4 -0
|
@@ -0,0 +1,281 @@
|
|
|
1
|
+
Metadata-Version: 2.5
|
|
2
|
+
Name: local-devops-workbench
|
|
3
|
+
Version: 0.2.1
|
|
4
|
+
Summary: A safe local DevOps control plane for native, Compose, DDEV, Kubernetes, and OrbStack VM projects.
|
|
5
|
+
Project-URL: Homepage, https://github.com/openplanr/ldw
|
|
6
|
+
Project-URL: Documentation, https://github.com/openplanr/ldw/tree/main/docs
|
|
7
|
+
Project-URL: Issues, https://github.com/openplanr/ldw/issues
|
|
8
|
+
Project-URL: Source, https://github.com/openplanr/ldw
|
|
9
|
+
Author: AsemDevs
|
|
10
|
+
Maintainer: OpenPlanr
|
|
11
|
+
License-Expression: Apache-2.0
|
|
12
|
+
License-File: LICENSE
|
|
13
|
+
License-File: NOTICE
|
|
14
|
+
Keywords: ddev,developer-experience,devops,docker-compose,kind,orbstack,tilt
|
|
15
|
+
Classifier: Development Status :: 3 - Alpha
|
|
16
|
+
Classifier: Environment :: Console
|
|
17
|
+
Classifier: Intended Audience :: Developers
|
|
18
|
+
Classifier: License :: OSI Approved :: Apache Software License
|
|
19
|
+
Classifier: Operating System :: MacOS
|
|
20
|
+
Classifier: Operating System :: POSIX :: Linux
|
|
21
|
+
Classifier: Programming Language :: Python :: 3 :: Only
|
|
22
|
+
Classifier: Programming Language :: Python :: 3.12
|
|
23
|
+
Classifier: Programming Language :: Python :: 3.13
|
|
24
|
+
Classifier: Programming Language :: Python :: 3.14
|
|
25
|
+
Classifier: Topic :: Software Development :: Build Tools
|
|
26
|
+
Classifier: Topic :: System :: Systems Administration
|
|
27
|
+
Requires-Python: <3.15,>=3.12
|
|
28
|
+
Requires-Dist: ldw-agent==0.2.1
|
|
29
|
+
Requires-Dist: ldw-core==0.2.1
|
|
30
|
+
Requires-Dist: ldw-deploy==0.2.1
|
|
31
|
+
Requires-Dist: ldw-labs==0.2.1
|
|
32
|
+
Requires-Dist: ldw-observability==0.2.1
|
|
33
|
+
Requires-Dist: ldw-vm==0.2.1
|
|
34
|
+
Provides-Extra: ansible
|
|
35
|
+
Requires-Dist: ldw-vm[ansible]==0.2.1; extra == 'ansible'
|
|
36
|
+
Provides-Extra: dev
|
|
37
|
+
Requires-Dist: ldw-core[dev]==0.2.1; extra == 'dev'
|
|
38
|
+
Description-Content-Type: text/markdown
|
|
39
|
+
|
|
40
|
+
<p align="center">
|
|
41
|
+
<img src="docs/assets/readme-hero.svg" alt="Local DevOps Workbench — Your stack. One workbench. Discover and review with ldw init, preview with ldw plan, and start with ldw up." width="1000">
|
|
42
|
+
</p>
|
|
43
|
+
|
|
44
|
+
<h1 align="center">Local DevOps Workbench</h1>
|
|
45
|
+
|
|
46
|
+
<p align="center">
|
|
47
|
+
<strong>Evidence-based discovery → standard config you own.</strong>
|
|
48
|
+
</p>
|
|
49
|
+
|
|
50
|
+
<p align="center">
|
|
51
|
+
<a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-2563eb" alt="License: Apache 2.0"></a>
|
|
52
|
+
<a href="pyproject.toml"><img src="https://img.shields.io/badge/python-3.12%E2%80%933.14-2563eb" alt="Python 3.12–3.14"></a>
|
|
53
|
+
<a href="CHANGELOG.md"><img src="https://img.shields.io/badge/status-public_preview-e9a45c" alt="Status: public preview"></a>
|
|
54
|
+
</p>
|
|
55
|
+
|
|
56
|
+
<p align="center">
|
|
57
|
+
<a href="#quick-start">Quick start</a> ·
|
|
58
|
+
<a href="#what-you-can-do">Features</a> ·
|
|
59
|
+
<a href="#supported-workflows">Supported workflows</a> ·
|
|
60
|
+
<a href="docs/index.md">Documentation</a> ·
|
|
61
|
+
<a href="https://github.com/openplanr/ldw/actions/workflows/quality.yml">CI</a> ·
|
|
62
|
+
<a href="CONTRIBUTING.md">Contribute</a>
|
|
63
|
+
</p>
|
|
64
|
+
|
|
65
|
+
LDW discovers your repository from evidence and records the setup you approve. Run it with
|
|
66
|
+
`ldw up`, the managed path, or export a Tiltfile or mise tasks that you own and can run without
|
|
67
|
+
LDW. Coordinate native processes, Docker Compose, DDEV, and Kubernetes; add isolated VMs,
|
|
68
|
+
observability, backups, and SSH deployment when you need them.
|
|
69
|
+
|
|
70
|
+
**Keep your existing tools.** LDW works with your package scripts, Makefile, Compose files, and
|
|
71
|
+
DDEV configuration, adding a consistent lifecycle around them.
|
|
72
|
+
|
|
73
|
+
> **Public preview:** Install from source. APIs may change before `v1.0.0`.
|
|
74
|
+
|
|
75
|
+
## The everyday workflow
|
|
76
|
+
|
|
77
|
+
```bash
|
|
78
|
+
cd /path/to/your/project
|
|
79
|
+
|
|
80
|
+
ldw init . # Discover and review
|
|
81
|
+
ldw plan # Preview the run
|
|
82
|
+
ldw up # Start the accepted mode
|
|
83
|
+
|
|
84
|
+
# In another terminal:
|
|
85
|
+
ldw status # Health and endpoints
|
|
86
|
+
ldw logs api # Logs for your api resource
|
|
87
|
+
ldw down # Stop and preserve data
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
**Review once, run consistently.** Every `ldw up` uses the accepted manifest and lock;
|
|
91
|
+
it never rescans the repository or calls AI.
|
|
92
|
+
|
|
93
|
+
### Or export and leave
|
|
94
|
+
|
|
95
|
+
```bash
|
|
96
|
+
ldw export tiltfile # A standalone Tiltfile for `tilt up`
|
|
97
|
+
ldw export mise # mise tasks for `mise run dev`
|
|
98
|
+
ldw export tiltfile --check # Fail CI when the export is stale or edited
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
Exported files come from the same accepted manifest and list what they cannot do without LDW.
|
|
102
|
+
See [Export and eject](docs/how-to/export-and-eject.md) and
|
|
103
|
+
[Compared with other tools](docs/explanation/compared-with.md).
|
|
104
|
+
|
|
105
|
+
## What you can do
|
|
106
|
+
|
|
107
|
+
| Capability | What it gives you |
|
|
108
|
+
| --- | --- |
|
|
109
|
+
| **Discover an existing stack** | Find package scripts, workspaces, Compose, DDEV, Helm, ports, and required environment variable names, with evidence for each proposed resource. |
|
|
110
|
+
| **Use one daily workflow** | Plan, start, inspect, log, test, and stop linked projects through the same CLI. Select another declared mode when you need it. |
|
|
111
|
+
| **Run several projects** | Check fixed-port conflicts and acquire project locks before startup, with ownership tracking and bounded rollback. |
|
|
112
|
+
| **Keep integrations current** | Review changes, detect drift, apply plans atomically, and repair, upgrade, or remove files with proven ownership. |
|
|
113
|
+
| **Export standard config** | Generate a Tiltfile or mise tasks from the accepted manifest, check them in CI, or eject them to the team. |
|
|
114
|
+
| **Share a portable setup** | Commit the manifest and lock for your team, or integrate locally without changing the repository. |
|
|
115
|
+
| **Ask for optional AI analysis** | Let Codex or Claude Code propose a setup for ambiguous repositories through a consent-based, restricted analysis workflow. |
|
|
116
|
+
|
|
117
|
+
## Supported workflows
|
|
118
|
+
|
|
119
|
+
| Your project uses | LDW coordinates |
|
|
120
|
+
| --- | --- |
|
|
121
|
+
| **Native tools** | Existing package scripts, Make targets, and local application processes. |
|
|
122
|
+
| **Docker Compose** | Project-owned services, dependencies, logs, and container-retaining shutdown. |
|
|
123
|
+
| **DDEV** | The existing DDEV project and its service lifecycle. |
|
|
124
|
+
| **Native + containers** | Accepted infrastructure startup, provider health checks, then native applications. |
|
|
125
|
+
| **Kubernetes / kind** | Declared Helm charts, local images, namespaces, and resources in Workbench-owned kind contexts. |
|
|
126
|
+
| **OrbStack VMs** | Explicit machine creation, provisioning, deployment, health checks, and rollback on macOS. |
|
|
127
|
+
|
|
128
|
+
Select another declared mode with `ldw up my-project:kubernetes`.
|
|
129
|
+
[Kubernetes setup](docs/how-to/use-kubernetes.md) and
|
|
130
|
+
[VM operations](docs/how-to/use-orbstack-vms.md) are explicit; `ldw up` never creates a VM.
|
|
131
|
+
|
|
132
|
+
## Quick start
|
|
133
|
+
|
|
134
|
+
### 1. Install LDW
|
|
135
|
+
|
|
136
|
+
**Requirements:** macOS or Linux, Git, [uv](https://docs.astral.sh/uv/getting-started/installation/),
|
|
137
|
+
and your project's native tools. Python **3.12–3.14** is supported; the commands below install 3.12.
|
|
138
|
+
Container workflows need Docker Desktop, Docker Engine, or a supported compatible Docker context.
|
|
139
|
+
|
|
140
|
+
```bash
|
|
141
|
+
git clone https://github.com/openplanr/ldw.git
|
|
142
|
+
cd ldw
|
|
143
|
+
uv python install 3.12
|
|
144
|
+
uv tool install --force --python 3.12 .
|
|
145
|
+
uv tool update-shell
|
|
146
|
+
export PATH="$HOME/.local/bin:$PATH"
|
|
147
|
+
|
|
148
|
+
ldw bootstrap --apply
|
|
149
|
+
ldw doctor
|
|
150
|
+
```
|
|
151
|
+
|
|
152
|
+
`bootstrap --apply` installs Workbench tooling; `doctor` checks prerequisites.
|
|
153
|
+
This install includes every first-party plugin: VMs, SSH deployment, failure labs,
|
|
154
|
+
observability, and coding-agent analysis. Install `./packages/ldw-core` instead for the core
|
|
155
|
+
alone.
|
|
156
|
+
For a fresh Mac, follow the [complete installation guide](docs/how-to/install-on-a-new-mac.md).
|
|
157
|
+
|
|
158
|
+
<details>
|
|
159
|
+
<summary><strong>Optional: OrbStack VMs and Ansible-based labs</strong></summary>
|
|
160
|
+
|
|
161
|
+
Local VMs require OrbStack on macOS. From the LDW checkout, install the extra dependencies:
|
|
162
|
+
|
|
163
|
+
```bash
|
|
164
|
+
uv tool install --force --python 3.12 '.[ansible]'
|
|
165
|
+
```
|
|
166
|
+
|
|
167
|
+
Then follow the [VM guide](docs/how-to/use-orbstack-vms.md).
|
|
168
|
+
|
|
169
|
+
</details>
|
|
170
|
+
|
|
171
|
+
### 2. Connect your project
|
|
172
|
+
|
|
173
|
+
```bash
|
|
174
|
+
cd /path/to/your/project
|
|
175
|
+
ldw init .
|
|
176
|
+
```
|
|
177
|
+
|
|
178
|
+
Review the detected resources, commands, ports, and managed files. Accepting saves the setup,
|
|
179
|
+
links the project, and validates it. Discovery uses no AI by default.
|
|
180
|
+
Use `ldw init . --local-only` to keep the integration entirely on your machine.
|
|
181
|
+
|
|
182
|
+
Try the [Compose tutorial](docs/tutorials/quick-start.md) for a runnable frontend, API,
|
|
183
|
+
PostgreSQL, and Redis example.
|
|
184
|
+
|
|
185
|
+
### 3. Start developing
|
|
186
|
+
|
|
187
|
+
```bash
|
|
188
|
+
ldw plan
|
|
189
|
+
ldw up
|
|
190
|
+
```
|
|
191
|
+
|
|
192
|
+
If Docker is stopped, use `ldw runtime start` or `ldw up --start-runtime`.
|
|
193
|
+
Add `--wait` to require resource readiness, or `--no-ui` for CLI-only startup.
|
|
194
|
+
With Tilt available, `ldw up` provides an attached resource UI.
|
|
195
|
+
|
|
196
|
+
Press Ctrl-C in the attached session or run `ldw down` to stop it. Normal shutdown preserves data
|
|
197
|
+
and retains Compose containers. [Full lifecycle behavior](docs/reference/cli.md#runtime-planning-and-lifecycle).
|
|
198
|
+
|
|
199
|
+
<details>
|
|
200
|
+
<summary><strong>Automating onboarding or choosing a project identity?</strong></summary>
|
|
201
|
+
|
|
202
|
+
`ldw init . --json` returns a plan without applying it. Noninteractive plain `ldw init` leaves
|
|
203
|
+
the plan unapplied, prints the next command, and exits nonzero. Unresolved plans cannot be applied.
|
|
204
|
+
|
|
205
|
+
Use `--project-id my-project` for a stable identity; DDEV uses the accepted DDEV name.
|
|
206
|
+
See the [integration reference](docs/reference/integration.md) for resolve/apply commands.
|
|
207
|
+
|
|
208
|
+
</details>
|
|
209
|
+
|
|
210
|
+
## Go beyond startup
|
|
211
|
+
|
|
212
|
+
| When you need to… | Use |
|
|
213
|
+
| --- | --- |
|
|
214
|
+
| **See metrics, logs, and traces** | [Local observability](docs/how-to/use-observability.md) with Grafana, Prometheus, Loki, Tempo, and OpenTelemetry. |
|
|
215
|
+
| **Protect and restore project data** | [Checksummed backups and guarded resets](docs/how-to/backup-and-restore.md), with a mandatory snapshot before reset. |
|
|
216
|
+
| **Rehearse a release in isolation** | [OrbStack VMs](docs/how-to/use-orbstack-vms.md) with verified artifacts, local tunnels, and health-gated releases. |
|
|
217
|
+
| **Deploy to an existing server** | [SSH deployment](docs/how-to/deploy-over-ssh.md) to one Ubuntu LTS host, with pinned identity and health-gated rollback. Server provisioning, DNS, TLS, and public ingress stay external. |
|
|
218
|
+
| **Practice recovering from failure** | [Bounded failure labs](docs/how-to/run-failure-labs.md) that verify a healthy baseline, inject a fault, and report recovery. |
|
|
219
|
+
| **Prepare for offline work** | [Verified cache warming](docs/how-to/work-offline.md) for supported tools, images, charts, and dependencies. |
|
|
220
|
+
| **Add custom integrations** | [Declarative packs and trusted Python extensions](docs/how-to/write-a-provider.md) for organization-specific behavior. |
|
|
221
|
+
|
|
222
|
+
## How LDW keeps the setup predictable
|
|
223
|
+
|
|
224
|
+
1. **Discover** repository facts and evidence.
|
|
225
|
+
2. **Review and save** the manifest and lock atomically.
|
|
226
|
+
3. **Run** the accepted setup with locks and port checks.
|
|
227
|
+
4. **Reconcile** repository changes before updating the integration.
|
|
228
|
+
|
|
229
|
+
In team mode, commit these files:
|
|
230
|
+
|
|
231
|
+
```text
|
|
232
|
+
.devops-workbench/
|
|
233
|
+
├── project.toml # Accepted resources, modes, and commands
|
|
234
|
+
└── workbench.lock # Integration ownership and hashes
|
|
235
|
+
```
|
|
236
|
+
|
|
237
|
+
Ignore machine overrides in `.devops-workbench/project.local.toml`. Operational state stays in
|
|
238
|
+
local user directories. Secrets stay in project-owned environment files or an external store;
|
|
239
|
+
manifests declare variable names only.
|
|
240
|
+
|
|
241
|
+
Use `ldw integration diff` and `ldw review` to review changes, then `ldw resolve 1` and `ldw apply`.
|
|
242
|
+
`ldw review` shows what LDW will write; `ldw plan` shows how `ldw up` will start. LDW refuses to overwrite
|
|
243
|
+
drifted managed content and removes only artifacts it can prove it owns.
|
|
244
|
+
Follow the [reconciliation guide](docs/how-to/reconcile-an-integration.md) to apply changes.
|
|
245
|
+
|
|
246
|
+
### Optional AI, bounded authority
|
|
247
|
+
|
|
248
|
+
Request analysis during initialization with `--agent codex`, `--agent claude`, or `--agent auto`.
|
|
249
|
+
After per-project consent, eligible analyzers receive a restricted mirror of eligible tracked
|
|
250
|
+
files. Credentials, environment files, Git data, and ignored or untracked files are excluded.
|
|
251
|
+
Proposals must pass schema and evidence validation; agents have no direct infrastructure authority.
|
|
252
|
+
|
|
253
|
+
Codex requires a passing native sandbox self-test; Claude Code uses restricted file tools.
|
|
254
|
+
Unsupported environments fail closed. `--agent none` keeps onboarding deterministic.
|
|
255
|
+
`ldw context --json` supplies redacted, read-only operational facts for coding tools.
|
|
256
|
+
See the [threat model](docs/explanation/threat-model.md).
|
|
257
|
+
|
|
258
|
+
## Find your next step
|
|
259
|
+
|
|
260
|
+
| I want to… | Start here |
|
|
261
|
+
| --- | --- |
|
|
262
|
+
| Install on a fresh machine | [New-Mac guide](docs/how-to/install-on-a-new-mac.md) |
|
|
263
|
+
| Try a working example | [Compose tutorial](docs/tutorials/quick-start.md) |
|
|
264
|
+
| Onboard my own repository | [Add a project](docs/how-to/add-a-project.md) |
|
|
265
|
+
| Export a Tiltfile or mise tasks | [Export and eject](docs/how-to/export-and-eject.md) |
|
|
266
|
+
| Run several projects together | [Multi-project guide](docs/how-to/run-multiple-projects.md) |
|
|
267
|
+
| Look up a command or config field | [CLI reference](docs/reference/cli.md) · [Manifest reference](docs/reference/project-manifest.md) |
|
|
268
|
+
| Understand the design | [Architecture](docs/explanation/architecture.md) · [Environment boundaries](docs/explanation/environment-boundaries.md) · [Compared with other tools](docs/explanation/compared-with.md) |
|
|
269
|
+
| Diagnose a problem | [Troubleshooting](docs/how-to/troubleshoot.md) · [Support](SUPPORT.md) |
|
|
270
|
+
|
|
271
|
+
Browse the [full documentation](docs/index.md) for all guides and references.
|
|
272
|
+
|
|
273
|
+
## Contributing
|
|
274
|
+
|
|
275
|
+
LDW is licensed under [Apache 2.0](LICENSE). Bug reports, documentation improvements, integration
|
|
276
|
+
packs, and code contributions are welcome. Start with [CONTRIBUTING.md](CONTRIBUTING.md) and the
|
|
277
|
+
[Code of Conduct](CODE_OF_CONDUCT.md), or use
|
|
278
|
+
[GitHub Discussions](https://github.com/openplanr/ldw/discussions) for setup and design questions.
|
|
279
|
+
|
|
280
|
+
Report vulnerabilities through the [security policy](SECURITY.md), and keep secrets and private
|
|
281
|
+
project data out of public issues.
|
|
@@ -0,0 +1,6 @@
|
|
|
1
|
+
local_devops_workbench-0.2.1.dist-info/METADATA,sha256=Y6FkLrrS4A14XrYf_6-hXOdGNAhXZpKgCioJ85_5pjA,13490
|
|
2
|
+
local_devops_workbench-0.2.1.dist-info/WHEEL,sha256=W3fkpkm7-wf9vBI5Z-7s0eWkeM-spu78I8Neb98DeEg,87
|
|
3
|
+
local_devops_workbench-0.2.1.dist-info/entry_points.txt,sha256=dTKHU6CYY4yJh_oPK9Q7dBF74Oog3xbtkZ2EQTYrIz8,56
|
|
4
|
+
local_devops_workbench-0.2.1.dist-info/licenses/LICENSE,sha256=xx0jnfkXJvxRnG63LTGOxlggYnIysveWIZ6H3PNdCrQ,11357
|
|
5
|
+
local_devops_workbench-0.2.1.dist-info/licenses/NOTICE,sha256=B5WkzrKU7AX6Q1Am_dPx3vuQm_3dE_kTSWOC9ic4rGE,168
|
|
6
|
+
local_devops_workbench-0.2.1.dist-info/RECORD,,
|
|
@@ -0,0 +1,201 @@
|
|
|
1
|
+
Apache License
|
|
2
|
+
Version 2.0, January 2004
|
|
3
|
+
http://www.apache.org/licenses/
|
|
4
|
+
|
|
5
|
+
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
|
|
6
|
+
|
|
7
|
+
1. Definitions.
|
|
8
|
+
|
|
9
|
+
"License" shall mean the terms and conditions for use, reproduction,
|
|
10
|
+
and distribution as defined by Sections 1 through 9 of this document.
|
|
11
|
+
|
|
12
|
+
"Licensor" shall mean the copyright owner or entity authorized by
|
|
13
|
+
the copyright owner that is granting the License.
|
|
14
|
+
|
|
15
|
+
"Legal Entity" shall mean the union of the acting entity and all
|
|
16
|
+
other entities that control, are controlled by, or are under common
|
|
17
|
+
control with that entity. For the purposes of this definition,
|
|
18
|
+
"control" means (i) the power, direct or indirect, to cause the
|
|
19
|
+
direction or management of such entity, whether by contract or
|
|
20
|
+
otherwise, or (ii) ownership of fifty percent (50%) or more of the
|
|
21
|
+
outstanding shares, or (iii) beneficial ownership of such entity.
|
|
22
|
+
|
|
23
|
+
"You" (or "Your") shall mean an individual or Legal Entity
|
|
24
|
+
exercising permissions granted by this License.
|
|
25
|
+
|
|
26
|
+
"Source" form shall mean the preferred form for making modifications,
|
|
27
|
+
including but not limited to software source code, documentation
|
|
28
|
+
source, and configuration files.
|
|
29
|
+
|
|
30
|
+
"Object" form shall mean any form resulting from mechanical
|
|
31
|
+
transformation or translation of a Source form, including but
|
|
32
|
+
not limited to compiled object code, generated documentation,
|
|
33
|
+
and conversions to other media types.
|
|
34
|
+
|
|
35
|
+
"Work" shall mean the work of authorship, whether in Source or
|
|
36
|
+
Object form, made available under the License, as indicated by a
|
|
37
|
+
copyright notice that is included in or attached to the work
|
|
38
|
+
(an example is provided in the Appendix below).
|
|
39
|
+
|
|
40
|
+
"Derivative Works" shall mean any work, whether in Source or Object
|
|
41
|
+
form, that is based on (or derived from) the Work and for which the
|
|
42
|
+
editorial revisions, annotations, elaborations, or other modifications
|
|
43
|
+
represent, as a whole, an original work of authorship. For the purposes
|
|
44
|
+
of this License, Derivative Works shall not include works that remain
|
|
45
|
+
separable from, or merely link (or bind by name) to the interfaces of,
|
|
46
|
+
the Work and Derivative Works thereof.
|
|
47
|
+
|
|
48
|
+
"Contribution" shall mean any work of authorship, including
|
|
49
|
+
the original version of the Work and any modifications or additions
|
|
50
|
+
to that Work or Derivative Works thereof, that is intentionally
|
|
51
|
+
submitted to Licensor for inclusion in the Work by the copyright owner
|
|
52
|
+
or by an individual or Legal Entity authorized to submit on behalf of
|
|
53
|
+
the copyright owner. For the purposes of this definition, "submitted"
|
|
54
|
+
means any form of electronic, verbal, or written communication sent
|
|
55
|
+
to the Licensor or its representatives, including but not limited to
|
|
56
|
+
communication on electronic mailing lists, source code control systems,
|
|
57
|
+
and issue tracking systems that are managed by, or on behalf of, the
|
|
58
|
+
Licensor for the purpose of discussing and improving the Work, but
|
|
59
|
+
excluding communication that is conspicuously marked or otherwise
|
|
60
|
+
designated in writing by the copyright owner as "Not a Contribution."
|
|
61
|
+
|
|
62
|
+
"Contributor" shall mean Licensor and any individual or Legal Entity
|
|
63
|
+
on behalf of whom a Contribution has been received by Licensor and
|
|
64
|
+
subsequently incorporated within the Work.
|
|
65
|
+
|
|
66
|
+
2. Grant of Copyright License. Subject to the terms and conditions of
|
|
67
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
68
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
69
|
+
copyright license to reproduce, prepare Derivative Works of,
|
|
70
|
+
publicly display, publicly perform, sublicense, and distribute the
|
|
71
|
+
Work and such Derivative Works in Source or Object form.
|
|
72
|
+
|
|
73
|
+
3. Grant of Patent License. Subject to the terms and conditions of
|
|
74
|
+
this License, each Contributor hereby grants to You a perpetual,
|
|
75
|
+
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
|
|
76
|
+
(except as stated in this section) patent license to make, have made,
|
|
77
|
+
use, offer to sell, sell, import, and otherwise transfer the Work,
|
|
78
|
+
where such license applies only to those patent claims licensable
|
|
79
|
+
by such Contributor that are necessarily infringed by their
|
|
80
|
+
Contribution(s) alone or by combination of their Contribution(s)
|
|
81
|
+
with the Work to which such Contribution(s) was submitted. If You
|
|
82
|
+
institute patent litigation against any entity (including a
|
|
83
|
+
cross-claim or counterclaim in a lawsuit) alleging that the Work
|
|
84
|
+
or a Contribution incorporated within the Work constitutes direct
|
|
85
|
+
or contributory patent infringement, then any patent licenses
|
|
86
|
+
granted to You under this License for that Work shall terminate
|
|
87
|
+
as of the date such litigation is filed.
|
|
88
|
+
|
|
89
|
+
4. Redistribution. You may reproduce and distribute copies of the
|
|
90
|
+
Work or Derivative Works thereof in any medium, with or without
|
|
91
|
+
modifications, and in Source or Object form, provided that You
|
|
92
|
+
meet the following conditions:
|
|
93
|
+
|
|
94
|
+
(a) You must give any other recipients of the Work or
|
|
95
|
+
Derivative Works a copy of this License; and
|
|
96
|
+
|
|
97
|
+
(b) You must cause any modified files to carry prominent notices
|
|
98
|
+
stating that You changed the files; and
|
|
99
|
+
|
|
100
|
+
(c) You must retain, in the Source form of any Derivative Works
|
|
101
|
+
that You distribute, all copyright, patent, trademark, and
|
|
102
|
+
attribution notices from the Source form of the Work,
|
|
103
|
+
excluding those notices that do not pertain to any part of
|
|
104
|
+
the Derivative Works; and
|
|
105
|
+
|
|
106
|
+
(d) If the Work includes a "NOTICE" text file as part of its
|
|
107
|
+
distribution, then any Derivative Works that You distribute must
|
|
108
|
+
include a readable copy of the attribution notices contained
|
|
109
|
+
within such NOTICE file, excluding those notices that do not
|
|
110
|
+
pertain to any part of the Derivative Works, in at least one
|
|
111
|
+
of the following places: within a NOTICE text file distributed
|
|
112
|
+
as part of the Derivative Works; within the Source form or
|
|
113
|
+
documentation, if provided along with the Derivative Works; or,
|
|
114
|
+
within a display generated by the Derivative Works, if and
|
|
115
|
+
wherever such third-party notices normally appear. The contents
|
|
116
|
+
of the NOTICE file are for informational purposes only and
|
|
117
|
+
do not modify the License. You may add Your own attribution
|
|
118
|
+
notices within Derivative Works that You distribute, alongside
|
|
119
|
+
or as an addendum to the NOTICE text from the Work, provided
|
|
120
|
+
that such additional attribution notices cannot be construed
|
|
121
|
+
as modifying the License.
|
|
122
|
+
|
|
123
|
+
You may add Your own copyright statement to Your modifications and
|
|
124
|
+
may provide additional or different license terms and conditions
|
|
125
|
+
for use, reproduction, or distribution of Your modifications, or
|
|
126
|
+
for any such Derivative Works as a whole, provided Your use,
|
|
127
|
+
reproduction, and distribution of the Work otherwise complies with
|
|
128
|
+
the conditions stated in this License.
|
|
129
|
+
|
|
130
|
+
5. Submission of Contributions. Unless You explicitly state otherwise,
|
|
131
|
+
any Contribution intentionally submitted for inclusion in the Work
|
|
132
|
+
by You to the Licensor shall be under the terms and conditions of
|
|
133
|
+
this License, without any additional terms or conditions.
|
|
134
|
+
Notwithstanding the above, nothing herein shall supersede or modify
|
|
135
|
+
the terms of any separate license agreement you may have executed
|
|
136
|
+
with Licensor regarding such Contributions.
|
|
137
|
+
|
|
138
|
+
6. Trademarks. This License does not grant permission to use the trade
|
|
139
|
+
names, trademarks, service marks, or product names of the Licensor,
|
|
140
|
+
except as required for reasonable and customary use in describing the
|
|
141
|
+
origin of the Work and reproducing the content of the NOTICE file.
|
|
142
|
+
|
|
143
|
+
7. Disclaimer of Warranty. Unless required by applicable law or
|
|
144
|
+
agreed to in writing, Licensor provides the Work (and each
|
|
145
|
+
Contributor provides its Contributions) on an "AS IS" BASIS,
|
|
146
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
|
|
147
|
+
implied, including, without limitation, any warranties or conditions
|
|
148
|
+
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
|
|
149
|
+
PARTICULAR PURPOSE. You are solely responsible for determining the
|
|
150
|
+
appropriateness of using or redistributing the Work and assume any
|
|
151
|
+
risks associated with Your exercise of permissions under this License.
|
|
152
|
+
|
|
153
|
+
8. Limitation of Liability. In no event and under no legal theory,
|
|
154
|
+
whether in tort (including negligence), contract, or otherwise,
|
|
155
|
+
unless required by applicable law (such as deliberate and grossly
|
|
156
|
+
negligent acts) or agreed to in writing, shall any Contributor be
|
|
157
|
+
liable to You for damages, including any direct, indirect, special,
|
|
158
|
+
incidental, or consequential damages of any character arising as a
|
|
159
|
+
result of this License or out of the use or inability to use the
|
|
160
|
+
Work (including but not limited to damages for loss of goodwill,
|
|
161
|
+
work stoppage, computer failure or malfunction, or any and all
|
|
162
|
+
other commercial damages or losses), even if such Contributor
|
|
163
|
+
has been advised of the possibility of such damages.
|
|
164
|
+
|
|
165
|
+
9. Accepting Warranty or Additional Liability. While redistributing
|
|
166
|
+
the Work or Derivative Works thereof, You may choose to offer,
|
|
167
|
+
and charge a fee for, acceptance of support, warranty, indemnity,
|
|
168
|
+
or other liability obligations and/or rights consistent with this
|
|
169
|
+
License. However, in accepting such obligations, You may act only
|
|
170
|
+
on Your own behalf and on Your sole responsibility, not on behalf
|
|
171
|
+
of any other Contributor, and only if You agree to indemnify,
|
|
172
|
+
defend, and hold each Contributor harmless for any liability
|
|
173
|
+
incurred by, or claims asserted against, such Contributor by reason
|
|
174
|
+
of your accepting any such warranty or additional liability.
|
|
175
|
+
|
|
176
|
+
END OF TERMS AND CONDITIONS
|
|
177
|
+
|
|
178
|
+
APPENDIX: How to apply the Apache License to your work.
|
|
179
|
+
|
|
180
|
+
To apply the Apache License to your work, attach the following
|
|
181
|
+
boilerplate notice, with the fields enclosed by brackets "[]"
|
|
182
|
+
replaced with your own identifying information. (Don't include
|
|
183
|
+
the brackets!) The text should be enclosed in the appropriate
|
|
184
|
+
comment syntax for the file format. We also recommend that a
|
|
185
|
+
file or class name and description of purpose be included on the
|
|
186
|
+
same "printed page" as the copyright notice for easier
|
|
187
|
+
identification within third-party archives.
|
|
188
|
+
|
|
189
|
+
Copyright [yyyy] [name of copyright owner]
|
|
190
|
+
|
|
191
|
+
Licensed under the Apache License, Version 2.0 (the "License");
|
|
192
|
+
you may not use this file except in compliance with the License.
|
|
193
|
+
You may obtain a copy of the License at
|
|
194
|
+
|
|
195
|
+
http://www.apache.org/licenses/LICENSE-2.0
|
|
196
|
+
|
|
197
|
+
Unless required by applicable law or agreed to in writing, software
|
|
198
|
+
distributed under the License is distributed on an "AS IS" BASIS,
|
|
199
|
+
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
|
|
200
|
+
See the License for the specific language governing permissions and
|
|
201
|
+
limitations under the License.
|