geocsv 0.1.0__tar.gz

geocsv-0.1.0/CHANGELOG.md

@@ -0,0 +1,26 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [Unreleased]
+
+## [0.1.0] - 2026-11-08
+### Added
+- `geocsv.read()` / `read_string()` return a `GeoTable` with detected geometry, typed
+  attributes (integer, real, text) and per-row issues; `geocsv.detect()` returns the
+  detection alone.
+- CSV handling with the standard library only: encoding detection (UTF-8, UTF-8 BOM,
+  UTF-16, cp1252, latin-1, cp1254), delimiter sniffing (`,` `;` tab `|`), Excel's
+  `sep=` line, decimal commas, quoted fields and header detection.
+- Geometry detection with a confidence score and reasons: latitude/longitude columns by
+  header names in many languages or by value ranges, swapped-column detection, DMS
+  values, single-column coordinate pairs, WKT/EWKT, GeoJSON, geohash, Plus Codes
+  (including short codes with a reference point), Maidenhead locators, MGRS, UTM and
+  projected x/y with an EPSG code (`pyproj` extra).
+- Pure-Python decoders: DMS parser and formatter, geohash, Open Location Code,
+  Maidenhead, UTM and MGRS (Krüger series, WGS 84).
+- Validation: missing, invalid, empty, out-of-range, swapped and likely-swapped rows,
+  (0, 0) "null island", duplicates and ragged rows, with a text report and JSON summary.
+- Writers: GeoJSON, GeoJSONSeq, KML, GPX and an OGC GeoPackage written with `sqlite3`
+  only; ESRI Shapefile through the `shapefile` extra.
+- `geocsv` command with `inspect`, `detect` and `convert` sub-commands.

geocsv-0.1.0/CITATION.cff

@@ -0,0 +1,20 @@
+cff-version: 1.2.0
+message: "If you use this software, please cite it as below."
+authors:
+  - family-names: "Eminoğlu"
+    given-names: "Yusuf"
+    email: "yusufeminoglu@gmail.com"
+    orcid: "https://orcid.org/0009-0005-6000-2934"
+title: "geocsv"
+version: "0.1.0"
+date-released: "2026-11-08"
+license: "MIT"
+repository-code: "https://github.com/YusufEminoglu/geocsv_sdk"
+url: "https://pypi.org/project/geocsv/"
+abstract: "Pure-Python reader that finds the coordinates in any CSV or spreadsheet export (lat/lon columns, DMS, WKT, GeoJSON, geohash, Plus Codes, Maidenhead, MGRS, UTM), validates them and writes GeoJSON, GeoJSONSeq, KML, GPX or GeoPackage without GDAL."
+keywords:
+  - gis
+  - csv
+  - geojson
+  - geopackage
+  - coordinates

geocsv-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Yusuf Eminoğlu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

geocsv-0.1.0/MANIFEST.in

@@ -0,0 +1,9 @@
+include LICENSE
+include README.md
+include CHANGELOG.md
+include CITATION.cff
+include pyproject.toml
+include src/geocsv/py.typed
+recursive-include src/geocsv *.py
+recursive-include tests *.py *.csv *.tsv *.txt
+recursive-include examples *.py *.csv

geocsv-0.1.0/PKG-INFO

@@ -0,0 +1,233 @@
+Metadata-Version: 2.4
+Name: geocsv
+Version: 0.1.0
+Summary: Turn any spreadsheet or CSV of places into a map-ready GeoJSON, GeoPackage, KML or GPX file, without GDAL.
+Author-email: Yusuf Eminoğlu <yusufeminoglu@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/YusufEminoglu/geocsv_sdk
+Project-URL: Repository, https://github.com/YusufEminoglu/geocsv_sdk
+Project-URL: Issues, https://github.com/YusufEminoglu/geocsv_sdk/issues
+Project-URL: Changelog, https://github.com/YusufEminoglu/geocsv_sdk/blob/main/CHANGELOG.md
+Keywords: gis,csv,geojson,geopackage,gpkg,kml,gpx,wkt,latitude,longitude,geocoding,dms,geohash,plus-codes,open-location-code,mgrs,utm,maidenhead,spreadsheet,data-cleaning
+Classifier: Development Status :: 4 - Beta
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+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: Operating System :: OS Independent
+Classifier: Topic :: Scientific/Engineering :: GIS
+Classifier: Topic :: Text Processing
+Classifier: Topic :: Utilities
+Classifier: Environment :: Console
+Classifier: Intended Audience :: Science/Research
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Typing :: Typed
+Requires-Python: >=3.9
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: pyproj
+Requires-Dist: pyproj>=3.3.0; extra == "pyproj"
+Provides-Extra: shapefile
+Requires-Dist: pyshp>=2.3.0; extra == "shapefile"
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+<div align="center">
+
+# geocsv
+
+[![PyPI version](https://img.shields.io/pypi/v/geocsv.svg?color=10b981)](https://pypi.org/project/geocsv/)
+[![Python version support](https://img.shields.io/pypi/pyversions/geocsv.svg?color=3b82f6)](https://pypi.org/project/geocsv/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/YusufEminoglu/geocsv_sdk/blob/main/LICENSE)
+[![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-D7FF64.svg)](https://docs.astral.sh/ruff/)
+
+**Turn any spreadsheet or CSV of places into a map-ready GeoJSON, GeoPackage, KML or GPX file, without GDAL.**
+
+[📦 PyPI](https://pypi.org/project/geocsv/) • [💻 GitHub](https://github.com/YusufEminoglu/geocsv_sdk) • [🐛 Issues](https://github.com/YusufEminoglu/geocsv_sdk/issues)
+
+</div>
+
+You have a spreadsheet export with a column called `Breitengrad`, or `enlem;boylam`
+with decimal commas, or `40°26′46″N 79°58′56″W` strings, or Plus Codes, or MGRS
+references. geocsv finds the coordinates, tells you how sure it is and why, reports the
+rows that are broken, and writes a file that QGIS, ArcGIS, Google Earth, a GPS or a web
+map can open. It is pure Python with **no required dependencies**.
+
+## 📦 Installation
+
+```bash
+pip install geocsv
+
+# optional extras
+pip install "geocsv[pyproj]"     # reproject x/y or EWKT from any EPSG code
+pip install "geocsv[shapefile]"  # write ESRI Shapefiles (via pyshp)
+```
+
+Python 3.9+ on Windows, macOS or Linux.
+
+## ⚡ Quickstart
+
+```bash
+geocsv inspect places.csv                 # what was detected, and which rows are wrong
+geocsv convert places.csv -o places.gpkg  # GeoPackage (also .geojson .geojsonl .kml .gpx .shp)
+geocsv convert places.csv -o places.geojson --lat "Y koord" --lon "X koord"
+```
+
+```python
+import geocsv
+
+table = geocsv.read("places.csv")
+print(table.detection.describe())
+# latlon: lat='Breitengrad', lon='Längengrad', decimal (confidence 0.99)
+print(table.report())
+
+table.to_gpkg("places.gpkg")
+table.to_geojson("places.geojson")
+fc = table.to_geojson()          # or get the FeatureCollection as a dict
+table.to_kml("places.kml")
+table.to_gpx("places.gpx")
+
+geocsv.detect("places.csv")      # detection only, with .reasons and .alternatives
+```
+
+## 🔎 What it reads
+
+**CSV dialects** (standard library only)
+
+* encodings: UTF-8, UTF-8 with BOM, UTF-16 (Excel "Unicode text"), and the Windows code
+  pages cp1252 / latin-1 / cp1254 (Turkish letters such as ğ ı ş are told apart from
+  Western European text)
+* delimiters `,` `;` tab `|` (sniffed from the data, quoted fields respected) and Excel's
+  `sep=;` first line
+* decimal commas (`40,7128`), header or no header (detected), ragged rows
+
+**Geometry encodings**, found automatically:
+
+| kind | example | notes |
+|---|---|---|
+| `latlon` | `lat` / `lon` columns | header names in many languages: lat, latitude, latitud, Breitengrad, enlem, широта, lng, long, Längengrad, boylam, долгота, … plus value ranges when names are missing |
+| `latlon` (DMS) | `40°26′46″N`, `N40 26.767`, `40d26m46s` | degrees, minutes, seconds, any symbols or letters |
+| `pair` | `"41.0082, 28.9784"`, `40°26′46″N 79°58′56″W` | one column; lat/lon order inferred from ranges, hemisphere letters or a `lonlat` header |
+| `wkt` | `POINT (29 41)`, `SRID=3857;POLYGON ((…))` | all simple-feature types, Z/M/ZM, EWKT |
+| `geojson` | `{"type": "Point", "coordinates": [29, 41]}` | geometry or Feature objects |
+| `geohash` | `sxk97cn4` | |
+| `pluscode` | `8GFJWVM5+9V` | Open Location Code; short codes with `plus_code_reference` |
+| `maidenhead` | `KM69kw` | 2-10 characters |
+| `mgrs` | `35T PF 66370 41552` | WGS 84, pure-Python Krüger series |
+| `utm` | `35T 666371 4541552` | zone + band or hemisphere |
+| `xy` | `easting` / `northing` columns | any EPSG code via the `pyproj` extra |
+
+Every detection has a confidence and human-readable reasons:
+
+```text
+$ geocsv detect stations.csv
+latlon: lat='lon', lon='lat', decimal (confidence 0.99)
+  - header 'lat' looks like latitude but its values only fit longitude; the columns are swapped
+  - 100% of values are coordinates; 100% are within latitude/longitude range
+  - the two columns are adjacent
+```
+
+Override any decision: `lat=`/`lon=`, `wkt=`, `column=` + `kind=`, `x=`/`y=` + `epsg=`,
+`order="lonlat"`, `encoding=`, `delimiter=`, `header=` (CLI: `--lat`, `--lon`, `--wkt`,
+`--column`, `--kind`, `--x`, `--y`, `--epsg`, `--order`, `--encoding`, `--delimiter`,
+`--header/--no-header`). Columns can be named or numbered from 1.
+
+## 🩺 Validation report
+
+```text
+$ geocsv inspect issues.csv
+Geometry   latlon: lat='latitude', lon='longitude', decimal (confidence 0.87)
+Valid      8 of 13 rows  bbox=(0.000000, 0.000000, 37.874600, 41.008200)
+
+issue           severity   rows  lines
+--------------  --------  -----  --------------------
+missing         error         2  3, 4
+invalid         error         1  5
+out_of_range    error         1  6
+swapped         error         1  9
+likely_swapped  warning       1  13
+null_island     warning       1  7
+duplicate       warning       1  8
+ragged          warning       1  14
+```
+
+| code | severity | meaning |
+|---|---|---|
+| `missing` | error | empty geometry cell(s) |
+| `invalid` | error | the value does not parse |
+| `empty` | error | WKT/GeoJSON `EMPTY` geometry |
+| `out_of_range` | error | outside ±90 / ±180 |
+| `swapped` | error | latitude beyond ±90 but would fit if swapped (`fix_swapped=True` repairs it) |
+| `crs` | error | EWKT in another CRS and `pyproj` is not installed |
+| `likely_swapped` | warning | in range, but far closer to the rest of the table when swapped |
+| `swapped_fixed` | warning | swapped back (by `fix_swapped=True` or hemisphere letters) |
+| `null_island` | warning | exactly (0, 0) |
+| `duplicate` | warning | same geometry as an earlier row |
+| `ragged` | warning | row length differs from the header |
+
+Line numbers are physical lines in the file, as your editor shows them.
+`table.issues`, `table.summary()` and `geocsv inspect --json` give the same data in
+machine-readable form; `geocsv convert --strict` exits with status 1 when any row has an
+error.
+
+## 🗺️ What it writes
+
+| format | method | notes |
+|---|---|---|
+| GeoJSON | `to_geojson(path=None)` | RFC 7946 FeatureCollection; returns a dict without a path |
+| GeoJSONSeq | `to_geojsonseq(path)` | one Feature per line (`.geojsonl`, `.ndjson`) |
+| GeoPackage | `to_gpkg(path, layer=None)` | pure `sqlite3`; OGC GeoPackage 1.4 tables, StandardGeoPackageBinary + ISO WKB, any geometry type, Z |
+| KML | `to_kml(path=None)` | Placemarks with ExtendedData, holes, MultiGeometry |
+| GPX | `to_gpx(path=None)` | points as waypoints, lines as tracks |
+| Shapefile | `to_shapefile(path)` | needs `geocsv[shapefile]`; one geometry family |
+| any | `to_file(path, driver=None)` | picks the format from the extension |
+
+Attributes keep their types: integer, real or text (codes like `"00123"` stay text).
+A `name`-like column (`name`, `title`, `isim`, `nombre`, …) labels KML placemarks and GPX
+waypoints. The GeoPackage writer is tested against `sqlite3`, GDAL's `ogrinfo`, GDAL's
+`validate_gpkg.py` conformance checker and GeoPandas.
+
+## 🧭 Coordinate helpers
+
+The decoders are public and dependency-free:
+
+```python
+from geocsv import dms, geohash, pluscode, maidenhead, utm
+
+dms.parse_dms_pair("40°26′46″N 79°58′56″W")   # (40.4461, -79.9822)
+dms.format_dms(40.446111, "lat")             # '40°26′46.0″N'
+geohash.decode("u4pruydqqvj")                # (57.64911, 10.40744)
+pluscode.decode("849VCWC8+R9")               # (37.4220625, -122.0840625)
+pluscode.recover_nearest("CWC8+R9", 37.4, -122.0)
+maidenhead.decode("FN31pr")                  # (41.7292, -72.7083)
+utm.mgrs_to_latlon("31U DQ 48251 11932")     # (48.8582, 2.2945)
+utm.latlon_to_mgrs(48.8582, 2.2945)          # '31U DQ 48251 11932'
+utm.utm_to_latlon(31, "N", 448251, 5411932)
+```
+
+UTM/MGRS use Krüger's series to sixth order; they agree with PROJ to under a millimetre.
+
+## 🛠️ Development
+
+```bash
+git clone https://github.com/YusufEminoglu/geocsv_sdk.git
+cd geocsv_sdk
+pip install -e ".[dev,pyproj,shapefile]"
+python -m pytest --cov=geocsv
+python -m ruff check . && python -m ruff format --check src tests && python -m mypy src
+```
+
+The tests include hand-made fixture CSVs, reference values for every decoder, a seeded
+synthetic corpus of 400 tables that measures detection accuracy, and GDAL-based checks
+of the GeoPackage output that run when GDAL is installed.
+
+## 📄 License
+
+MIT © Yusuf Eminoğlu

geocsv-0.1.0/README.md

@@ -0,0 +1,192 @@
+<div align="center">
+
+# geocsv
+
+[![PyPI version](https://img.shields.io/pypi/v/geocsv.svg?color=10b981)](https://pypi.org/project/geocsv/)
+[![Python version support](https://img.shields.io/pypi/pyversions/geocsv.svg?color=3b82f6)](https://pypi.org/project/geocsv/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://github.com/YusufEminoglu/geocsv_sdk/blob/main/LICENSE)
+[![Code style: Ruff](https://img.shields.io/badge/code%20style-ruff-D7FF64.svg)](https://docs.astral.sh/ruff/)
+
+**Turn any spreadsheet or CSV of places into a map-ready GeoJSON, GeoPackage, KML or GPX file, without GDAL.**
+
+[📦 PyPI](https://pypi.org/project/geocsv/) • [💻 GitHub](https://github.com/YusufEminoglu/geocsv_sdk) • [🐛 Issues](https://github.com/YusufEminoglu/geocsv_sdk/issues)
+
+</div>
+
+You have a spreadsheet export with a column called `Breitengrad`, or `enlem;boylam`
+with decimal commas, or `40°26′46″N 79°58′56″W` strings, or Plus Codes, or MGRS
+references. geocsv finds the coordinates, tells you how sure it is and why, reports the
+rows that are broken, and writes a file that QGIS, ArcGIS, Google Earth, a GPS or a web
+map can open. It is pure Python with **no required dependencies**.
+
+## 📦 Installation
+
+```bash
+pip install geocsv
+
+# optional extras
+pip install "geocsv[pyproj]"     # reproject x/y or EWKT from any EPSG code
+pip install "geocsv[shapefile]"  # write ESRI Shapefiles (via pyshp)
+```
+
+Python 3.9+ on Windows, macOS or Linux.
+
+## ⚡ Quickstart
+
+```bash
+geocsv inspect places.csv                 # what was detected, and which rows are wrong
+geocsv convert places.csv -o places.gpkg  # GeoPackage (also .geojson .geojsonl .kml .gpx .shp)
+geocsv convert places.csv -o places.geojson --lat "Y koord" --lon "X koord"
+```
+
+```python
+import geocsv
+
+table = geocsv.read("places.csv")
+print(table.detection.describe())
+# latlon: lat='Breitengrad', lon='Längengrad', decimal (confidence 0.99)
+print(table.report())
+
+table.to_gpkg("places.gpkg")
+table.to_geojson("places.geojson")
+fc = table.to_geojson()          # or get the FeatureCollection as a dict
+table.to_kml("places.kml")
+table.to_gpx("places.gpx")
+
+geocsv.detect("places.csv")      # detection only, with .reasons and .alternatives
+```
+
+## 🔎 What it reads
+
+**CSV dialects** (standard library only)
+
+* encodings: UTF-8, UTF-8 with BOM, UTF-16 (Excel "Unicode text"), and the Windows code
+  pages cp1252 / latin-1 / cp1254 (Turkish letters such as ğ ı ş are told apart from
+  Western European text)
+* delimiters `,` `;` tab `|` (sniffed from the data, quoted fields respected) and Excel's
+  `sep=;` first line
+* decimal commas (`40,7128`), header or no header (detected), ragged rows
+
+**Geometry encodings**, found automatically:
+
+| kind | example | notes |
+|---|---|---|
+| `latlon` | `lat` / `lon` columns | header names in many languages: lat, latitude, latitud, Breitengrad, enlem, широта, lng, long, Längengrad, boylam, долгота, … plus value ranges when names are missing |
+| `latlon` (DMS) | `40°26′46″N`, `N40 26.767`, `40d26m46s` | degrees, minutes, seconds, any symbols or letters |
+| `pair` | `"41.0082, 28.9784"`, `40°26′46″N 79°58′56″W` | one column; lat/lon order inferred from ranges, hemisphere letters or a `lonlat` header |
+| `wkt` | `POINT (29 41)`, `SRID=3857;POLYGON ((…))` | all simple-feature types, Z/M/ZM, EWKT |
+| `geojson` | `{"type": "Point", "coordinates": [29, 41]}` | geometry or Feature objects |
+| `geohash` | `sxk97cn4` | |
+| `pluscode` | `8GFJWVM5+9V` | Open Location Code; short codes with `plus_code_reference` |
+| `maidenhead` | `KM69kw` | 2-10 characters |
+| `mgrs` | `35T PF 66370 41552` | WGS 84, pure-Python Krüger series |
+| `utm` | `35T 666371 4541552` | zone + band or hemisphere |
+| `xy` | `easting` / `northing` columns | any EPSG code via the `pyproj` extra |
+
+Every detection has a confidence and human-readable reasons:
+
+```text
+$ geocsv detect stations.csv
+latlon: lat='lon', lon='lat', decimal (confidence 0.99)
+  - header 'lat' looks like latitude but its values only fit longitude; the columns are swapped
+  - 100% of values are coordinates; 100% are within latitude/longitude range
+  - the two columns are adjacent
+```
+
+Override any decision: `lat=`/`lon=`, `wkt=`, `column=` + `kind=`, `x=`/`y=` + `epsg=`,
+`order="lonlat"`, `encoding=`, `delimiter=`, `header=` (CLI: `--lat`, `--lon`, `--wkt`,
+`--column`, `--kind`, `--x`, `--y`, `--epsg`, `--order`, `--encoding`, `--delimiter`,
+`--header/--no-header`). Columns can be named or numbered from 1.
+
+## 🩺 Validation report
+
+```text
+$ geocsv inspect issues.csv
+Geometry   latlon: lat='latitude', lon='longitude', decimal (confidence 0.87)
+Valid      8 of 13 rows  bbox=(0.000000, 0.000000, 37.874600, 41.008200)
+
+issue           severity   rows  lines
+--------------  --------  -----  --------------------
+missing         error         2  3, 4
+invalid         error         1  5
+out_of_range    error         1  6
+swapped         error         1  9
+likely_swapped  warning       1  13
+null_island     warning       1  7
+duplicate       warning       1  8
+ragged          warning       1  14
+```
+
+| code | severity | meaning |
+|---|---|---|
+| `missing` | error | empty geometry cell(s) |
+| `invalid` | error | the value does not parse |
+| `empty` | error | WKT/GeoJSON `EMPTY` geometry |
+| `out_of_range` | error | outside ±90 / ±180 |
+| `swapped` | error | latitude beyond ±90 but would fit if swapped (`fix_swapped=True` repairs it) |
+| `crs` | error | EWKT in another CRS and `pyproj` is not installed |
+| `likely_swapped` | warning | in range, but far closer to the rest of the table when swapped |
+| `swapped_fixed` | warning | swapped back (by `fix_swapped=True` or hemisphere letters) |
+| `null_island` | warning | exactly (0, 0) |
+| `duplicate` | warning | same geometry as an earlier row |
+| `ragged` | warning | row length differs from the header |
+
+Line numbers are physical lines in the file, as your editor shows them.
+`table.issues`, `table.summary()` and `geocsv inspect --json` give the same data in
+machine-readable form; `geocsv convert --strict` exits with status 1 when any row has an
+error.
+
+## 🗺️ What it writes
+
+| format | method | notes |
+|---|---|---|
+| GeoJSON | `to_geojson(path=None)` | RFC 7946 FeatureCollection; returns a dict without a path |
+| GeoJSONSeq | `to_geojsonseq(path)` | one Feature per line (`.geojsonl`, `.ndjson`) |
+| GeoPackage | `to_gpkg(path, layer=None)` | pure `sqlite3`; OGC GeoPackage 1.4 tables, StandardGeoPackageBinary + ISO WKB, any geometry type, Z |
+| KML | `to_kml(path=None)` | Placemarks with ExtendedData, holes, MultiGeometry |
+| GPX | `to_gpx(path=None)` | points as waypoints, lines as tracks |
+| Shapefile | `to_shapefile(path)` | needs `geocsv[shapefile]`; one geometry family |
+| any | `to_file(path, driver=None)` | picks the format from the extension |
+
+Attributes keep their types: integer, real or text (codes like `"00123"` stay text).
+A `name`-like column (`name`, `title`, `isim`, `nombre`, …) labels KML placemarks and GPX
+waypoints. The GeoPackage writer is tested against `sqlite3`, GDAL's `ogrinfo`, GDAL's
+`validate_gpkg.py` conformance checker and GeoPandas.
+
+## 🧭 Coordinate helpers
+
+The decoders are public and dependency-free:
+
+```python
+from geocsv import dms, geohash, pluscode, maidenhead, utm
+
+dms.parse_dms_pair("40°26′46″N 79°58′56″W")   # (40.4461, -79.9822)
+dms.format_dms(40.446111, "lat")             # '40°26′46.0″N'
+geohash.decode("u4pruydqqvj")                # (57.64911, 10.40744)
+pluscode.decode("849VCWC8+R9")               # (37.4220625, -122.0840625)
+pluscode.recover_nearest("CWC8+R9", 37.4, -122.0)
+maidenhead.decode("FN31pr")                  # (41.7292, -72.7083)
+utm.mgrs_to_latlon("31U DQ 48251 11932")     # (48.8582, 2.2945)
+utm.latlon_to_mgrs(48.8582, 2.2945)          # '31U DQ 48251 11932'
+utm.utm_to_latlon(31, "N", 448251, 5411932)
+```
+
+UTM/MGRS use Krüger's series to sixth order; they agree with PROJ to under a millimetre.
+
+## 🛠️ Development
+
+```bash
+git clone https://github.com/YusufEminoglu/geocsv_sdk.git
+cd geocsv_sdk
+pip install -e ".[dev,pyproj,shapefile]"
+python -m pytest --cov=geocsv
+python -m ruff check . && python -m ruff format --check src tests && python -m mypy src
+```
+
+The tests include hand-made fixture CSVs, reference values for every decoder, a seeded
+synthetic corpus of 400 tables that measures detection accuracy, and GDAL-based checks
+of the GeoPackage output that run when GDAL is installed.
+
+## 📄 License
+
+MIT © Yusuf Eminoğlu

geocsv-0.1.0/examples/quickstart.py

@@ -0,0 +1,35 @@
+"""Read a few CSV layouts, print the detection report and write a GeoPackage.
+
+Run from a clone:  python examples/quickstart.py
+"""
+
+from __future__ import annotations
+
+import tempfile
+from pathlib import Path
+
+import geocsv
+
+SAMPLES = {
+    "turkish_decimal_comma.csv": "isim;enlem;boylam\nAnkara;39,9334;32,8597\nİzmir;38,4237;27,1428\n",
+    "dms.csv": 'site,position\nPittsburgh,"40°26′46″N 79°58′56″W"\nOslo,"59°54′50″N 10°45′08″E"\n',
+    "wkt.csv": 'name,wkt\nPark,"POLYGON ((29 41, 29.01 41, 29.01 41.01, 29 41))"\n',
+    "codes.csv": "shop,plus_code\nGoogleplex,849VCWC8+R9\nAnkara,8GFJWVM5+9V\n",
+}
+
+
+def main() -> None:
+    with tempfile.TemporaryDirectory() as tmp:
+        folder = Path(tmp)
+        for name, text in SAMPLES.items():
+            path = folder / name
+            path.write_text(text, encoding="utf-8")
+            table = geocsv.read(path)
+            print(table.report())
+            print()
+            out = table.to_gpkg(path.with_suffix(".gpkg"))
+            print(f"wrote {out.name} with {len(table.valid)} features\n")
+
+
+if __name__ == "__main__":
+    main()

geocsv-0.1.0/pyproject.toml

@@ -0,0 +1,133 @@
+[build-system]
+requires = ["setuptools>=77.0.0", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "geocsv"
+version = "0.1.0"
+authors = [
+    { name = "Yusuf Eminoğlu", email = "yusufeminoglu@gmail.com" }
+]
+description = "Turn any spreadsheet or CSV of places into a map-ready GeoJSON, GeoPackage, KML or GPX file, without GDAL."
+keywords = [
+    "gis",
+    "csv",
+    "geojson",
+    "geopackage",
+    "gpkg",
+    "kml",
+    "gpx",
+    "wkt",
+    "latitude",
+    "longitude",
+    "geocoding",
+    "dms",
+    "geohash",
+    "plus-codes",
+    "open-location-code",
+    "mgrs",
+    "utm",
+    "maidenhead",
+    "spreadsheet",
+    "data-cleaning",
+]
+readme = "README.md"
+license = "MIT"
+license-files = ["LICENSE"]
+requires-python = ">=3.9"
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: OS Independent",
+    "Topic :: Scientific/Engineering :: GIS",
+    "Topic :: Text Processing",
+    "Topic :: Utilities",
+    "Environment :: Console",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Developers",
+    "Intended Audience :: End Users/Desktop",
+    "Typing :: Typed",
+]
+dependencies = []
+
+[project.optional-dependencies]
+pyproj = [
+    "pyproj>=3.3.0",
+]
+shapefile = [
+    "pyshp>=2.3.0",
+]
+dev = [
+    "pytest>=7.0.0",
+    "pytest-cov>=4.0.0",
+    "ruff>=0.1.0",
+    "mypy>=1.0.0",
+]
+
+[project.scripts]
+geocsv = "geocsv.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/YusufEminoglu/geocsv_sdk"
+Repository = "https://github.com/YusufEminoglu/geocsv_sdk"
+Issues = "https://github.com/YusufEminoglu/geocsv_sdk/issues"
+Changelog = "https://github.com/YusufEminoglu/geocsv_sdk/blob/main/CHANGELOG.md"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+geocsv = ["py.typed"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py39"
+exclude = [
+    "scratch",
+    ".venv",
+    "build",
+    "dist",
+]
+
+[tool.ruff.lint]
+select = ["E", "F", "W", "I", "B", "C4"]
+ignore = ["E501"]
+
+[tool.mypy]
+files = ["src"]
+warn_unused_ignores = true
+warn_redundant_casts = true
+
+[[tool.mypy.overrides]]
+module = [
+    # Optional extras: every import of them is lazy and guarded.
+    "pyproj.*",
+    "shapefile.*",
+]
+ignore_missing_imports = true
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+# Lets `pytest` run straight from a clone, without an editable install first.
+pythonpath = ["src"]
+
+[tool.coverage.run]
+source = ["geocsv"]
+branch = true
+
+[tool.coverage.report]
+show_missing = true
+fail_under = 85
+exclude_lines = [
+    "pragma: no cover",
+    "if TYPE_CHECKING:",
+    "raise NotImplementedError",
+]

geocsv-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+