cf-regions-gui 0.1.0__tar.gz

cf_regions_gui-0.1.0/AUTHORS.md

@@ -0,0 +1,8 @@
+# Authors and maintainers
+
+`cf-regions-gui` was initiated and originally developed by [Yves Sorge](https://github.com/ysorge), 
+who serves as its initial author and maintainer.
+
+Additional contributors are recorded in the repository history and release
+notes. Maintainer responsibility may move to another person or organization
+without changing or erasing authorship of existing contributions.

cf_regions_gui-0.1.0/CHANGELOG.md

@@ -0,0 +1,20 @@
+# Changelog
+
+All notable changes to `cf-regions-gui` are documented here. The project follows
+[Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and uses
+[Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## 0.1.0 - Unreleased
+
+This is the first public release.
+
+### Added
+
+- Native, completely offline PySide6 desktop interface for `cf-regions`.
+- Interactive vector map with point lookup, region shapes, provenance, profile
+  selection, clipboard actions, dark mode, and low/high geometry detail.
+- Optional `globe` extra for a native Qt Quick 3D globe using local textures.
+- Mouse, touchpad, and map-scoped controls with synchronized 2D/3D selection.
+- Tests, type checks, and packaging validation on supported Python versions.
+- A compact world background independent of the selected region's shape detail,
+  avoiding full-world high-detail rendering during startup and detail changes.

cf_regions_gui-0.1.0/CODE_OF_CONDUCT.md

@@ -0,0 +1,26 @@
+# Code of conduct
+
+The `cf-regions-gui` project is committed to an open, welcoming, inclusive, and
+harassment-free community. Participants are expected to follow the standards of
+the [Contributor Covenant, version 2.1][covenant] in discussions, issues, pull
+requests, reviews, and project events.
+
+## Expected behavior
+
+- Be respectful of different backgrounds, viewpoints, and levels of experience.
+- Give and accept constructive technical feedback with empathy.
+- Focus disagreement on ideas and evidence rather than people.
+- Accept responsibility for mistakes and work to repair their impact.
+
+Harassment, discriminatory or sexualized language, threats, trolling, personal
+attacks, and publishing another person's private information are not acceptable.
+
+## Reporting and enforcement
+
+Report conduct concerns privately through the repository's [private reporting
+channel][private-report]. Do not disclose sensitive details in a public issue.
+Maintainers will review reports as promptly and impartially as possible and may
+edit or remove contributions, issue warnings, or restrict participation.
+
+[covenant]: https://www.contributor-covenant.org/version/2/1/code_of_conduct/
+[private-report]: https://github.com/ysorge/cf-regions-gui/security/advisories/new

cf_regions_gui-0.1.0/CONTRIBUTING.md

@@ -0,0 +1,39 @@
+# Contributing
+
+Contributions are welcome through GitHub issues and pull requests. Please open
+an issue before substantial features, interaction changes, or interface
+redesigns so the approach and scope can be discussed. Small fixes and
+documentation improvements may be submitted directly.
+
+Participation is governed by the [Code of conduct](CODE_OF_CONDUCT.md).
+
+## Development setup
+
+Use one of the latest Python version in a virtual environment:
+
+```console
+python -m venv .venv
+.venv/bin/python -m pip install -e ".[dev,globe]"
+```
+
+On Windows, use `.venv\Scripts\python` instead. For coordinated work against a
+sibling core checkout, install with
+`python -m pip install -e ../cf-regions -e ".[dev,globe]"`.
+
+Before opening a pull request, run:
+
+```console
+ruff check src tests
+mypy src
+QT_QPA_PLATFORM=offscreen pytest --cov=cfregions_gui --cov-report=term-missing
+python -m build
+twine check dist/*
+```
+
+On Windows, set `QT_QPA_PLATFORM=offscreen` using the shell's native syntax.
+Keep region logic in `cf-regions`; this project should remain a native
+presentation layer without a browser or local HTTP server. User-visible changes
+need tests and a changelog entry.
+
+By contributing, you agree that your contribution is distributed under
+GPL-3.0-or-later.