{"id":32719124,"url":"https://github.com/adpena/teadata","last_synced_at":"2026-02-19T20:01:31.636Z","repository":{"id":317725791,"uuid":"1067329946","full_name":"adpena/teadata","owner":"adpena","description":"Unofficial Python-based toolkit for working with Texas Education Agency (TEA) public education datasets.  It provides object-oriented access to rich, spatially-aware data about school districts/charters and campuses,  making it easy for developers to explore, enrich, analyze, and visualize educational data.","archived":false,"fork":false,"pushed_at":"2026-02-18T18:41:09.000Z","size":543496,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-02-18T22:37:50.813Z","etag":null,"topics":["public-education","python","python-3","texas","texas-education-agency"],"latest_commit_sha":null,"homepage":"https://adpena.github.io/teadata/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adpena.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-09-30T17:47:56.000Z","updated_at":"2026-02-18T18:41:13.000Z","dependencies_parsed_at":"2025-10-02T18:18:13.989Z","dependency_job_id":null,"html_url":"https://github.com/adpena/teadata","commit_stats":null,"previous_names":["adpena/teadata"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/adpena/teadata","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adpena%2Fteadata","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adpena%2Fteadata/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adpena%2Fteadata/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adpena%2Fteadata/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adpena","download_url":"https://codeload.github.com/adpena/teadata/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adpena%2Fteadata/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29629642,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T18:02:07.722Z","status":"ssl_error","status_checked_at":"2026-02-19T18:01:46.144Z","response_time":117,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["public-education","python","python-3","texas","texas-education-agency"],"created_at":"2025-11-02T18:02:45.536Z","updated_at":"2026-02-19T20:01:31.631Z","avatar_url":"https://github.com/adpena.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TEA Data Engine\n\n**A high-performance, spatially-aware Python framework for the analysis and modeling of Texas public education data.**\n\n`teadata` provides a robust, object-oriented interface for large-scale geographic and demographic datasets. By utilizing a high-speed, snapshot-based architecture, the engine enables rapid data integration and sophisticated spatial querying through an intuitive, Pythonic DSL.\n\n---\n\n## 📚 Documentation\n\n**[Read the full documentation here](docs/index.md)** (or run `mkdocs serve` to browse locally).\n\n---\n\n## Quick Start\n\n### Installation\n\n**Using `uv` (Recommended for development)**\n\n```bash\ngit clone https://github.com/adpena/teadata.git\ncd teadata\nuv sync\n```\n\n**Using `pip`**\n\n```bash\npip install teadata\n```\n\nWhen adding a new library or tool, update `pyproject.toml` (dependencies or\nextras), refresh the lockfile, and adjust test/tooling configuration so CI and\nlocal environments stay in sync.\n\n**Installing from GitHub (for Render or other CI/CD)**\n\nIf you are using this in a Django application deployed on **Render**, add it to your `requirements.txt`:\n\n```text\nteadata @ git+https://github.com/adpena/teadata.git\n```\n\nOr install it directly via CLI:\n\n```bash\npip install git+https://github.com/adpena/teadata.git\n```\n\n### Snapshot assets (Git LFS)\n\nProduction deployments that install from GitHub often receive Git LFS pointer files instead of\nthe large snapshot assets. Set these URLs so the engine can download the real files on demand:\n\n- `TEADATA_SNAPSHOT_URL` (e.g., a GitHub release asset for `repo_*.pkl.gz`)\n- `TEADATA_MAP_STORE_URL` (for `map_payloads_*.sqlite`)\n- `TEADATA_BOUNDARY_STORE_URL` (for `boundaries_*.sqlite`)\n- Optional: `TEADATA_ASSET_CACHE_DIR` to control where downloads are cached\n\n### Usage\n\n```python\nfrom teadata import DataEngine\n\n# Fast-path: load the latest discovered snapshot\nengine = DataEngine.from_snapshot(search=True)\n\n# Retrieve district by TEA campus number\naldine = engine.get_district(\"101902\")\nprint(aldine.name)  # -\u003e \"Aldine ISD\"\n\n# Iterate campuses inside the district\nfor c in aldine.campuses:\n    print(c.name)\n```\n\n## Release Policy\n\n- Tags always use the thousandths place (e.g., `v0.0.101`, `v0.0.102`). If no tags exist, start at `v0.0.101`.\n- Keep only the three most recent tags/releases; delete older tags and their GitHub release assets.\n\n## Features\n\n- **Rich domain objects**: `District` and `Campus` with geometry.\n- **Fluent query language**: Chain filters like `engine \u003e\u003e (\"district\", \"101902\") \u003e\u003e (\"campuses_in\",)`.\n- **Spatial acceleration**: Nearest neighbors, containment checks.\n- **Enrichment**: Attach external datasets (finance, accountability) easily.\n\n## License\n\nThis project is licensed under the **Business Source License 1.1**.\n\n- **Personal \u0026 Educational Use**: You may use, copy, modify, and distribute this software for personal, educational, or non-commercial research purposes.\n- **Commercial \u0026 Production Use**: Prohibited without obtaining a separate commercial license from the Licensor.\n\nSee the [LICENSE](LICENSE) file for the full text.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadpena%2Fteadata","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadpena%2Fteadata","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadpena%2Fteadata/lists"}