fgdb-to-gpkg 0.3.1

A lightweight Python package that converts Esri File GeoDataBases into OGC GeoPackages

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

Installing from PyPI

# Recommended: Install globally using pipx
pipx install fgdb-to-gpkg

# Or install to a manually-created virtual environment
python -m venv env
./env/bin/pip install fgdb-to-gpkg

# Or install to the global Python environment
pip install fgdb-to-gpkg

Installing the development version of this package

1. Clone the repository: git clone https://github.com/philiporlando/fgdb_to_gdb.git
2. Navigate to the repository directory: cd fgdb_to_gdb
3. Install the package and its dependencies with poetry: poetry install
4. Optionally, install the package to be run globally with pipx: pipx install --editable .

Usage

Command Line Usage

To use 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:

fgdb-to-gpkg <input_fgdb_path> <output_gpkg_path>

See the help menu for more details:

fgdb-to-gpkg --help

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 the help menu for more details:

help(fgdb_to_gpkg)

Testing

Unit tests can be performed by the developers of this package using the following command:

poetry run pytest tests

Test coverage can be assessed using the following command:

poetry run pytest --cov=fgdb_to_gpkg --cov-report term-missing

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 how 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

Publishing

This package is automatically published to PyPI when a new release is crafted. For a successful publication, maintainers should:

1. Increment the version number in the pyproject.toml file. Ensure you update it in both the [project] and [project.dependencies] sections.

2. Adhere to vX.X.X the naming convention for the release name and tag.