フレームワークの概要

Morphフレームワークは、Pythonとマークダウンを用いてWebアプリケーションを構築するフレームワークです。アプリケーションのバックエンドをPythonで、フロントエンドをマークダウンで構築することができます。

ディレクトリ構成

フレームワークのディレクトリ構成は以下のようになっています。

workdir

.
├── src
│   ├── pages/
│   ├── python/
│   └── sql/
├── .env
├── Dockerfile
└── morph_project.yml

• src … データアプリのソースコードを配置するディレクトリ
  • pages … フロントエンドのMDXファイルを配置するディレクトリ
  • python … バックエンドのPythonファイルを配置するディレクトリ
  • sql … バックエンドのSQLファイルを配置するディレクトリ
• .env … 環境変数を設定するファイル
• Dockerfile … データアプリをDockerコンテナとしてビルドするためのファイル
• morph_project.yml … プロジェクトの設定を記述するファイル. フレームワークはmorph_project.ymlが配置されているディレクトリをルートディレクトリとして認識します。

これらに加えて、Pythonパッケージの管理用に requirements.txt か pyproject.toml が、JavaScriptパッケージの管理用に package.json が配置されます。

開発サーバーを起動する

データアプリの挙動を確認するために、開発サーバーを起動します。

Shell

morph serve

上記コマンドでサーバーの起動が成功したら、http://localhost:8080にアクセスすることでデータアプリにアクセスすることができます。

詳細なカスタマイズ

Morphには、データアプリをカスタマイズするための便利な機能が用意されています。 SQLやPythonで使用できる関数や機能を確認するためには、フレームワークリファレンスをご覧ください。 フロントエンド開発で使用できるMDXコンポーネントの詳細は、コンポーネントリファレンスをご覧ください。

最後に、準備ができてチームに共有する場合にはデプロイガイドをご覧ください。

エイリアス

Morphフレームワーク全体にまたがる概念であるエイリアスについて学びます。

バックエンドを構築する

Pythonでバックエンドを構築する方法について学びます。

フロントエンドを構築する

マークダウンでフロントエンドを構築する方法について学びます。

環境変数

環境変数でシークレット情報を管理する

DB/SaaSと接続する

DBやSaaSにアクセスをしたデータアプリを構築する

変数を使う

ユーザーインプットに応じて、データアプリの挙動をカスタマイズする

ロールベースのアクセス制御

ユーザーのプロジェクトロールを活用してデータのアクセス制御やアプリの挙動をカスタマイズする