codendium 1.0.0__py3-none-any.whl

codendium-1.0.0.dist-info/METADATA

@@ -0,0 +1,332 @@
+Metadata-Version: 2.4
+Name: codendium
+Version: 1.0.0
+Summary: Codendium - builds US Copyright Office compliant source-code deposit PDFs from a source tree.
+Author: ami-a
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/ami-a/codendium
+Project-URL: Repository, https://github.com/ami-a/codendium
+Project-URL: Issues, https://github.com/ami-a/codendium/issues
+Keywords: copyright,registration,deposit,source-code,pdf,compendium,intellectual-property,legal
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Environment :: X11 Applications :: Qt
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Legal Industry
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Printing
+Classifier: Topic :: Software Development :: Documentation
+Classifier: Topic :: Text Processing :: Markup
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: reportlab>=4.0
+Requires-Dist: pygments>=2.7
+Requires-Dist: charset-normalizer>=2.0
+Requires-Dist: pathspec>=0.9
+Provides-Extra: gui
+Requires-Dist: PySide6>=6.8.1; extra == "gui"
+Provides-Extra: test
+Requires-Dist: pytest>=7.4; extra == "test"
+Requires-Dist: pypdf>=4.0; extra == "test"
+Provides-Extra: lint
+Requires-Dist: ruff>=0.5; extra == "lint"
+Provides-Extra: build
+Requires-Dist: build>=1.2; extra == "build"
+Requires-Dist: twine>=6.1; extra == "build"
+Requires-Dist: trove-classifiers>=2024.1.1; extra == "build"
+Provides-Extra: dev
+Requires-Dist: codendium[build,gui,lint,test]; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+<img src="https://raw.githubusercontent.com/ami-a/codendium/main/copyright_deposit/assets/logo.svg" alt="Codendium" width="104">
+
+# Codendium
+
+**Turn a source tree into a US Copyright Office compliant deposit PDF — and know the page count before you render it.**
+
+[![CI](https://github.com/ami-a/codendium/actions/workflows/ci.yml/badge.svg)](https://github.com/ami-a/codendium/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/codendium?label=PyPI)](https://pypi.org/project/codendium/)
+[![Python](https://img.shields.io/pypi/pyversions/codendium?label=Python)](https://pypi.org/project/codendium/)
+[![Downloads](https://static.pepy.tech/badge/codendium)](https://pepy.tech/project/codendium)
+[![Visits](https://hits.sh/github.com/ami-a/codendium.svg?label=visits)](https://hits.sh/github.com/ami-a/codendium/)
+
+[![Licence](https://img.shields.io/badge/Licence-Apache_2.0-D22128?style=flat-square&logo=apache&logoColor=white)](https://github.com/ami-a/codendium/blob/main/LICENSE)
+[![GUI](https://img.shields.io/badge/GUI-PySide6-41CD52?style=flat-square&logo=qt&logoColor=white)](https://doc.qt.io/qtforpython/)
+[![PDF](https://img.shields.io/badge/PDF-ReportLab-005C9C?style=flat-square)](https://www.reportlab.com/)
+[![Highlighting](https://img.shields.io/badge/Lexing-Pygments-FFD43B?style=flat-square&logoColor=black)](https://pygments.org/)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-64748B?style=flat-square)](https://github.com/ami-a/codendium#install)
+
+</div>
+
+---
+
+## The problem this solves
+
+To register software copyright in the United States you must deposit "identifying
+portions" of your source code, and the Copyright Office is exacting about what
+that means. The *Compendium of U.S. Copyright Office Practices* (Third) requires
+the program title and version on the first page, monospaced type at roughly
+9–10 pt, **about 40 lines per page**, continuous page numbering and clear file
+paths. Then §721.6 adds the rule that governs everything else: if the program
+runs to more than 50 pages, you deposit **the first 25 pages and the last 25**
+— not a selection of your choosing.
+
+Doing that by hand from a real multi-file project is slow and easy to get wrong.
+Worse, the number that decides which rule applies — the page count — is
+invisible until you have already built the PDF. So you build it, discover you
+are at 62 pages, change something, and build it again.
+
+**Codendium turns that into one step.** Point it at a folder; it discovers the
+source, puts it in the order you want, optionally strips comments, lays it on a
+compliant grid, and tells you the exact page count *before* rendering anything.
+Then it writes both the complete PDF for your records and the filing copy with
+§721.6 already applied, plus a manifest recording exactly what went in.
+
+It is useful if you are an individual developer, a small studio or a law firm
+preparing a software registration, and you would rather not assemble a
+200-page deposit in a word processor.
+
+---
+
+## How it works
+
+<div align="center">
+<img src="https://raw.githubusercontent.com/ami-a/codendium/main/docs/flow.svg" alt="Pipeline: discover, order, strip, then a shared layout stage feeding either the estimator or the renderer" width="100%">
+</div>
+
+The page grid is fixed and the font is monospaced, so **page count is a pure
+function of the character stream**. Estimating runs the same discovery,
+ordering, stripping and layout the renderer runs, and stops just before writing
+the file. The estimate is therefore not a projection of the page count — it *is*
+the page count, and the test suite asserts that equality against the rendered
+PDF across seven different layout configurations.
+
+---
+
+## Install
+
+```bash
+pip install codendium            # CLI only
+pip install "codendium[gui]"     # CLI + desktop GUI
+```
+
+Python 3.10 or newer. On Windows use the `py` launcher in place of `python`.
+
+The GUI needs PySide6; **the CLI does not**, so on a headless machine or in CI
+`pip install codendium` pulls only the four runtime dependencies.
+
+From source instead:
+
+```bash
+git clone https://github.com/ami-a/codendium.git
+cd codendium
+pip install -e ".[dev]"          # everything, including the test suite
+```
+
+---
+
+## Quick start
+
+```bash
+python -m copyright_deposit                       # opens the GUI
+```
+
+Or from the command line:
+
+```bash
+# Propose an order from the code's own structure
+python -m copyright_deposit suggest-order <folder> --write order.txt
+
+# Exact page count, no PDF written, plus the comment-policy comparison
+python -m copyright_deposit estimate <folder> --order-file order.txt --what-if
+
+# Build it
+python -m copyright_deposit build <folder> --order-file order.txt \
+    --name "My Program" --program-version 1.2.0 \
+    --owner "Jane Developer" --revision auto -o out
+```
+
+`build` exits non-zero and writes nothing if it finds credentials in the
+selected files, which makes it safe to run unattended.
+
+### What you get
+
+| File | Purpose |
+|---|---|
+| `deposit_full.pdf` | The complete program, for your records |
+| `deposit_deposit.pdf` | The filing copy, with §721.6 applied |
+| `deposit_manifest.json` | Every file, its SHA-256, and the pages it landed on |
+| `deposit_summary.txt` | Readable audit trail, plus the statement to give the Office |
+
+---
+
+## The application
+
+<div align="center">
+<img src="https://raw.githubusercontent.com/ami-a/codendium/main/docs/screenshot-estimate.png" alt="The estimate tab: 205 pages, the §721.6 split, the statement for the application, and page counts under four comment policies" width="100%">
+</div>
+
+The estimate answers the question that actually matters — *what do I change to
+get under 50 pages and deposit the whole program?*
+
+```
+Keep everything                   236 pages   (first 25 + last 25)
+Strip comments                    229 pages   (first 25 + last 25)
+Strip comments + docstrings       217 pages   (first 25 + last 25)
+Strip all + collapse blanks       205 pages   (first 25 + last 25)
+```
+
+<div align="center">
+<img src="https://raw.githubusercontent.com/ami-a/codendium/main/docs/screenshot-files.png" alt="The files tab: drag-ordered file list with language, line counts, per-file line ranges and the pages each file occupies" width="100%">
+</div>
+
+The file list *is* the order list. Drag rows, or let **Suggest order** build one
+from the entry points and the import/`#include` graph. Files nobody named are
+appended and flagged, so an automatic decision never passes for a deliberate
+one, and the Pages column shows which files fall inside the omitted middle —
+code the Office will never see.
+
+---
+
+## Depositing only part of a file
+
+Give any file a line range and only those lines are deposited — the **Deposit
+lines** column in the GUI, or `--lines` on the command line:
+
+```bash
+python -m copyright_deposit build <folder> --lines "src/core.py=1-50,120-200"
+```
+
+Accepted forms: `1-50, 120-200` (blocks), `12` (one line), `305-` (to the end),
+`-40` (from the start). Overlapping ranges are merged; out-of-range ones are
+clamped or reported.
+
+**Line numbers are the ones in your editor** — the original file's, not
+positions after comments were stripped. An extract is then marked twice, so no
+reader can mistake it for a whole file:
+
+```
+FILE: src/core.py
+PARTIAL FILE - lines 1-50, 120-200 of 380 included
+------------------------------------------------------------
+def public_api(value):
+    return _compute(value)
+- - - - - -  [ lines 51-119 omitted (69 lines) ]  - - - - - -
+def _compute(value):
+```
+
+One thing the markers deliberately do *not* claim: lines removed by the comment
+policy are **not** reported as omitted. If stripping deleted lines 1–2, you did
+not omit them — so no marker appears. Elisions are computed from your ranges
+against the file's true length, never from which lines happened to survive.
+
+---
+
+## Stripping code without breaking it
+
+Strippers never rewrite source. They *classify* byte ranges as comment or
+docstring, and a shared routine removes those ranges — so the transform is
+provably subtractive.
+
+- **Python** — `tokenize` for comments, `ast` for docstrings, so a `#` inside a
+  string cannot be mistaken for a comment. Afterwards the original and stripped
+  ASTs are compared; on any difference the file is kept verbatim and a warning
+  is raised.
+- **Everything else** — Pygments, but only after its token stream is verified to
+  reconstruct the source exactly. `Comment.Preproc` is never removed: C lexers
+  classify `#include` and `#define` as comments, and deleting those would gut
+  the deposit.
+- **Fallback** — a hand-written C-family state machine handling raw strings
+  (`R"tag( */ )tag"`), C# verbatim strings, Rust `r#"…"#`, template literals,
+  line splicing, and JavaScript regex literals containing `//`.
+
+A docstring that is the only statement in a function is never removed — that
+would leave an empty suite and turn valid source into a syntax error.
+
+---
+
+## Safeguards
+
+| Check | Why it exists |
+|---|---|
+| **Secret / PII scan** | A deposit becomes a public record. Anything left in the code is readable by anyone who inspects the filing, so high-severity findings block the build until redacted or acknowledged. |
+| **Third-party detector** | A registration covers only your own authorship. Flags foreign copyright holders, SPDX licences and generated files — and reads *only the comment layer*, so prose and code never trigger it. |
+| **Redaction (§721.7)** | Blocked-out text is never written into the PDF, only a filled rectangle, so it cannot be copied or extracted. Line count is unchanged, so pagination cannot shift. The 49 % limit is checked. |
+| **Reproducibility** | Identical settings and sources produce a byte-identical PDF, so a re-run proves what was filed. |
+
+---
+
+## Page grid
+
+Letter (or A4), 0.75 in margins, Courier 9.5 pt, 40 lines per page, 88 columns.
+
+Courier is a PDF base-14 face: guaranteed monospaced, rendered identically by
+every viewer, with no embedding or font-redistribution question — which is what
+you want in a document you are filing. To use something else, point `--font` at
+a monospaced `.ttf` or drop one in
+[`copyright_deposit/assets/fonts/`](https://github.com/ami-a/codendium/tree/main/copyright_deposit/assets/fonts/). A
+proportional font is rejected rather than silently breaking the grid, and
+glyphs the font cannot draw become `?` with a warning rather than vanishing.
+
+Overlong lines wrap — never truncate — and the wrap is counted in the estimate.
+
+---
+
+## Dependencies
+
+| Package | Version | Licence | Used for |
+|---|---|---|---|
+| [reportlab](https://www.reportlab.com/) | ≥ 4.0 | BSD | PDF generation |
+| [Pygments](https://pygments.org/) | ≥ 2.7 | BSD-2-Clause | Comment classification for ~30 languages |
+| [charset-normalizer](https://github.com/jawah/charset_normalizer) | ≥ 2.0 | MIT | Deterministic source decoding |
+| [pathspec](https://github.com/cpburnz/python-pathspec) | ≥ 0.9 | MPL-2.0 | `.gitignore` matching |
+| [PySide6](https://doc.qt.io/qtforpython/) | ≥ 6.8.1 | LGPL-3.0 | GUI (optional) |
+
+PySide6 is LGPL. That imposes nothing on you for source use or a normal
+`pip install`, but it is worth knowing the day anyone freezes this into a
+distributed binary.
+
+---
+
+## Tests
+
+```bash
+pip install -e ".[test]"
+python -m pytest
+```
+
+175 tests covering stripper correctness on adversarial input, AST equivalence,
+grid compliance, both §721.6 branches, redaction non-extractability, byte-level
+reproducibility, line-range selection and elision marking, order resolution,
+scanner false positives, and settings/history round-trips.
+
+The estimate-equals-render property is asserted directly: the estimated page
+count is compared against `len(PdfReader(...).pages)` of the file actually
+written.
+
+---
+
+## Limitations
+
+- Comment classification is verified for Python and validated for C-family and
+  Pygments-supported languages; an unrecognised language is deposited verbatim
+  rather than guessed at.
+
+---
+
+## Licence
+
+[Apache License 2.0](https://github.com/ami-a/codendium/blob/main/LICENSE) — Copyright 2026 [ami-a](https://github.com/ami-a).
+
+**Codendium prepares a deposit. It is not legal advice.** Whether a particular
+deposit satisfies the Copyright Office for a particular work is a judgement for
+you or your attorney to make.

codendium-1.0.0.dist-info/RECORD

@@ -0,0 +1,45 @@
+codendium-1.0.0.dist-info/licenses/LICENSE,sha256=w91D0CwuTwkrPo69WRpHivw9A626zFdLyNGdhfn5A1U,11335
+copyright_deposit/__init__.py,sha256=1TC21WoTwXcXPDUmKNp2HHHVmSGlBRO6Eqb8hHdwZJM,507
+copyright_deposit/__main__.py,sha256=l0EvlJ28LoOHhzOtXoD0808cHiVlkhVzp1qrj95G6Ak,823
+copyright_deposit/cli.py,sha256=lWy88tmVVVgrUAZj-6URxjhf0Ez7_IUkgBZxbqlivd0,12364
+copyright_deposit/config.py,sha256=cVj7rLaTm0-vAFdutx76e8otcdcFnhTxasX2BrLqA1I,9649
+copyright_deposit/assets/__init__.py,sha256=k4ud6oT02zBR74heVVNTPTIelAXB42Bjw1oUfsqJz6k,127
+copyright_deposit/assets/logo.svg,sha256=cHc1ylNC6emqUR42N2Dn634AU8qs__-ikOv1cjE6Apo,1345
+copyright_deposit/assets/fonts/README.md,sha256=MzkmBHwEp0yTgbMq_hsUcfTL3tABRHFfODXNLfrJRhc,1401
+copyright_deposit/core/__init__.py,sha256=TKzZr07l1TBuOrVErIKhgjRkSGfFIv7XBwTVfSnJyhM,77
+copyright_deposit/core/deposit.py,sha256=o8v5p79x3wENuiYgjhnWEwYtQzMHke_rubp9jtN1uCY,3977
+copyright_deposit/core/discovery.py,sha256=SwuBGvwvtINi52HVDtJ7VTbbmibEsmIECQWWhAK7SOo,8809
+copyright_deposit/core/encoding.py,sha256=xhffQXwKbHf2RYOcTAk-qRXXKRzcWIFshVDPfLyUSwo,4249
+copyright_deposit/core/languages.py,sha256=rxwEDRNjgKrFqN4Ufx7iHWPN24F1FP9kmXBYjT1GEss,5861
+copyright_deposit/core/layout.py,sha256=r2xrpOiX8QjeiSkyzoC9HUZpr00qW0g3lyIDkONBPl0,11749
+copyright_deposit/core/lineranges.py,sha256=sjBegfR8Hpt1QsN9D2bGRkMwb2CMY0GfjjPdbhGC104,7111
+copyright_deposit/core/manifest.py,sha256=joHi1UOCAYwfG_p4N_7JGX8iJ9qIf9JP0lY6iQU3ZQE,10287
+copyright_deposit/core/metrics.py,sha256=vn_wUwQYkjcTvG_VT6Y_wlghoc_b5i3ZYbnaX5dZRTw,8740
+copyright_deposit/core/ordering.py,sha256=S6zdGLF2zy1dnfOrffnhXNsv95JQ86yMENqTzo4oc8U,12230
+copyright_deposit/core/pipeline.py,sha256=ASbev5ziXfhXx0ElYNnjTzwtAt_kfJwzAV06CpunWU8,14126
+copyright_deposit/core/redaction.py,sha256=9nZXU7T5JmNfKpwrR_Zeu6RxizO9NOatA-JwhfXiIDc,5111
+copyright_deposit/core/render.py,sha256=Ubd9IehbFg-IleYOCQ8rGkW7dAnPEed0K9DTujCG2ps,7994
+copyright_deposit/core/scanning/__init__.py,sha256=0G9DVNnXjYTIjn8Sxn7PaXPIH79Ss6SE85gYRUM2nLc,1660
+copyright_deposit/core/scanning/secrets.py,sha256=Qrrw5d7EDvxsi1G4T1jdpX0vgHw0YJ0cpDSc5c2r0_I,5985
+copyright_deposit/core/scanning/thirdparty.py,sha256=RyIqIeBxrpwwqGCAs7YX5TkQuBznVt6_y90bZJzNQFg,6712
+copyright_deposit/core/strip/__init__.py,sha256=xRgeLGmhtX37RRYkhjyNJ546JNnzIVcnWt1nKGjPy1g,11697
+copyright_deposit/core/strip/cfamily_strip.py,sha256=rN27JdHjNyZGC4TR6hQPLfh0mUcg8JPOfQfzAS7FBvA,7471
+copyright_deposit/core/strip/pygments_strip.py,sha256=MHnK7HcFjV5xpe6ZEiXH4v6GrsPa9O9egvL6l13pF3o,2865
+copyright_deposit/core/strip/python_strip.py,sha256=7N8fViCnYyJ_0GnXKh_hwL7LoFoABqrunM1xuC7AKb4,4828
+copyright_deposit/gui/__init__.py,sha256=wuAox1FJw_2oNmAbQRJdnlMrFzCzSxJuYjGNlLrMXRw,60
+copyright_deposit/gui/app.py,sha256=iy1GGDBcG3nM8ZIsad1cEQ6wOuUXOkfi_W4p7ojP9cY,933
+copyright_deposit/gui/branding.py,sha256=nkOgyskRT8NDiKqCDvCU5rQ87UiZ2yxAghbLvaA8hcA,2665
+copyright_deposit/gui/history.py,sha256=XeWmcM779292qIRzuzmvKnrU5rCcUTt2k4cyZ0O2ZeU,6429
+copyright_deposit/gui/main_window.py,sha256=eSUDxyt6rCuCxBluiBWFcEhPFRj4zxXtbxt-hA-ZDnc,23797
+copyright_deposit/gui/workers.py,sha256=GKvYIWzXqTB7D0vj6CZyM3J123Li4ajKSYkeN4u5HYc,2900
+copyright_deposit/gui/panels/__init__.py,sha256=-zlxfHl6jq4T5uOVySC5VfcBolxKcHmOy0cchFtf8rw,26
+copyright_deposit/gui/panels/estimate.py,sha256=GzBce5h-mXOnEwjb8x6ntSgBTIKfVvvI2FcqL5Eua-g,6255
+copyright_deposit/gui/panels/files.py,sha256=LSFOw5v5Is93G0IkJy3SBLtluNbcYBjV9_4aqtYd28Y,24219
+copyright_deposit/gui/panels/identification.py,sha256=wnb3kVZ_Hh8YarPyw1yk63IBVfynvui2Oep5vVrZMK8,7494
+copyright_deposit/gui/panels/options.py,sha256=69cXNGMDPVAnppO3lHMvPi1Osd1opkAP_yEENTg6p6Q,19093
+copyright_deposit/gui/panels/preflight.py,sha256=VVu6DxIwJQrTwLCZM2P8-S08rQatsMTB-QTH4yj1tqA,10344
+codendium-1.0.0.dist-info/METADATA,sha256=EMe5wQM6GuSwT5gZk93_4qkYj45JyarwIMAKW9RQREQ,14262
+codendium-1.0.0.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+codendium-1.0.0.dist-info/entry_points.txt,sha256=2BSdQ9RNKafYzwWnPaiEcHXCzWSJ00q0EW-BtVuI6l4,170
+codendium-1.0.0.dist-info/top_level.txt,sha256=JkhLMOi-9U7ReXxgpjbEJoC_34dmpzJokMhaO1ZrFqg,18
+codendium-1.0.0.dist-info/RECORD,,

codendium-1.0.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (84.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

codendium-1.0.0.dist-info/entry_points.txt

@@ -0,0 +1,6 @@
+[console_scripts]
+codendium = copyright_deposit.__main__:main
+copyright-deposit = copyright_deposit.cli:main
+
+[gui_scripts]
+codendium-gui = copyright_deposit.gui.app:run

codendium-1.0.0.dist-info/licenses/LICENSE

@@ -0,0 +1,201 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright 2026 ami-a
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

codendium-1.0.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+copyright_deposit

copyright_deposit/__init__.py

@@ -0,0 +1,15 @@
+"""Codendium.
+
+Builds US Copyright Office compliant source-code deposit PDFs
+(Compendium sections 721.6 and 721.7) from an arbitrary source tree.
+"""
+
+__version__ = "1.0.0"
+
+#: Product name, shown to people: window title, PDF metadata, reports.
+DISPLAY_NAME = "Codendium"
+
+#: Storage key for the settings/history directory under %APPDATA%.
+#: Deliberately NOT the display name - renaming it would orphan the
+#: profiles and build history of anyone who already has them.
+APP_NAME = "CopyrightDepositBuilder"

copyright_deposit/__main__.py

@@ -0,0 +1,34 @@
+"""Entry point.
+
+With no arguments the GUI opens; with arguments the CLI runs, so the same
+installation serves both an operator and a build script.
+"""
+
+from __future__ import annotations
+
+import sys
+
+
+def main() -> int:
+    if len(sys.argv) > 1:
+        from .cli import main as cli_main
+
+        return cli_main()
+
+    try:
+        from .gui.app import run
+    except ImportError as exc:  # PySide6 missing
+        print(
+            "The GUI needs PySide6. Install it with:\n"
+            "    py -m pip install PySide6\n"
+            f"(import error: {exc})\n\n"
+            "Or use the command line, for example:\n"
+            "    py -m copyright_deposit estimate <folder> --what-if",
+            file=sys.stderr,
+        )
+        return 1
+    return run()
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

copyright_deposit/assets/__init__.py

@@ -0,0 +1,5 @@
+"""Bundled assets.
+
+This is a package so that ``fonts/`` is installed as package data; see
+``core.metrics._bundled_font``.
+"""