gdal-installer


Namegdal-installer JSON
Version 1.0.2 PyPI version JSON
download
home_pagehttps://github.com/celray/python-gdal-installer
SummaryA tool to install GDAL wheels on Windows and wrapper for pip on Unix
upload_time2025-02-05 06:22:24
maintainerNone
docs_urlNone
authorCelray James CHAWANDA
requires_python>=3.10
licenseMIT
keywords gdal gis installer
VCS
bugtrack_url
requirements requests tqdm
Travis-CI No Travis.
coveralls test coverage No coveralls.
            You know installing gdal can be annoying especially on windows. That is where "Python GDAL Installer" comes in.

Check the code and contribute: <a href="https://github.com/celray/python-gdal-installer">https://github.com/celray/python-gdal-installer</a>

# Python GDAL Installer

A simple tool to automatically install GDAL Python bindings on Windows and Unix systems. This tool handles the complex process of installing GDAL with proper wheel files for Windows and manages pip installation for Unix systems.

## Features
- Automatic detection of Python version and CPU architecture
- Pre-compiled wheel installation for Windows systems
- Support for multiple Python versions (3.10-3.13)
- Support for different CPU architectures (win32, win_amd64, win_arm64)
- Fallback to pip installation on Unix systems

## Requirements
- Python 3.10 or higher
- pip package manager
- Internet connection
- Required Python packages:
  - requests
  - tqdm

## Installation

1. Install required packages:
```bash
pip install gdal-installer
```

2. Install python-gdal:
```bash
gdal-installer
```

## How It Works

### Windows Systems
- Detects Python version and CPU architecture
- Downloads appropriate GDAL wheel from pre-compiled binaries
- Installs the wheel using pip
- Shows download progress with a progress bar

### Unix Systems
- Uses pip to install GDAL directly from PyPI
- Installs to user site-packages using --user flag

## Supported Configurations

### Python Versions
- Python 3.10
- Python 3.11
- Python 3.12
- Python 3.13

### Windows Architectures
- win32 (32-bit)
- win_amd64 (64-bit)
- win_arm64 (ARM64) - except for python 3.10

## Troubleshooting

1. If you get a "No GDAL wheel found" error:
   - Verify your Python version is supported
   - Check if your CPU architecture is supported
   - Ensure you have internet connectivity

2. For Unix systems:
   - You might need to install GDAL system libraries first
   - Some systems might require `--break-system-packages` flag (not included by default)

## Contributing

Feel free to open issues or submit pull requests if you find bugs or have suggestions for improvements.

## License

MIT License

## Credits

GDAL wheels for Windows are sourced from [cgohlke/geospatial-wheels](https://github.com/cgohlke/geospatial-wheels).

            

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/celray/python-gdal-installer",
    "name": "gdal-installer",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "gdal, gis, installer",
    "author": "Celray James CHAWANDA",
    "author_email": "celray.chawanda@outlook.com",
    "download_url": "https://files.pythonhosted.org/packages/b0/3b/a024b6647f1e61bb60bb732a9525b4ead6e5b1b8f1b00ccc6f17c4e8e4ce/gdal_installer-1.0.2.tar.gz",
    "platform": null,
    "description": "You know installing gdal can be annoying especially on windows. That is where \"Python GDAL Installer\" comes in.\r\n\r\nCheck the code and contribute: <a href=\"https://github.com/celray/python-gdal-installer\">https://github.com/celray/python-gdal-installer</a>\r\n\r\n# Python GDAL Installer\r\n\r\nA simple tool to automatically install GDAL Python bindings on Windows and Unix systems. This tool handles the complex process of installing GDAL with proper wheel files for Windows and manages pip installation for Unix systems.\r\n\r\n## Features\r\n- Automatic detection of Python version and CPU architecture\r\n- Pre-compiled wheel installation for Windows systems\r\n- Support for multiple Python versions (3.10-3.13)\r\n- Support for different CPU architectures (win32, win_amd64, win_arm64)\r\n- Fallback to pip installation on Unix systems\r\n\r\n## Requirements\r\n- Python 3.10 or higher\r\n- pip package manager\r\n- Internet connection\r\n- Required Python packages:\r\n  - requests\r\n  - tqdm\r\n\r\n## Installation\r\n\r\n1. Install required packages:\r\n```bash\r\npip install gdal-installer\r\n```\r\n\r\n2. Install python-gdal:\r\n```bash\r\ngdal-installer\r\n```\r\n\r\n## How It Works\r\n\r\n### Windows Systems\r\n- Detects Python version and CPU architecture\r\n- Downloads appropriate GDAL wheel from pre-compiled binaries\r\n- Installs the wheel using pip\r\n- Shows download progress with a progress bar\r\n\r\n### Unix Systems\r\n- Uses pip to install GDAL directly from PyPI\r\n- Installs to user site-packages using --user flag\r\n\r\n## Supported Configurations\r\n\r\n### Python Versions\r\n- Python 3.10\r\n- Python 3.11\r\n- Python 3.12\r\n- Python 3.13\r\n\r\n### Windows Architectures\r\n- win32 (32-bit)\r\n- win_amd64 (64-bit)\r\n- win_arm64 (ARM64) - except for python 3.10\r\n\r\n## Troubleshooting\r\n\r\n1. If you get a \"No GDAL wheel found\" error:\r\n   - Verify your Python version is supported\r\n   - Check if your CPU architecture is supported\r\n   - Ensure you have internet connectivity\r\n\r\n2. For Unix systems:\r\n   - You might need to install GDAL system libraries first\r\n   - Some systems might require `--break-system-packages` flag (not included by default)\r\n\r\n## Contributing\r\n\r\nFeel free to open issues or submit pull requests if you find bugs or have suggestions for improvements.\r\n\r\n## License\r\n\r\nMIT License\r\n\r\n## Credits\r\n\r\nGDAL wheels for Windows are sourced from [cgohlke/geospatial-wheels](https://github.com/cgohlke/geospatial-wheels).\r\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "A tool to install GDAL wheels on Windows and wrapper for pip on Unix",
    "version": "1.0.2",
    "project_urls": {
        "Homepage": "https://github.com/celray/python-gdal-installer"
    },
    "split_keywords": [
        "gdal",
        " gis",
        " installer"
    ],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "72037179bec8baf0e9086bf84422ab55ef09aa2bdba10d4e4cd08b986920173b",
                "md5": "e9b063b3fc14eb43a2cf7abea53f5fce",
                "sha256": "ca5e9dc12f2428d12c970901d74fc167bec57fc929a36c80242f5b625a73d0bc"
            },
            "downloads": -1,
            "filename": "gdal_installer-1.0.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "e9b063b3fc14eb43a2cf7abea53f5fce",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 5333,
            "upload_time": "2025-02-05T06:22:22",
            "upload_time_iso_8601": "2025-02-05T06:22:22.362863Z",
            "url": "https://files.pythonhosted.org/packages/72/03/7179bec8baf0e9086bf84422ab55ef09aa2bdba10d4e4cd08b986920173b/gdal_installer-1.0.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "blake2b_256": "b03ba024b6647f1e61bb60bb732a9525b4ead6e5b1b8f1b00ccc6f17c4e8e4ce",
                "md5": "27e6dbec98ca88a76b150cde4994648b",
                "sha256": "a27773a01aa67e147815aa3dc8ec8c9d03d6c61683a1c9ece9b16663e5bec64b"
            },
            "downloads": -1,
            "filename": "gdal_installer-1.0.2.tar.gz",
            "has_sig": false,
            "md5_digest": "27e6dbec98ca88a76b150cde4994648b",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 4569,
            "upload_time": "2025-02-05T06:22:24",
            "upload_time_iso_8601": "2025-02-05T06:22:24.987269Z",
            "url": "https://files.pythonhosted.org/packages/b0/3b/a024b6647f1e61bb60bb732a9525b4ead6e5b1b8f1b00ccc6f17c4e8e4ce/gdal_installer-1.0.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-02-05 06:22:24",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "celray",
    "github_project": "python-gdal-installer",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": false,
    "requirements": [
        {
            "name": "requests",
            "specs": [
                [
                    ">=",
                    "2.25.0"
                ]
            ]
        },
        {
            "name": "tqdm",
            "specs": [
                [
                    ">=",
                    "4.62.0"
                ]
            ]
        }
    ],
    "lcname": "gdal-installer"
}
        
Elapsed time: 0.66653s