Metadata-Version: 2.4
Name: wsws-md
Version: 0.1.2
Summary: Convert World Socialist Web Site articles to Markdown
License: MIT
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.28
Requires-Dist: beautifulsoup4>=4.12
Requires-Dist: markdownify>=0.13
Requires-Dist: lxml>=4.9
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == "test"
Requires-Dist: pytest-cov>=5.0; extra == "test"
Provides-Extra: dev
Requires-Dist: wsws-md[test]; extra == "dev"
Requires-Dist: ruff>=0.6; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Requires-Dist: types-requests; extra == "dev"
Requires-Dist: types-beautifulsoup4; extra == "dev"
Dynamic: license-file

# WSWS Markdown

[![CI](https://github.com/JoeMountWSWS/wsws-md/actions/workflows/ci.yml/badge.svg)](https://github.com/JoeMountWSWS/wsws-md/actions/workflows/ci.yml)
[![Publish to PyPI](https://github.com/JoeMountWSWS/wsws-md/actions/workflows/publish.yml/badge.svg)](https://github.com/JoeMountWSWS/wsws-md/actions/workflows/publish.yml)

A tool to convert articles from the World Socialist Web Site to Markdown format.

## Install

```sh
pip install wsws-md
```

## Usage

```sh
wswsmd "https://www.wsws.org/en/articles/2026/07/03/coeq-j03.html"
```

Prints the article as Markdown (with YAML frontmatter containing title, author,
date, description and source URL) to stdout. Use `-o FILE` / `--output FILE`
to write to a file instead:

```sh
wswsmd "https://www.wsws.org/en/articles/2026/07/03/coeq-j03.html" -o article.md
```

## Development

```sh
pip install -e ".[test]"
pytest
```

Pull request titles must follow [Conventional Commits](https://www.conventionalcommits.org/)
— see [CONTRIBUTING.md](CONTRIBUTING.md). Releases are automated with
[release-please](https://github.com/googleapis/release-please).
