geomoz 0.1.0__tar.gz

geomoz-0.1.0/.gitignore

@@ -0,0 +1,65 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+env/
+ENV/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Cache
+.cache/
+*.pkl
+.pytest_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Dados locais (podem ser grandes)
+*.gpkg
+*.shp
+*.shx
+*.dbf
+*.prj
+*.zip
+data/
+
+# Logs
+*.log
+
+# Test outputs
+test_output/
+coverage/
+htmlcov/
+
+# GeoMoz cache
+.geomoz_cache/

geomoz-0.1.0/.gitignore.save

@@ -0,0 +1,65 @@
+# Python
+__pycache__/
+*.py[cod]
+*$py.class
+*.so
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+
+# Virtual environments
+venv/
+env/
+ENV/
+
+# IDEs
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# Cache
+.cache/
+*.pkl
+.pytest_cache/
+
+# OS
+.DS_Store
+Thumbs.db
+
+# Dados locais (podem ser grandes)
+*.gpkg
+*.shp
+*.shx
+*.dbf
+*.prj
+*.zip
+data/
+
+# Logs
+*.log
+
+# Test outputs
+test_output/
+coverage/
+htmlcov/
+
+# GeoMoz cache
+.geomoz_cache/

geomoz-0.1.0/MANIFEST.in

@@ -0,0 +1,19 @@
+include README.md
+include README_PYPI.md
+include LICENSE
+include pyproject.toml
+include requirements.txt
+recursive-include geomoz/data/*.md
+recursive-include geomoz/utils/*.py
+recursive-exclude *.pyc
+recursive-exclude __pycache__
+recursive-exclude .git*
+recursive-exclude data/*.gpkg
+recursive-exclude *.gpkg
+recursive-exclude tests/*
+recursive-exclude *_old.py
+recursive-exclude *_new.py
+recursive-exclude build/*
+recursive-exclude dist/*
+recursive-exclude *.egg-info
+recursive-exclude __pycache__

geomoz-0.1.0/MANIFEST_old.in

@@ -0,0 +1,17 @@
+include README.md
+include README_PYPI.md
+include LICENSE
+include pyproject.toml
+include requirements.txt
+recursive-include geomoz/data/*.md
+recursive-include geomoz/utils/*.py
+recursive-exclude *.pyc
+recursive-exclude __pycache__
+recursive-exclude .git*
+recursive-exclude data/*.gpkg
+recursive-exclude tests/*
+recursive-exclude *_old.py
+recursive-exclude *_new.py
+recursive-exclude build/*
+recursive-exclude dist/*
+recursive-exclude *.egg-info

geomoz-0.1.0/PKG-INFO

@@ -0,0 +1,158 @@
+Metadata-Version: 2.4
+Name: geomoz
+Version: 0.1.0
+Summary: Geospatial data library for Mozambique with geological and administrative datasets
+Project-URL: Homepage, https://geolithica.com
+Project-URL: Repository, https://github.com/geolithicamz-hub/geomoz
+Project-URL: Documentation, https://github.com/geolithicamz-hub/geomoz/blob/main/README.md
+Project-URL: Bug Tracker, https://github.com/geolithicamz-hub/geomoz/issues
+Author-email: Hélder Gonçalves Félix Traquinho <heltrakinho@gmail.com>
+License: MIT
+Keywords: africa,geology,geopandas,geospatial,gis,mozambique,spatial-data
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Scientific/Engineering :: GIS
+Requires-Python: >=3.8
+Requires-Dist: geopandas>=0.14.0
+Requires-Dist: huggingface-hub>=0.10.0
+Requires-Dist: pandas>=1.5.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: shapely>=2.0.0
+Provides-Extra: dev
+Requires-Dist: black>=22.0.0; extra == 'dev'
+Requires-Dist: build>=0.7.0; extra == 'dev'
+Requires-Dist: flake8>=5.0.0; extra == 'dev'
+Requires-Dist: pytest-cov>=4.0.0; extra == 'dev'
+Requires-Dist: pytest>=7.0.0; extra == 'dev'
+Requires-Dist: twine>=4.0.0; extra == 'dev'
+Requires-Dist: wheel>=0.37.0; extra == 'dev'
+Provides-Extra: viz
+Requires-Dist: contextily>=1.2.0; extra == 'viz'
+Requires-Dist: folium>=0.12.0; extra == 'viz'
+Requires-Dist: matplotlib>=3.5.0; extra == 'viz'
+Requires-Dist: seaborn>=0.11.0; extra == 'viz'
+Description-Content-Type: text/markdown
+
+# GeoMoz - Dados Geográficos de Moçambique
+
+<p align="center">
+  <img src="https://img.shields.io/badge/version-0.1.0-blue.svg" alt="Version">
+  <img src="https://img.shields.io/badge/python-3.8%2B-blue.svg" alt="Python">
+  <img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License">
+</p>
+
+**GeoMoz** é um pacote Python que fornece acesso fácil a dados geográficos de Moçambique, incluindo divisões administrativas (11 províncias, 161 distritos, 459 postos, 11.524 aldeias) e dados geológicos completos.
+
+Inspirado no [`geobr`](https://github.com/ipeaGIT/geobr) (Brasil).
+
+---
+
+## 🚀 Instalação
+
+```bash
+pip install geomoz
+```
+
+Com dependências completas:
+```bash
+pip install geomoz geopandas matplotlib folium
+```
+
+---
+
+## ⚡ Uso Rápido
+
+```python
+import geomoz
+from geomoz import quick_map
+
+# Carregar províncias
+provinces = geomoz.read_province()
+print(f"✅ {len(provinces)} províncias carregadas")
+
+# Mapa rápido
+quick_map(provinces, column='Provincia')
+
+# Hierarquia completa
+districts = geomoz.read_district()
+posts = geomoz.read_admin_post()
+villages = geomoz.read_village()  # Usar cache para aldeias!
+```
+
+---
+
+## 📊 Dados Disponíveis
+
+| Dataset | Registros | Função |
+|---------|-----------|--------|
+| **Províncias** | 11 | `read_province()` |
+| **Distritos** | 161 | `read_district()` |
+| **Postos Administrativos** | 459 | `read_admin_post()` |
+| **Aldeias** | 11.524 | `read_village()` / `CachedGeoMoz.read_village()` |
+| **Geologia** | ~50.000 | `read_geology()` |
+
+---
+
+## 🎨 Exemplos
+
+### Mapa de Províncias
+```python
+from geomoz import plot_provinces
+plot_provinces(show_names=True, save_path='mapa.png')
+```
+
+### Geologia por Província
+```python
+import geopandas as gpd
+from geomoz import read_province, read_geology
+
+province = read_province(name_province="Tete")
+geology = read_geology()
+geo_tete = gpd.overlay(geology, province, how='intersection')
+print(f"Unidades geológicas em Tete: {len(geo_tete)}")
+```
+
+### Mapa Web Interativo
+```python
+import folium
+from geomoz import read_province
+
+province = read_province(name_province="Nampula")
+m = folium.Map(location=[-14.5, 39], zoom_start=7)
+folium.GeoJson(province).add_to(m)
+m.save('mapa.html')
+```
+
+---
+
+## 📚 Documentação
+
+- **📖 [README Completo](README_COMPREHENSIVE.md)** - Documentação detalhada
+- **🎓 [Tutorial Educativo](TUTORIAL.md)** - Guia passo a passo
+- **📋 [Referência Rápida](QUICK_REFERENCE.md)** - Cheat sheet
+- **💻 [Exemplos](examples/)** - Códigos de exemplo
+
+---
+
+## 🛠️ Desenvolvimento
+
+```bash
+git clone https://github.com/geolithica/geomoz.git
+cd geomoz
+pip install -e ".[dev]"
+pytest
+```
+
+---
+
+## 📄 Licença
+
+MIT License - veja [LICENSE](LICENSE)
+
+---
+
+**GeoMoz** - Dados geográficos de Moçambique ao alcance de todos! 🗺️🇲🇿

geomoz-0.1.0/PUBLISH_GUIDE.md

@@ -0,0 +1,270 @@
+# 🚀 GeoMoz PyPI Publication Guide
+
+This guide explains how to publish the GeoMoz package to PyPI for global distribution.
+
+## 📋 Prerequisites
+
+### Required Accounts
+1. **PyPI Account**: Register at https://pypi.org/account/register/
+2. **GitHub Access**: Push access to geolithicamz/geomoz repository
+3. **Hugging Face**: Dataset already published at geolithicamz/geomoz-data
+
+### Required Tools
+```bash
+pip install build twine wheel
+```
+
+## 🔧 Package Structure
+
+The package is properly structured for PyPI:
+
+```
+geomoz/
+├── geomoz/                    # Main package
+│   ├── __init__.py           # Package initialization
+│   ├── read_*.py             # Data reading functions
+│   ├── spatial.py             # Spatial operations
+│   ├── core.py               # Core functionality
+│   └── utils/                # Utilities
+│       ├── __init__.py
+│       ├── data.py              # Hugging Face integration
+│       └── utils.py             # Legacy utilities
+├── setup.py                   # Legacy setup
+├── pyproject.toml             # Modern build config
+├── requirements.txt            # Dependencies
+├── MANIFEST.in               # Package manifest
+├── LICENSE                   # MIT License
+├── README.md                 # Main documentation
+├── README_PYPI.md           # PyPI-specific README
+└── build_and_publish.py     # Build/publish script
+```
+
+## 🏗️ Build Process
+
+### 1. Clean Previous Builds
+```bash
+python build_and_publish.py build
+```
+
+### 2. Test Installation
+```bash
+python build_and_publish.py test
+```
+
+### 3. Build Distribution Files
+```bash
+python build_and_publish.py build
+```
+
+## 📦 Distribution Files
+
+After building, you'll find:
+- `dist/geomoz-1.0.0-py3-none-any.whl` - Wheel distribution
+- `dist/geomoz-1.0.0.tar.gz` - Source distribution
+
+## 🚀 Publishing to PyPI
+
+### Test Publication (Recommended)
+```bash
+python build_and_publish.py testpypi
+```
+
+### Production Publication
+```bash
+python build_and_publish.py pypi
+```
+
+## 🔐 Authentication
+
+### Method 1: API Token (Recommended)
+1. Generate PyPI API token at https://pypi.org/manage/account/token/
+2. Set environment variable:
+```bash
+export TWINE_PASSWORD=pypi-xxxxxx
+```
+
+### Method 2: Username/Password
+```bash
+twine upload dist/* -u __username__ -p __password__
+```
+
+## 📋 Pre-Publishing Checklist
+
+### ✅ Code Quality
+- [ ] All functions documented with docstrings
+- [ ] Type hints implemented
+- [ ] Code formatted with black
+- [ ] No linting errors (flake8)
+- [ ] Tests passing (pytest)
+
+### ✅ Package Structure
+- [ ] pyproject.toml properly configured
+- [ ] All required dependencies listed
+- [ ] Version number updated
+- [ ] License file included
+- [ ] README files updated
+
+### ✅ Functionality
+- [ ] Hugging Face integration working
+- [ ] CRS handling automatic
+- [ ] Cache system functional
+- [ ] All read_* functions working
+- [ ] Spatial functions working
+
+## 🧪 Testing After Publication
+
+### Install from PyPI
+```bash
+# Create fresh environment
+python -m venv test_env
+source test_env/bin/activate
+
+# Install from PyPI
+pip install geomoz
+
+# Test basic functionality
+python -c "
+import geomoz
+provinces = geomoz.read_province()
+print(f'Loaded {len(provinces)} provinces')
+"
+```
+
+### Install with Extras
+```bash
+# Test complete installation
+pip install geomoz[complete]
+
+# Test with visualization
+python -c "
+import geomoz
+import matplotlib.pyplot as plt
+provinces = geomoz.read_province()
+provinces.plot()
+plt.savefig('test.png')
+print('Visualization test passed')
+"
+```
+
+## 🔄 Version Management
+
+### Semantic Versioning
+- **Major**: Breaking changes (2.0.0)
+- **Minor**: New features (1.1.0)
+- **Patch**: Bug fixes (1.0.1)
+
+### Update Process
+1. Update version in `pyproject.toml`
+2. Update version in `setup.py`
+3. Update CHANGELOG.md
+4. Commit changes
+5. Build and publish
+
+## 📊 Distribution Channels
+
+### Primary: PyPI
+- **URL**: https://pypi.org/project/geomoz/
+- **Install**: `pip install geomoz`
+- **Audience**: General users, developers
+
+### Secondary: GitHub
+- **URL**: https://github.com/geolithicamz/geomoz
+- **Source**: Development version
+- **Issues**: Bug tracking and feature requests
+
+### Data: Hugging Face
+- **URL**: https://huggingface.co/geolithicamz/geomoz-data
+- **Purpose**: Dataset distribution
+- **Integration**: Automatic download and caching
+
+## 🎯 Success Metrics
+
+### Installation Success
+```bash
+# Track downloads
+pip install geomoz
+python -c "import geomoz; print('✅ Installation successful')"
+```
+
+### Functionality Verification
+```python
+import geomoz
+
+# Test core functionality
+try:
+    provinces = geomoz.read_province()
+    geology = geomoz.read_geology()
+    geo_zambezia = geomoz.geology_by_province(name_province="Zambézia")
+    area = geomoz.calculate_area(geo_zambezia)
+    
+    print("✅ All core functions working")
+    print(f"✅ Provinces: {len(provinces)}")
+    print(f"✅ Geology units: {len(geology)}")
+    print(f"✅ Zambézia geology: {len(geo_zambezia)}")
+    print(f"✅ Area calculation: {area['area_km2'].sum():.2f} km²")
+    
+except Exception as e:
+    print(f"❌ Error: {e}")
+```
+
+## 🆘 Troubleshooting
+
+### Common Issues
+
+#### Build Errors
+```bash
+# Missing build tools
+pip install --upgrade build wheel setuptools
+
+# Python not found
+python3 -m build  # Use python3 explicitly
+```
+
+#### Upload Errors
+```bash
+# Authentication failed
+twine check dist/*  # Check package first
+twine upload --repository testpypi dist/*  # Try test PyPI first
+
+# File exists error
+rm -rf dist/*
+python build  # Rebuild
+```
+
+#### Import Errors
+```bash
+# Missing dependencies
+pip install -r requirements.txt
+
+# Path issues
+python -c "import sys; print(sys.path)"
+```
+
+## 📞 Support Resources
+
+### Documentation
+- **Main README**: README.md
+- **PyPI README**: README_PYPI.md
+- **API Docs**: Inline docstrings
+
+### Community
+- **Issues**: https://github.com/geolithicamz/geomoz/issues
+- **Discussions**: https://github.com/geolithicamz/geomoz/discussions
+- **Wiki**: https://github.com/geolithicamz/geomoz/wiki
+
+### Contacts
+- **Email**: contact@geolithica.org
+- **Organization**: Geolithica
+
+---
+
+## 🎉 Publication Success!
+
+Once published successfully:
+
+1. **Verify**: Check https://pypi.org/project/geomoz/
+2. **Announce**: Share with community
+3. **Monitor**: Track downloads and issues
+4. **Maintain**: Update based on user feedback
+
+**GeoMoz will be available globally via `pip install geomoz`!** 🇲🇿