Skip to content

Divers outils pour faciliter le développement avec Flask et SQLAlchemy. Extension de Utils-Flask-SQLAlchemy pour les géométries.

License

Notifications You must be signed in to change notification settings

naturalsolutions/Utils-Flask-SQLAlchemy-Geo

 
 

Repository files navigation

Librairie "outil géographique" pour SQLAlchemy et Flask

Cette librairie fournit des outils pour faciliter le développement avec Flask et SQLAlchemy. Elle vient compléter la libraire Utils-Flask-SQLAlchemy en y ajoutant des fonctionnalités liées aux objets géographiques.

Package Python disponible sur https://pypi.org/project/utils-flask-sqlalchemy-geo/.

  • Les serialisers

    Le décorateur de classe @geoserializable permet la sérialisation JSON d'objets Python issus des classes SQLAlchemy. Il rajoute dynamiquement une méthode as_geofeature() aux classes qu'il décore. Cette méthode transforme l'objet de la classe en dictionnaire en transformant les types Python non compatibles avec le format JSON. Pour cela, elle se base sur les types des colonnes décrits dans le modèle SQLAlchemy. Cette methode permet d'obtenir un objet de type geofeature.

    Utilisation

    • utils_flask_sqla_geo.serializers.geoserializable

    Décorateur pour les modèles SQLA : Ajoute une méthode as_geofeature qui retourne un dictionnaire serialisable sous forme de Feature geojson.

    Fichier définition modèle :

      from geonature.utils.env import DB
      from utils_flask_sqla_geo.serializers import geoserializable
    
      @geoserializable
      class MyModel(DB.Model):
          __tablename__ = 'bla'
          ...
    

    fichier utilisation modele :

      instance = DB.session.query(MyModel).get(1)
      result = instance.as_geofeature()
    

Le décorateur de classe @shapeserializable permet la création de shapefiles issus des classes SQLAlchemy:

  • Ajoute une méthode as_list qui retourne l'objet sous forme de tableau (utilisé pour créer des shapefiles)
  • Ajoute une méthode de classe as_shape qui crée des shapefiles à partir des données passées en paramètre

Le décorateur de classe @geofileserializable permet la création de shapefiles ou geopackage issus des classes SQLAlchemy:

  • Ajoute une méthode as_list qui retourne l'objet sous forme de tableau (utilisé pour créer des shapefiles)
  • Ajoute une méthode de classe as_geofile qui crée des shapefiles ou des geopackage à partir des données passées en paramètre

Utilisation

  • utils_flask_sqla_geo.serializers.shapeserializable

Fichier définition modèle :

  from geonature.utils.env import DB

  from utils_flask_sqla_geo.serializers import shapeserializable


  @shapeserializable
  @geofileserializable
  class MyModel(DB.Model):
      __tablename__ = 'bla'
      ...

Fichier utilisation modele :

data = DB.session.query(MyShapeserializableClass).all()
MyShapeserializableClass.as_shape(
    geom_col='geom_4326',
    srid=4326,
    data=data,
    dir_path=str(ROOT_DIR / 'backend/static/shapefiles'),
    file_name=file_name
)
# OU 
MyShapeserializableClass.as_geofile(
    export_format="shp",
    geom_col='geom_4326',
    srid=4326,
    data=data,
    dir_path=str(ROOT_DIR / 'backend/static/shapefiles'),
    file_name=file_name
)
  • La classe FionaShapeService pour générer des shapesfiles

    • utils_flask_sqla_geo.utilsgeometry.FionaShapeService
    • utils_flask_sqla_geo.utilsgeometry.FionaGpkgService

    Classes utilitaires pour crer des shapefiles ou des geopackages.

    Les classes contiennent 3 méthode de classe:

    • create_fiona_struct(): crée la structure des fichers exports

      • Pour les shapefiles : 3 shapefiles (point, ligne, polygone) à partir des colonens et de la geom passé en paramètre
    • create_feature(): ajoute un enregistrement au(x) fichier(s)

    • save_files(): sauvegarde le(s) fichier(s) et crer un zip pour les shapefiles qui ont au moin un enregistrement

        data = DB.session.query(MySQLAModel).all()
      
        for d in data:
                FionaShapeService.create_fiona_struct(
                        db_cols=db_cols,
                        srid=current_app.config['LOCAL_SRID'],
                        dir_path=dir_path,
                        file_name=file_name,
                        col_mapping=current_app.config['SYNTHESE']['EXPORT_COLUMNS']
                )
        FionaShapeService.create_feature(row_as_dict, geom)
        FionaShapeService.save_files()
      
  • Les GenericTableGeo et les GenericQueryGeo

    Ces classes héritent des classes GenericTable et GenericQuery et permettent de gérer le données de type géométrie.

About

Divers outils pour faciliter le développement avec Flask et SQLAlchemy. Extension de Utils-Flask-SQLAlchemy pour les géométries.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 100.0%