Metadata-Version: 2.3
Name: citation-title
Version: 1.0.1
Summary: Pattern matching Philippine Supreme Court citations.
Requires-Python: >=3.14
Description-Content-Type: text/markdown

# Citation Title

![Github CI](https://github.com/justmars/citation-title/actions/workflows/ci.yml/badge.svg)

`citation-title` reduces an already segmented Philippine Supreme Court decision
title to a concise, readable citation title. It recognizes adversarial cases
and `In re`-style matters, removes non-title material, and applies the
repository's established party-name and institutional shorthands.

It is deliberately conservative. Long captions and multi-party captions are
accepted when their structure identifies the parties; a short caption with an
ambiguous bare `V.` is not guessed. In that situation, the package returns
`None` so the calling workflow can retain the source title or route it for
review.

It works alongside [`citation-report`](https://github.com/justmars/citation-report)
in the [LawSQL](https://lawsql.com) citation-processing ecosystem: report
extraction identifies the reporter citation, while this package shortens the
decision-title evidence supplied by the calling workflow.

## Quick Example

```python
from citation_title import cite_title

short_title = cite_title("People of the Philippines Vs. Juan Dela Cruz")

assert short_title == "People v. Dela Cruz"
```

## Using the Result

- The source title remains the legal evidence and should be retained.
- The returned value is a compact display title, not a replacement for the
  source record.
- `None` means that the package could not identify a title safely. It does not
  mean that the decision has no title.

## Documentation

See the [documentation](https://justmars.github.io/citation-title) for the
title-shortening flow, supported case forms, local development checks, and
[release notes](https://justmars.github.io/citation-title/releases/).

## Boundaries

- Callers own title segmentation and preserve the original source title.
- `citation-title` owns short-title normalization for adversarial and `In re`
  forms.
- `citation-report` owns report-citation grammar and report normalization.
