django-beta 0.2.0__py3-none-any.whl

beta/__init__.py

@@ -0,0 +1 @@
+VERSION = (0, 1, 0)

beta/admin.py

@@ -0,0 +1,12 @@
+from django.contrib import admin
+
+from beta.models import BetaSignup
+
+
+class BetaSignupAdmin(admin.ModelAdmin):
+    model = BetaSignup
+    list_filter = ("contacted", "registered")
+    search_fields = ("email", "first_name", "last_name")
+
+
+admin.site.register(BetaSignup, BetaSignupAdmin)

beta/apps.py

@@ -0,0 +1,11 @@
+from django.apps import AppConfig
+
+
+class BetaConfig(AppConfig):
+    name = "beta"
+    verbose_name = "Beta"
+    default_auto_field = "django.db.models.AutoField"
+
+    def ready(self):
+        # Importing the module connects the post_save signal handler.
+        from beta import listeners  # noqa: F401

beta/forms.py

@@ -0,0 +1,26 @@
+from django import forms
+from django.conf import settings
+
+from beta.models import BetaSignup
+
+
+class BetaSignupForm(forms.ModelForm):
+    def __init__(self, *args, **kwargs):
+        super().__init__(*args, **kwargs)
+        self.capture_first = getattr(settings, "BETA_CAPTURE_FIRST", False)
+        self.capture_both = getattr(settings, "BETA_CAPTURE_BOTH", False)
+
+        if self.capture_first:
+            self.fields.pop("last_name")
+            self.fields["first_name"].required = True
+
+        elif not self.capture_both:
+            self.fields.pop("first_name")
+            self.fields.pop("last_name")
+        else:
+            self.fields["first_name"].required = True
+            self.fields["last_name"].required = True
+
+    class Meta:
+        model = BetaSignup
+        exclude = ("contacted", "registered", "created")

beta/listeners.py

@@ -0,0 +1,17 @@
+from django.contrib.auth.models import User
+from django.db.models.signals import post_save
+
+from beta.models import BetaSignup
+
+
+def user_post_save_callback(sender, instance, created, **kwargs):
+    """Mark a user as registered if a real User object is created"""
+    if created:
+        matches = BetaSignup.objects.filter(email=instance.email)
+
+        if matches:
+            matches[0].registered = True
+            matches[0].save()
+
+
+post_save.connect(user_post_save_callback, sender=User)

beta/managers.py

@@ -0,0 +1,15 @@
+from django.db import models
+
+
+class BetaManager(models.Manager):
+    def contacted(self):
+        return self.get_queryset().filter(contacted=True)
+
+    def not_contacted(self):
+        return self.get_queryset().filter(contacted=False)
+
+    def registered(self):
+        return self.get_queryset().filter(registered=True)
+
+    def not_registered(self):
+        return self.get_queryset().filter(registered=False)

beta/migrations/0001_initial.py

@@ -0,0 +1,29 @@
+# Generated by Django 5.2.16 on 2026-07-30 20:52
+
+import django.utils.timezone
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+    initial = True
+
+    dependencies = []
+
+    operations = [
+        migrations.CreateModel(
+            name="BetaSignup",
+            fields=[
+                ("id", models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name="ID")),
+                ("first_name", models.CharField(blank=True, max_length=50, verbose_name="First Name")),
+                ("last_name", models.CharField(blank=True, max_length=75, verbose_name="Last Name")),
+                ("email", models.EmailField(max_length=254, unique=True, verbose_name="Email Address")),
+                ("contacted", models.BooleanField(default=False, verbose_name="Contacted")),
+                ("registered", models.BooleanField(default=False, verbose_name="Registered")),
+                ("created", models.DateTimeField(default=django.utils.timezone.now, verbose_name="Created")),
+            ],
+            options={
+                "verbose_name": "Beta Signup",
+                "verbose_name_plural": "Beta Signups",
+            },
+        ),
+    ]

beta/models.py

@@ -0,0 +1,29 @@
+from django.db import models
+from django.utils import timezone
+from django.utils.translation import gettext_lazy as _
+
+from beta.managers import BetaManager
+
+
+class BetaSignup(models.Model):
+    """
+    Model to store our pre-beta signups
+    """
+
+    first_name = models.CharField(_("First Name"), max_length=50, blank=True)
+    last_name = models.CharField(_("Last Name"), max_length=75, blank=True)
+    email = models.EmailField(_("Email Address"), unique=True)
+
+    contacted = models.BooleanField(_("Contacted"), default=False)
+    registered = models.BooleanField(_("Registered"), default=False)
+
+    created = models.DateTimeField(_("Created"), default=timezone.now)
+
+    objects = BetaManager()
+
+    class Meta:
+        verbose_name = _("Beta Signup")
+        verbose_name_plural = _("Beta Signups")
+
+    def __str__(self):
+        return f"Beta Signup - {self.email}"

beta/templates/beta/confirmation.html

@@ -0,0 +1,3 @@
+{% block content %}
+<h1>You have registered.</h1>
+{% endblock %}

beta/templates/beta/signup.html

@@ -0,0 +1,5 @@
+{% block content %}
+<form method="POST" action=".">{% csrf_token %}
+    {{ form }}
+</form>
+{% endblock %}

beta/urls.py

@@ -0,0 +1,8 @@
+from django.urls import path
+
+from beta.views import Confirmation, Signup
+
+urlpatterns = [
+    path("signup/", Signup.as_view(), name="beta_signup"),
+    path("signup/confirmed/", Confirmation.as_view(), name="beta_confirmation"),
+]

beta/views.py

@@ -0,0 +1,20 @@
+from django.urls import reverse
+from django.views import generic
+
+from beta.forms import BetaSignupForm
+
+
+class Signup(generic.CreateView):
+    """View to handle beta signup"""
+
+    template_name = "beta/signup.html"
+    form_class = BetaSignupForm
+
+    def get_success_url(self):
+        return reverse("beta_confirmation")
+
+
+class Confirmation(generic.TemplateView):
+    """Confirmation Page"""
+
+    template_name = "beta/confirmation.html"

django_beta-0.2.0.dist-info/METADATA

@@ -0,0 +1,102 @@
+Metadata-Version: 2.4
+Name: django-beta
+Version: 0.2.0
+Summary: django-beta is a reusable Django application for handling pre-beta signups.
+Project-URL: Homepage, https://github.com/revsys/django-beta/
+Author-email: Frank Wiles <frank@revsys.com>, Jeff Triplett <jeff@revsys.com>
+License-File: AUTHORS.txt
+License-File: LICENSE.txt
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Web Environment
+Classifier: Framework :: Django
+Classifier: Framework :: Django :: 4.2
+Classifier: Framework :: Django :: 5.0
+Classifier: Framework :: Django :: 5.1
+Classifier: Framework :: Django :: 5.2
+Classifier: Framework :: Django :: 6.0
+Classifier: Framework :: Django :: 6.1
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: BSD License
+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: Programming Language :: Python :: Free Threading :: 3 - Stable
+Requires-Python: >=3.10
+Provides-Extra: lint
+Requires-Dist: prek; extra == 'lint'
+Provides-Extra: test
+Requires-Dist: pytest; extra == 'test'
+Requires-Dist: pytest-cov; extra == 'test'
+Requires-Dist: pytest-django; extra == 'test'
+Provides-Extra: testing
+Requires-Dist: pytest; extra == 'testing'
+Requires-Dist: pytest-cov; extra == 'testing'
+Requires-Dist: pytest-django; extra == 'testing'
+Description-Content-Type: text/markdown
+
+# django-beta
+
+`django-beta` is a simple application to help you capture pre-beta interest
+with your sites.
+
+By default `django-beta` only captures a user's email address, however you
+can alternately set one of these two configuration options:
+
+- `BETA_CAPTURE_FIRST = True` will use a form and require the user to enter
+  their first name and email address.
+- `BETA_CAPTURE_BOTH = True` will use a form and require the user to enter
+  their first name, last name, and email address.
+
+## Installation
+
+Add `beta` to your `INSTALLED_APPS` and run migrations.
+
+Add the following to your `urls.py`:
+
+```python
+from django.urls import include, path
+
+urlpatterns = [
+    path("beta/", include("beta.urls")),
+]
+```
+
+Using the example templates provided in the code, create your customized beta
+signup templates.
+
+## Managers
+
+The `BetaSignup` model has the following manager methods to help out:
+
+```python
+BetaSignup.objects.contacted()
+BetaSignup.objects.not_contacted()
+BetaSignup.objects.registered()
+BetaSignup.objects.not_registered()
+```
+
+## Side Effects
+
+`django-beta` listens for a signal on User creation and marks the
+corresponding `BetaSignup` entry as `registered`.
+
+## Development
+
+This project uses [nox](https://nox.thea.codes/) and
+[just](https://github.com/casey/just) for testing and linting across a matrix
+of Python and Django versions.
+
+```shell
+just lint          # run pre-commit / ruff via prek
+just test          # run the full nox test matrix
+just test-latest   # run against the latest Python and Django
+```
+
+## TODO
+
+- Admin views to show beta registrations over time
+- Management commands to simplify emailing the interested users

django_beta-0.2.0.dist-info/RECORD

@@ -0,0 +1,18 @@
+beta/__init__.py,sha256=mlI_y0X-IT2W5YNCpifdqxRIOLiENCSyne4ULTKm044,20
+beta/admin.py,sha256=UACQoG2px9hr4GOBTZtIAAFKwod5FjjAGMMYQJYivwU,289
+beta/apps.py,sha256=5ZZgvc32EVGin566btu3xv77BuT8bUOhezfXCjNNTN8,304
+beta/forms.py,sha256=KhOZadiaOkTGQARV4OcHWv_K3PzNUvYGC7oVdxt5z9c,837
+beta/listeners.py,sha256=y6mpyi0BBSWtxD3nInIgmcaO6_VmTef9sN1_hmEajpI,496
+beta/managers.py,sha256=U61jWX8b90dZfVczw18T73EmwqsiruBUqli0dgzJhs0,415
+beta/models.py,sha256=20YOFnAdughi-CL1elZnV0ZM-cUH5qQsyBKh2jcnw8g,877
+beta/urls.py,sha256=l4LgdGsXN0Kfb87iYB6UnSmFS7Cmghl6U3_hz_Xm5wI,233
+beta/views.py,sha256=3wDd1Z48mQAo6A0I1Bs-FLS2tqNGwy6qkqkLOPQ1Iqc,443
+beta/migrations/0001_initial.py,sha256=HrN-wVMsTY7WRhvbfspDeFa-w_HUmwKtvA0Tf1zYfEQ,1202
+beta/migrations/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+beta/templates/beta/confirmation.html,sha256=SSjcZeIdZSspnu4PRD1yuR6VZRvkdR89AVeqdwoqGPA,65
+beta/templates/beta/signup.html,sha256=7N1BI2MNR9NHbIBqEs4XT0GfmxJ3dKuswEkz2gVuAnU,106
+django_beta-0.2.0.dist-info/METADATA,sha256=3m7vBoURLHfL9UfOW-WbhPkYc34sLUu8iK4jEPpiHLM,3292
+django_beta-0.2.0.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+django_beta-0.2.0.dist-info/licenses/AUTHORS.txt,sha256=-r87Jb1s2eRnqrW2gwWky-l0MC1fD594VdJmnKfJtiI,69
+django_beta-0.2.0.dist-info/licenses/LICENSE.txt,sha256=b8ociThOjvtXY17Pt31eVPz7zGdtT3Pv1FWnunVY3Hk,1554
+django_beta-0.2.0.dist-info/RECORD,,

django_beta-0.2.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any

django_beta-0.2.0.dist-info/licenses/AUTHORS.txt

@@ -0,0 +1 @@
+django-beta was originally created by Frank Wiles <frank@revsys.com>

django_beta-0.2.0.dist-info/licenses/LICENSE.txt

@@ -0,0 +1,27 @@
+Copyright (c) Revolution Systems, LLC and individual contributors.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without modification,
+are permitted provided that the following conditions are met:
+
+    1. Redistributions of source code must retain the above copyright notice,
+       this list of conditions and the following disclaimer.
+
+    2. Redistributions in binary form must reproduce the above copyright
+       notice, this list of conditions and the following disclaimer in the
+       documentation and/or other materials provided with the distribution.
+
+    3. Neither the name of django-beta nor the names of its contributors
+       may be used to endorse or promote products derived from this software
+       without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
+ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR
+ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON
+ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
+SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.