eventbooking-cloud 0.1.0__tar.gz

eventbooking_cloud-0.1.0/.codex-egg-info/eventbooking_cloud.egg-info/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: eventbooking-cloud
+Version: 0.1.0
+Summary: Reusable AWS cloud workflow helpers for event booking applications.
+Author: Lakshmi
+License-Expression: MIT
+Project-URL: Homepage, https://pypi.org/project/eventbooking-cloud/
+Project-URL: Repository, https://github.com/lakshmikalavathi2004/cpp-project
+Keywords: aws,event-booking,dynamodb,sqs,sns,lambda,s3
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3>=1.28
+Dynamic: license-file
+
+# eventbooking-cloud
+
+`eventbooking-cloud` is a reusable Python library extracted from this project's AWS booking workflow. It helps applications coordinate the same core cloud services used in the app:
+
+- `DynamoDB` for booking records
+- `SQS` for queueing booking jobs
+- `AWS Lambda` for booking processing
+- `SNS` for email notifications
+- `S3` for ticket storage
+
+## Installation
+
+```bash
+pip install eventbooking-cloud
+```
+
+## What the library provides
+
+- A `BookingRequest` model for normalized booking input
+- A `BookingResult` model for normalized booking output
+- An `EventBookingCloudClient` class for:
+  - saving booking records to DynamoDB
+  - sending booking messages to SQS
+  - subscribing user emails to SNS
+  - invoking a booking Lambda function
+  - building a safe app ticket URL
+
+## Example
+
+```python
+from eventbooking_cloud import BookingRequest, EventBookingCloudClient
+
+client = EventBookingCloudClient(
+    region_name="us-east-1",
+    users_table="Users",
+    events_table="Events",
+    bookings_table="Bookings",
+    bucket_name="elasticbeanstalk-us-east-1-864148790210",
+    queue_name="BookingQueue",
+    topic_name="EventNotifications",
+    lambda_name="event-booking-processor",
+    app_base_url="https://example.com",
+)
+
+request = BookingRequest(
+    booking_id="booking-123",
+    event_id="event-456",
+    event_name="Kala Events",
+    username="lakshmi",
+    email="lakshmi@example.com",
+    ticket_access_token="secure-token",
+    booked_at="2026-04-15T08:00:00+00:00",
+)
+
+client.store_booking(request)
+client.enqueue_booking(request)
+client.subscribe_email(request.email)
+result = client.invoke_processor(request)
+
+print(result.ticket_url)
+```
+
+## Build for PyPI
+
+From the project root:
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+This creates:
+
+- `dist/*.tar.gz`
+- `dist/*.whl`
+
+## Upload to TestPyPI
+
+```bash
+python -m twine upload --repository testpypi dist/*
+```
+
+## Upload to PyPI
+
+```bash
+python -m twine upload dist/*
+```
+
+## Recommended PyPI checklist
+
+- Create a PyPI account
+- Create a TestPyPI account
+- Generate an API token
+- Use the API token with `twine`
+- Verify the package page after upload
+
+## Notes for your viva
+
+You can explain that the app itself is a Flask project, but the reusable AWS cloud workflow was separated into a Python package so the same booking logic can be reused in other projects and published through PyPI.

eventbooking_cloud-0.1.0/.codex-egg-info/eventbooking_cloud.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+setup.py
+./.codex-egg-info/eventbooking_cloud.egg-info/PKG-INFO
+./.codex-egg-info/eventbooking_cloud.egg-info/SOURCES.txt
+./.codex-egg-info/eventbooking_cloud.egg-info/dependency_links.txt
+./.codex-egg-info/eventbooking_cloud.egg-info/requires.txt
+./.codex-egg-info/eventbooking_cloud.egg-info/top_level.txt
+.codex-egg-info/eventbooking_cloud.egg-info/SOURCES.txt
+src/eventbooking_cloud/__init__.py
+src/eventbooking_cloud/client.py
+src/eventbooking_cloud/models.py

eventbooking_cloud-0.1.0/.codex-egg-info/eventbooking_cloud.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

eventbooking_cloud-0.1.0/.codex-egg-info/eventbooking_cloud.egg-info/requires.txt

@@ -0,0 +1 @@
+boto3>=1.28

eventbooking_cloud-0.1.0/.codex-egg-info/eventbooking_cloud.egg-info/top_level.txt

@@ -0,0 +1 @@
+eventbooking_cloud

eventbooking_cloud-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lakshmi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

eventbooking_cloud-0.1.0/PKG-INFO

@@ -0,0 +1,122 @@
+Metadata-Version: 2.4
+Name: eventbooking-cloud
+Version: 0.1.0
+Summary: Reusable AWS cloud workflow helpers for event booking applications.
+Author: Lakshmi
+License-Expression: MIT
+Project-URL: Homepage, https://pypi.org/project/eventbooking-cloud/
+Project-URL: Repository, https://github.com/lakshmikalavathi2004/cpp-project
+Keywords: aws,event-booking,dynamodb,sqs,sns,lambda,s3
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: boto3>=1.28
+Dynamic: license-file
+
+# eventbooking-cloud
+
+`eventbooking-cloud` is a reusable Python library extracted from this project's AWS booking workflow. It helps applications coordinate the same core cloud services used in the app:
+
+- `DynamoDB` for booking records
+- `SQS` for queueing booking jobs
+- `AWS Lambda` for booking processing
+- `SNS` for email notifications
+- `S3` for ticket storage
+
+## Installation
+
+```bash
+pip install eventbooking-cloud
+```
+
+## What the library provides
+
+- A `BookingRequest` model for normalized booking input
+- A `BookingResult` model for normalized booking output
+- An `EventBookingCloudClient` class for:
+  - saving booking records to DynamoDB
+  - sending booking messages to SQS
+  - subscribing user emails to SNS
+  - invoking a booking Lambda function
+  - building a safe app ticket URL
+
+## Example
+
+```python
+from eventbooking_cloud import BookingRequest, EventBookingCloudClient
+
+client = EventBookingCloudClient(
+    region_name="us-east-1",
+    users_table="Users",
+    events_table="Events",
+    bookings_table="Bookings",
+    bucket_name="elasticbeanstalk-us-east-1-864148790210",
+    queue_name="BookingQueue",
+    topic_name="EventNotifications",
+    lambda_name="event-booking-processor",
+    app_base_url="https://example.com",
+)
+
+request = BookingRequest(
+    booking_id="booking-123",
+    event_id="event-456",
+    event_name="Kala Events",
+    username="lakshmi",
+    email="lakshmi@example.com",
+    ticket_access_token="secure-token",
+    booked_at="2026-04-15T08:00:00+00:00",
+)
+
+client.store_booking(request)
+client.enqueue_booking(request)
+client.subscribe_email(request.email)
+result = client.invoke_processor(request)
+
+print(result.ticket_url)
+```
+
+## Build for PyPI
+
+From the project root:
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+This creates:
+
+- `dist/*.tar.gz`
+- `dist/*.whl`
+
+## Upload to TestPyPI
+
+```bash
+python -m twine upload --repository testpypi dist/*
+```
+
+## Upload to PyPI
+
+```bash
+python -m twine upload dist/*
+```
+
+## Recommended PyPI checklist
+
+- Create a PyPI account
+- Create a TestPyPI account
+- Generate an API token
+- Use the API token with `twine`
+- Verify the package page after upload
+
+## Notes for your viva
+
+You can explain that the app itself is a Flask project, but the reusable AWS cloud workflow was separated into a Python package so the same booking logic can be reused in other projects and published through PyPI.

eventbooking_cloud-0.1.0/README.md

@@ -0,0 +1,100 @@
+# eventbooking-cloud
+
+`eventbooking-cloud` is a reusable Python library extracted from this project's AWS booking workflow. It helps applications coordinate the same core cloud services used in the app:
+
+- `DynamoDB` for booking records
+- `SQS` for queueing booking jobs
+- `AWS Lambda` for booking processing
+- `SNS` for email notifications
+- `S3` for ticket storage
+
+## Installation
+
+```bash
+pip install eventbooking-cloud
+```
+
+## What the library provides
+
+- A `BookingRequest` model for normalized booking input
+- A `BookingResult` model for normalized booking output
+- An `EventBookingCloudClient` class for:
+  - saving booking records to DynamoDB
+  - sending booking messages to SQS
+  - subscribing user emails to SNS
+  - invoking a booking Lambda function
+  - building a safe app ticket URL
+
+## Example
+
+```python
+from eventbooking_cloud import BookingRequest, EventBookingCloudClient
+
+client = EventBookingCloudClient(
+    region_name="us-east-1",
+    users_table="Users",
+    events_table="Events",
+    bookings_table="Bookings",
+    bucket_name="elasticbeanstalk-us-east-1-864148790210",
+    queue_name="BookingQueue",
+    topic_name="EventNotifications",
+    lambda_name="event-booking-processor",
+    app_base_url="https://example.com",
+)
+
+request = BookingRequest(
+    booking_id="booking-123",
+    event_id="event-456",
+    event_name="Kala Events",
+    username="lakshmi",
+    email="lakshmi@example.com",
+    ticket_access_token="secure-token",
+    booked_at="2026-04-15T08:00:00+00:00",
+)
+
+client.store_booking(request)
+client.enqueue_booking(request)
+client.subscribe_email(request.email)
+result = client.invoke_processor(request)
+
+print(result.ticket_url)
+```
+
+## Build for PyPI
+
+From the project root:
+
+```bash
+python -m pip install --upgrade build twine
+python -m build
+python -m twine check dist/*
+```
+
+This creates:
+
+- `dist/*.tar.gz`
+- `dist/*.whl`
+
+## Upload to TestPyPI
+
+```bash
+python -m twine upload --repository testpypi dist/*
+```
+
+## Upload to PyPI
+
+```bash
+python -m twine upload dist/*
+```
+
+## Recommended PyPI checklist
+
+- Create a PyPI account
+- Create a TestPyPI account
+- Generate an API token
+- Use the API token with `twine`
+- Verify the package page after upload
+
+## Notes for your viva
+
+You can explain that the app itself is a Flask project, but the reusable AWS cloud workflow was separated into a Python package so the same booking logic can be reused in other projects and published through PyPI.

eventbooking_cloud-0.1.0/pyproject.toml

@@ -0,0 +1,37 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "eventbooking-cloud"
+version = "0.1.0"
+description = "Reusable AWS cloud workflow helpers for event booking applications."
+readme = "README.md"
+requires-python = ">=3.10"
+license = "MIT"
+authors = [
+  { name = "Lakshmi" }
+]
+keywords = ["aws", "event-booking", "dynamodb", "sqs", "sns", "lambda", "s3"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+]
+dependencies = [
+  "boto3>=1.28"
+]
+
+[project.urls]
+Homepage = "https://pypi.org/project/eventbooking-cloud/"
+Repository = "https://github.com/lakshmikalavathi2004/cpp-project"
+
+[tool.setuptools]
+package-dir = {"" = "src"}
+
+[tool.setuptools.packages.find]
+where = ["src"]

eventbooking_cloud-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

eventbooking_cloud-0.1.0/setup.py

@@ -0,0 +1,4 @@
+from setuptools import setup
+
+
+setup()

eventbooking_cloud-0.1.0/src/eventbooking_cloud/__init__.py

@@ -0,0 +1,8 @@
+from .client import EventBookingCloudClient
+from .models import BookingRequest, BookingResult
+
+__all__ = [
+    "BookingRequest",
+    "BookingResult",
+    "EventBookingCloudClient",
+]

eventbooking_cloud-0.1.0/src/eventbooking_cloud/client.py

@@ -0,0 +1,120 @@
+import json
+from typing import Any
+
+import boto3
+
+from .models import BookingRequest, BookingResult
+
+
+class EventBookingCloudClient:
+    def __init__(
+        self,
+        *,
+        region_name: str,
+        users_table: str,
+        events_table: str,
+        bookings_table: str,
+        bucket_name: str,
+        queue_name: str,
+        topic_name: str,
+        app_base_url: str,
+        lambda_name: str = "",
+        aws_access_key_id: str | None = None,
+        aws_secret_access_key: str | None = None,
+        aws_session_token: str | None = None,
+    ) -> None:
+        session_kwargs: dict[str, Any] = {"region_name": region_name}
+        if aws_access_key_id and aws_secret_access_key:
+            session_kwargs.update(
+                {
+                    "aws_access_key_id": aws_access_key_id,
+                    "aws_secret_access_key": aws_secret_access_key,
+                    "aws_session_token": aws_session_token,
+                }
+            )
+
+        self.session = boto3.Session(**session_kwargs)
+        self.region_name = region_name
+        self.users_table_name = users_table
+        self.events_table_name = events_table
+        self.bookings_table_name = bookings_table
+        self.bucket_name = bucket_name
+        self.queue_name = queue_name
+        self.topic_name = topic_name
+        self.lambda_name = lambda_name
+        self.app_base_url = app_base_url.rstrip("/")
+
+        self.dynamodb = self.session.resource("dynamodb")
+        self.s3 = self.session.client("s3")
+        self.sqs = self.session.client("sqs")
+        self.sns = self.session.client("sns")
+        self.lambda_client = self.session.client("lambda")
+
+        self.bookings_table = self.dynamodb.Table(self.bookings_table_name)
+
+    def get_topic_arn(self) -> str:
+        response = self.sns.create_topic(Name=self.topic_name)
+        return response["TopicArn"]
+
+    def build_ticket_view_url(self, booking_id: str, access_token: str) -> str:
+        return f"{self.app_base_url}/ticket/{booking_id}?token={access_token}"
+
+    def store_booking(self, request: BookingRequest) -> None:
+        self.bookings_table.put_item(Item=request.to_item())
+
+    def enqueue_booking(self, request: BookingRequest) -> bool:
+        try:
+            queue_url = self.sqs.get_queue_url(QueueName=self.queue_name)["QueueUrl"]
+            self.sqs.send_message(
+                QueueUrl=queue_url,
+                MessageBody=json.dumps(request.to_item()),
+            )
+            return True
+        except Exception:
+            return False
+
+    def subscribe_email(self, email: str) -> str | None:
+        try:
+            topic_arn = self.get_topic_arn()
+            response = self.sns.list_subscriptions_by_topic(TopicArn=topic_arn)
+            for subscription in response.get("Subscriptions", []):
+                if subscription.get("Protocol") == "email" and subscription.get("Endpoint") == email:
+                    return subscription.get("SubscriptionArn")
+
+            created = self.sns.subscribe(
+                TopicArn=topic_arn,
+                Protocol="email",
+                Endpoint=email,
+            )
+            return created.get("SubscriptionArn")
+        except Exception:
+            return None
+
+    def invoke_processor(self, request: BookingRequest) -> BookingResult:
+        fallback_url = self.build_ticket_view_url(request.booking_id, request.ticket_access_token)
+
+        if not self.lambda_name:
+            return BookingResult(
+                booking_id=request.booking_id,
+                message="Lambda processor name not configured.",
+                ticket_url=fallback_url,
+            )
+
+        response = self.lambda_client.invoke(
+            FunctionName=self.lambda_name,
+            InvocationType="RequestResponse",
+            Payload=json.dumps({"Records": [{"body": json.dumps(request.to_item())}]}).encode("utf-8"),
+        )
+
+        payload_stream = response.get("Payload")
+        raw_payload = payload_stream.read().decode("utf-8") if payload_stream else ""
+        parsed = json.loads(raw_payload) if raw_payload else {}
+        body = parsed.get("body", parsed)
+        if isinstance(body, str):
+            body = json.loads(body)
+
+        return BookingResult(
+            booking_id=body.get("booking_id", request.booking_id),
+            message=body.get("message", "Booking processed."),
+            ticket_url=body.get("ticket_url", fallback_url),
+        )

eventbooking_cloud-0.1.0/src/eventbooking_cloud/models.py

@@ -0,0 +1,31 @@
+from dataclasses import asdict, dataclass
+
+
+@dataclass(slots=True)
+class BookingRequest:
+    booking_id: str
+    event_id: str
+    event_name: str
+    username: str
+    email: str
+    ticket_access_token: str
+    booked_at: str
+    booking_status: str = "pending"
+    message_type: str = "NEW_BOOKING"
+
+    def to_item(self) -> dict:
+        item = asdict(self)
+        item["type"] = item.pop("message_type")
+        return item
+
+
+@dataclass(slots=True)
+class BookingResult:
+    booking_id: str
+    message: str
+    ticket_url: str | None = None
+    queue_sent: bool = False
+    subscription_arn: str | None = None
+
+    def to_dict(self) -> dict:
+        return asdict(self)