sourcelens 0.0.1__tar.gz

sourcelens-0.0.1/.gitignore

@@ -0,0 +1,27 @@
+# Builds
+bin/
+dist/
+build/
+*.egg-info/
+
+# Python
+__pycache__/
+*.pyc
+.venv/
+venv/
+.pytest_cache/
+.ruff_cache/
+
+# Local settings and secrets never belong in the repository
+.env
+.env.*
+*.local.yaml
+settings.yaml
+
+# Catalogues are written to the output folder (sourcelens config), not here
+research/
+exports/
+
+*.tmp
+*.tmp.gz
+.DS_Store

sourcelens-0.0.1/CHANGELOG.md

@@ -0,0 +1,75 @@
+# Changelog
+
+All notable changes to sourcelens. Versions follow semantic versioning.
+
+## 0.0.1 (2026-10-04)
+
+First public release, under the name sourcelens (developed as litsearch and
+litSearch before). sourcelens is a general tool: the research topic comes from
+the command line or from a configuration file, and the aging-clock catalogue
+it was built for is the default topic.
+
+### Added
+
+- `sourcelens "TOPIC"`: start or update a catalogue for any topic from one
+  line. Commas, semicolons and `OR` separate alternatives; the words of an
+  alternative are all required; double quotes keep a phrase together.
+- One catalogue per topic: the default topic in the output folder, every other
+  topic in a subfolder named after it. `--topic` and `--dir` select a catalogue
+  in every command; `sourcelens list` shows them.
+- OpenAlex search, covering every field of research, and OpenAlex
+  open-access PDF links as a full-text source.
+- OpenAlex results are kept only when the topic words appear as whole words in
+  the title or abstract.
+- Further versions of a stored work (same title, venue and year, another DOI)
+  are skipped.
+- A new topic starts 12 months back. Asking later for older work with
+  `--from` or `--range` extends the window.
+- `sourcelens config`: per-machine settings (output folder, contact email, API
+  keys) in `~/.config/sourcelens/settings.yaml`, with environment overrides.
+- The newest additions are printed after every update.
+- `pip install sourcelens` (Python 3.10+) and `go install` (one static binary)
+  install the same command. PyMuPDF is an optional extra (`sourcelens[pdf]`);
+  without it poppler-utils converts PDFs.
+- Unit tests for both implementations, a parity check between them, CI and
+  release workflows, a Makefile and a Dockerfile.
+- `publish.yml` and `publish.md`: PyPI and TestPyPI publishing with trusted
+  publishing, with version, README and wheel checks before every upload.
+- `docs/configuration.md`: every configuration key.
+
+### Changed
+
+- Topic-specific parts moved from the code into the configuration:
+  - reference folders (`references`, `seeds`);
+  - the category of registry origin papers (`origin_category`);
+  - the core categories and the default category;
+  - the summary's data layers;
+  - website relevance.
+- Column `clocks` is now `entities`; configuration key `clock_names` is now
+  `entities`; query option `--clock` is now `--entity`. Older catalogues and
+  configurations are still read.
+- Seed roles `clock_origin` and `clock_reference` are now `registry_origin`
+  and `registry_reference`; `seeds/falconage_clocks.csv` is now
+  `seeds/registry_entries.csv`; `corpus/pre2011_background.csv` is now
+  `corpus/before_window.csv`.
+- Docker is optional: both implementations run natively.
+
+### Removed
+
+- The Docker launchers (`run.sh`), the sequential `update_all.sh` and the
+  per-workspace `config/local.yaml`; settings replace them.
+
+## litSearch 2.0 (2026-10-04, unreleased)
+
+- Python and Go implementations with the same commands, flags and outputs,
+  each with its own Docker image.
+- `query` and `export` (APA, AMA, MLA, Chicago, Harvard, Vancouver, IEEE,
+  Nature, BibTeX, RIS, EndNote, CSL-JSON).
+- One configuration file kept in the output folder.
+
+## agingcat 1.x (2026-09-29 to 2026-10-04, unreleased)
+
+- The aging-clock literature pipeline: PubMed, Europe PMC and arXiv searches,
+  seeds from local projects, an append-only chronological `progress.csv`,
+  open-access full texts, repositories, packages and websites, and the
+  `agingcat` CLI with parallel stages, source, type and date-range selection.