Metadata-Version: 2.4
Name: gramps_gedcom7
Version: 0.3.1
Summary: A GEDCOM 7 support library for Gramps genealogy software
Author-email: David Straub <straub@protonmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/DavidMStraub/gramps-gedcom7
Project-URL: Repository, https://github.com/DavidMStraub/gramps-gedcom7
Project-URL: Issues, https://github.com/DavidMStraub/gramps-gedcom7/issues
Keywords: gedcom,gedcom7,gramps,genealogy
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Sociology :: Genealogy
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: gramps>=6.0.0
Requires-Dist: gedcom7>=0.5.0
Requires-Dist: click
Provides-Extra: streamlit
Requires-Dist: streamlit; extra == "streamlit"
Dynamic: license-file

# gramps-gedcom7

A GEDCOM 7 import library for Gramps.

## Project Status

The library provides comprehensive GEDCOM 7 import functionality. The implementation covers the vast majority of features and has been successfully tested with real-world files. While suitable for production use, users should verify results as with any conversion tool.

## Installation

To install the library, simply run:

```bash
python -m pip install gramps-gedcom7
```

Note that this will also install Gramps with `pip`, if it is not installed in your environment yet.

## Usage as command-line tool

The tool can be used to convert a GEDCOM 7 file to a Gramps XML file on the command line. The command is:

```bash
python -m gramps_gedcom7.gedcom2xml path/to/input.ged path/to/output.gramps
```

Instead of an output file name, you can also specify `-` to write the output to standard output.

## Usage as Gramps plugin

The tool cannot be used as a Gramps plugin yet, since its interaction with the Gedcom 5 core plugin is not clarified. See [this thread](https://github.com/gramps-project/addons-source/pull/744) for the discussion.

## Web interface

A [Streamlit](https://streamlit.io/) web interface is available for interactive use at [gramps-gedcom7.streamlit.app](https://gramps-gedcom7.streamlit.app/).

You can also run it locally:

```bash
python -m gramps_gedcom7.web
```

This opens a web browser where you can upload GEDCOM 7 files and download the converted Gramps XML files.
