A lightweight Python package that converts Esri File GeoDataBases into OGC GeoPackages
Project description
fgdb_to_gpkg
fgdb_to_gpkg
is a Python package that converts all feature classes within an Esri File GeoDatabase to layers within a OGC GeoPackage. This package is designed to be used from the command line or imported as a module.
This package does not have a dependency on ArcPy, which means that you can safely extract feature classes locked inside an Esri File GeoDataBase without needing to worry about any ArcGIS licensing.
Installation
- Clone the repository:
git clone https://github.com/philiporlando/fgdb_to_gdb.git
- Navigate to the repository directory:
cd fgdb_to_gdb
- Install the package and its dependencies with poetry:
poetry install
# TODO add alternative installation instructions using pip?
pip install git+https://github.com/philiporlando/fgdb_to_gpkg
Usage
Command Line Usage
To use fgdb_to_gpkg
from the command line, simply call the fgdb_to_gpkg
command with the path to the input File GeoDatabase and the path to the output GeoPackage:
poetry run python -m fgdb_to_gpkg <input_fgdb_path> <output_gpkg_path>
Module Usage
You can also import fgdb_to_gpkg
as a module in Python and use it to convert any Esri File GeoDatabase feature classes to GeoPackage layers programmatically.
Here's an example of how to use fgdb_to_gpkg
as a module:
from fgdb_to_gpkg import fgdb_to_gpkg
input_fgdb_path = "/path/to/my_fgdb.gdb"
output_gpkg_path = "/path/to/my_gpkg.gpkg"
fgdb_to_gpkg(input_fgdb_path, output_gpkg_path)
# See help(fgdb_to_gpkg) for more details
Testing
Unit tests can be performed by the developers of this package using the following command:
poetry run pytest tests
Handling the Fiona GDAL compilation error
The unit tests within this package depend on gdal=^3.6.0
, but the current version of fiona
ships with gdal=3.5.3
. The fiona package must be installed using the --no-binary
flag to test this package. If this is not configured properly, then you will see the following error:
poetry run pytest tests
# fiona.errors.DriverError: OpenFileGDB driver requires at least GDAL 3.6.0 for mode 'w', Fiona was compiled against: 3.5.3
The poetry.toml
file should contain all of the config needed to tell poetry to handle this issue. However, if poetry install
does not resolve the issue, then try the following:
poetry run pip install --force-reinstall fiona --no-binary fiona
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for fgdb_to_gpkg-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f1103dd4fbd7b5922e4e6d85fb0262368628f26e570bf64fd29f1512f0fdfa56 |
|
MD5 | 1db9830fedf5cba6ab1721ddc5798b57 |
|
BLAKE2b-256 | 56ee70b80c957c19c8ccb8f809277036220187add6d7e774d87b522814fe76de |