# LocalStack EventStudio
Visual UI to develop and debug event driven AWS services
You need a LocalStack Pro license to install and use extension and activate it via the variable `LOCALSTACK_AUTH_TOKEN` either in localstack config file or as an environment variable.
## Install extension to LocalStack
You can either add EXTENSION_AUTO_INSTALL="git+https://github.com/localstack/localstack-extension-event-studio/" to your localstack config file or run the following command:
```bash
localstack extensions install "git+https://<personal-private-access-token>@github.com/localstack/localstack-extension-event-studio/#egg=eventstudio"
```
Run the extension from the docker container via the following command:
```bash
PROVIDER_OVERRIDE_EVENTS=v2 EXTRA_CORS_ALLOWED_ORIGINS=* localstack start
```
you can see the extension running at https://localhost.localstack.cloud:4566/_extension/eventstudio/events directly
or via the LocalStack Web App under https://app.localstack.cloud/inst/default/extensions/manage
## Install local development version
First you need to create the `.env.development.local` file in the root of the project based on the `.env.example` file.
To install the extension into localstack in developer mode, you will need Python 3.11, and create a virtual environment in the extensions project, example using virtualenv:
```bash
virtualenv -p python3.11 .venv
source .venv/bin/activate
```
You will also need to install [yarn](https://yarnpkg.com/getting-started/install) as package manager if you haven't already, with corepack enabled.
Furthermore you need to have localstack and localstack-pro correctly set up in their respective source folders.
In the newly generated project, simply run
```bash
make install-dev
```
To check that the extension is installed correctly, you can run the following command:
```bash
make list-extension
```
You can then start LocalStack with `EXTENSION_DEV_MODE=1` to load all enabled extensions:
```bash
make start-extension
```
which is equivalent to:
```bash
EXTENSION_DEV_MODE=1 PROVIDER_OVERRIDE_EVENTS=v2 EXTRA_CORS_ALLOWED_ORIGINS=* localstack start
```
to access the frontend via the React dev server, you can run:
```bash
make start-frontend
```
You can access the frontend served from the extension directly under https://localhost.localstack.cloud:4566/_extension/eventstudio/events
or via the React dev server under http://localhost:3000/.
## Deploying sample application
The default sample application used for development and testing:
```bash
make deploy-test-stack && make put-event
```
Second sample application:
```bash
cd samples/fintech_demo
cdklocal bootstrap
cdklocal deploy
```
Raw data
{
"_id": null,
"home_page": null,
"name": "localstack-extension-event-studio",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.11",
"maintainer_email": null,
"keywords": "localstack, localstack-extension, extension",
"author": null,
"author_email": "Maximilian Hoheiser <max.hoheiser@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/0a/f9/c852e183825ddf58b70a7dee4d4bf47845a49112e43dfd3059314cd55f0f/localstack_extension_event_studio-0.0.1.dev1.tar.gz",
"platform": null,
"description": "# LocalStack EventStudio\n\nVisual UI to develop and debug event driven AWS services\n\nYou need a LocalStack Pro license to install and use extension and activate it via the variable `LOCALSTACK_AUTH_TOKEN` either in localstack config file or as an environment variable.\n\n## Install extension to LocalStack\n\nYou can either add EXTENSION_AUTO_INSTALL=\"git+https://github.com/localstack/localstack-extension-event-studio/\" to your localstack config file or run the following command:\n\n```bash\nlocalstack extensions install \"git+https://<personal-private-access-token>@github.com/localstack/localstack-extension-event-studio/#egg=eventstudio\"\n```\n\nRun the extension from the docker container via the following command:\n\n```bash\nPROVIDER_OVERRIDE_EVENTS=v2 EXTRA_CORS_ALLOWED_ORIGINS=* localstack start\n```\n\nyou can see the extension running at https://localhost.localstack.cloud:4566/_extension/eventstudio/events directly\nor via the LocalStack Web App under https://app.localstack.cloud/inst/default/extensions/manage\n\n## Install local development version\n\nFirst you need to create the `.env.development.local` file in the root of the project based on the `.env.example` file.\n\nTo install the extension into localstack in developer mode, you will need Python 3.11, and create a virtual environment in the extensions project, example using virtualenv:\n\n```bash\nvirtualenv -p python3.11 .venv\nsource .venv/bin/activate\n```\n\nYou will also need to install [yarn](https://yarnpkg.com/getting-started/install) as package manager if you haven't already, with corepack enabled.\nFurthermore you need to have localstack and localstack-pro correctly set up in their respective source folders.\nIn the newly generated project, simply run\n\n```bash\nmake install-dev\n```\n\nTo check that the extension is installed correctly, you can run the following command:\n\n```bash\nmake list-extension\n```\n\nYou can then start LocalStack with `EXTENSION_DEV_MODE=1` to load all enabled extensions:\n\n```bash\nmake start-extension\n```\n\nwhich is equivalent to:\n\n```bash\nEXTENSION_DEV_MODE=1 PROVIDER_OVERRIDE_EVENTS=v2 EXTRA_CORS_ALLOWED_ORIGINS=* localstack start\n```\n\nto access the frontend via the React dev server, you can run:\n\n```bash\nmake start-frontend\n```\n\nYou can access the frontend served from the extension directly under https://localhost.localstack.cloud:4566/_extension/eventstudio/events\nor via the React dev server under http://localhost:3000/.\n\n## Deploying sample application\n\nThe default sample application used for development and testing:\n\n```bash\nmake deploy-test-stack && make put-event\n```\n\nSecond sample application:\n\n```bash\ncd samples/fintech_demo\ncdklocal bootstrap\ncdklocal deploy\n```\n",
"bugtrack_url": null,
"license": "UNLICENSED",
"summary": "LocalStack Extension: eventstudio",
"version": "0.0.1.dev1",
"project_urls": {
"Homepage": "https://github.com/localstack/localstack-extension-event-studio"
},
"split_keywords": [
"localstack",
" localstack-extension",
" extension"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "1d4fed968f6d31dd944f6e0955b4c2cb7f9ab92fc1f9f53eff85ee1650cae613",
"md5": "da1e256956775a86a7a721807bcdb8ca",
"sha256": "ef23f352892879c4833ff35ab10ca9ba301d7c68f4ce660cfc9aeefd7428fdd5"
},
"downloads": -1,
"filename": "localstack_extension_event_studio-0.0.1.dev1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "da1e256956775a86a7a721807bcdb8ca",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.11",
"size": 24527096,
"upload_time": "2024-11-06T18:23:50",
"upload_time_iso_8601": "2024-11-06T18:23:50.764752Z",
"url": "https://files.pythonhosted.org/packages/1d/4f/ed968f6d31dd944f6e0955b4c2cb7f9ab92fc1f9f53eff85ee1650cae613/localstack_extension_event_studio-0.0.1.dev1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "0af9c852e183825ddf58b70a7dee4d4bf47845a49112e43dfd3059314cd55f0f",
"md5": "5b8417e24270f354b15ee73f4e0e35b8",
"sha256": "0cf5e273fb935bbdec7d2494a91ebfed657e4a4ea02f228ee47c5fa92e719b6f"
},
"downloads": -1,
"filename": "localstack_extension_event_studio-0.0.1.dev1.tar.gz",
"has_sig": false,
"md5_digest": "5b8417e24270f354b15ee73f4e0e35b8",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.11",
"size": 24140089,
"upload_time": "2024-11-06T18:24:05",
"upload_time_iso_8601": "2024-11-06T18:24:05.232797Z",
"url": "https://files.pythonhosted.org/packages/0a/f9/c852e183825ddf58b70a7dee4d4bf47845a49112e43dfd3059314cd55f0f/localstack_extension_event_studio-0.0.1.dev1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-06 18:24:05",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "localstack",
"github_project": "localstack-extension-event-studio",
"github_not_found": true,
"lcname": "localstack-extension-event-studio"
}
JSON
