pyrosper 0.1.0.post12__tar.gz

pyrosper-0.1.0.post12/.github/workflows/publish.yml

@@ -0,0 +1,55 @@
+name: Publish to PyPI
+
+on:
+  release:
+    types: [published]
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0  # Important for setuptools-scm to work properly
+        # Use GITHUB_TOKEN (automatically provided) or PAT if you prefer
+        token: ${{ secrets.GITHUB_TOKEN }}
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+    
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine setuptools-scm
+    
+    - name: Generate version file
+      run: |
+        # Generate the version.py file using setuptools-scm
+        python -c "
+        import setuptools_scm
+        from setuptools_scm import dump_version
+        version = setuptools_scm.get_version()
+        dump_version('.', version, 'src/version.py')
+        "
+    
+    - name: Commit version file
+      run: |
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+        git add src/version.py
+        git commit -m "Update version.py for release" || echo "No changes to commit"
+        git push origin HEAD:${{ github.ref_name }}
+    
+    - name: Build package
+      run: python -m build
+    
+    - name: Publish to PyPI
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: twine upload dist/* 

pyrosper-0.1.0.post12/.github/workflows/python-package.yml

@@ -0,0 +1,79 @@
+name: Python Package
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements-dev.txt
+        pip install pytest
+
+    - name: Run tests
+      run: pytest
+    - name: Check types with pyright
+      run: pyright src
+    - name: Check types with pytype
+      run: pytype src
+
+  build:
+    runs-on: ubuntu-latest
+    needs: test
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+
+    - name: Install build tools
+      run: |
+        python -m pip install --upgrade pip
+        pip install build
+
+    - name: Build package
+      run: python -m build
+
+  publish:
+    runs-on: ubuntu-latest
+    needs: build
+    if: github.event_name == 'push' && startsWith(github.ref, 'refs/tags/')
+
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v3
+
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: "3.11"
+
+    - name: Install Twine
+      run: python -m pip install twine
+
+    - name: Publish to PyPI
+      env:
+        TWINE_USERNAME: ${{ secrets.PYPI_USERNAME }}
+        TWINE_PASSWORD: ${{ secrets.PYPI_PASSWORD }}
+      run: python -m twine upload dist/*

pyrosper-0.1.0.post12/.github/workflows/test-publish.yml

@@ -0,0 +1,100 @@
+name: Test Publish Workflow
+
+on:
+  workflow_dispatch:
+    inputs:
+      test_version:
+        description: 'Test version to use (e.g., 0.1.1)'
+        required: true
+        default: '0.1.1'
+      dry_run:
+        description: 'Dry run (do not actually publish)'
+        required: false
+        default: true
+        type: boolean
+
+jobs:
+  test-publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    
+    steps:
+    - uses: actions/checkout@v4
+      with:
+        fetch-depth: 0
+        token: ${{ secrets.GITHUB_TOKEN }}
+    
+    - name: Set up Python
+      uses: actions/setup-python@v4
+      with:
+        python-version: '3.11'
+    
+    - name: Install build dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install build twine setuptools-scm
+    
+    - name: Create test tag
+      run: |
+        git config --local user.email "action@github.com"
+        git config --local user.name "GitHub Action"
+        git tag -d v${{ inputs.test_version }} || true
+        git push origin :refs/tags/v${{ inputs.test_version }} || true
+        git tag v${{ inputs.test_version }}
+        git push origin v${{ inputs.test_version }}
+    
+    - name: Generate version file
+      run: |
+        # Generate the version.py file using setuptools-scm
+        python -c "
+        import setuptools_scm
+        from setuptools_scm import dump_version
+        version = setuptools_scm.get_version()
+        dump_version('.', version, 'src/version.py')
+        "
+    
+    - name: Show generated version
+      run: |
+        echo "Generated version file:"
+        cat src/version.py
+        echo ""
+        echo "Version from setuptools-scm:"
+        python -c "import setuptools_scm; print(setuptools_scm.get_version())"
+    
+    - name: Build package
+      run: |
+        python -m build
+        echo "Built packages:"
+        ls -la dist/
+    
+    - name: Test package contents
+      run: |
+        echo "Package contents:"
+        tar -tzf dist/*.tar.gz | head -20
+        echo ""
+        echo "Wheel contents:"
+        unzip -l dist/*.whl | head -20
+    
+    - name: Test PyPI upload (dry run)
+      if: inputs.dry_run
+      run: |
+        echo "Testing PyPI upload (dry run)..."
+        python -m twine check dist/*
+        echo "Package validation passed!"
+    
+    - name: Actually publish to PyPI
+      if: ${{ !inputs.dry_run }}
+      env:
+        TWINE_USERNAME: __token__
+        TWINE_PASSWORD: ${{ secrets.PYPI_API_TOKEN }}
+      run: |
+        echo "Publishing to PyPI..."
+        twine upload dist/*
+    
+    - name: Clean up test tag
+      if: always()
+      run: |
+        git tag -d v${{ inputs.test_version }} || true
+        git push origin :refs/tags/v${{ inputs.test_version }} || true 

pyrosper-0.1.0.post12/.gitignore

@@ -0,0 +1,4 @@
+build
+pyrosper.egg-info
+.idea
+__pycache__

pyrosper-0.1.0.post12/.pre-commit-config.yaml

@@ -0,0 +1,41 @@
+ci:
+  autoupdate_schedule: monthly
+
+repos:
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+  - repo: https://github.com/psf/black
+    rev: 25.1.0
+    hooks:
+    -   id: black
+  - repo: local
+    hooks:
+      - id: pytype
+        name: pytype
+        entry: pytype
+        language: python
+        types: [ python ]
+        args: [ "--config=pytype.toml" ]
+        pass_filenames: false
+        require_serial: true
+  - repo: https://github.com/NorthIsUp/pyright-pretty
+    rev: v0.1.0
+    hooks:
+      - id: pyright-pretty
+        args: [ "src" ]
+  - repo: https://github.com/timothycrosley/isort
+    rev: 6.0.1
+    hooks:
+      - id: isort
+        exclude: '^clients/'
+        args: [ "--profile", "black" ]
+  - repo: https://github.com/pre-commit/pre-commit-hooks
+    rev: v5.0.0
+    hooks:
+      - id: no-commit-to-branch
+        args: ['--branch', 'main']
+  - repo: https://github.com/econchick/interrogate
+    rev: 1.7.0
+    hooks:
+      - id: interrogate
+        args: [--config=pyproject.toml]

pyrosper-0.1.0.post12/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 BKKnights
+
+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.

pyrosper-0.1.0.post12/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: pyrosper
+Version: 0.1.0.post12
+Summary: A continuously improving, experimentation framework.
+Home-page: https://github.com/BKKnights/pyrosper
+Author: Robert Plummer
+Author-email: Robert Plummer <robertleeplummerjr@gmail.com>
+Project-URL: Homepage, https://github.com/BKKnights/pyrosper
+Project-URL: Bug Tracker, https://github.com/BKKnights/pyrosper/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+## `\\//,` pyrosper (pronounced "prosper")
+A continuously improving, experimentation framework.
+Now in python, ported from the [Typescript counterpart](https://github.com/BKKnights/prosper).
+
+### Installation
+TBD
+
+### Why
+pyrosper provides a means of:
+* injecting intelligently selected experimental code that is shorted lived
+* using multi armed bandit machine learning to selected which experimental code is injected
+* prevents code churn where long-lived code belongs
+
+The non-pyrosper way:
+* Uses feature flagging
+* Favors code churn, with highly fractured experimentation
+* Constantly effects test coverage
+* Provides a very blurry understanding of the code base when experimenting
+
+The pyrosper way:
+* Use experiments rather than Features Flags
+  * Picture one master switch, rather than a many small switches
+  * Code for each variant lives close together, within an experiment
+* Favors short-lived experimental code, that accentuates long-lived code
+  * Once understandings from a variant is known, then it can be moved from short-lived (experiment) to long-lived (source)
+* Meant to churn as little as possible.
+* Provides a very clear understanding of the code base when experimenting
+
+
+### Examples
+TBD
+
+...Vulcan's are cool.
+
+
+TODO:
+* Make package
+* Create pip install launchdarkly-server-sdk project
+* 

pyrosper-0.1.0.post12/README.md

@@ -0,0 +1,39 @@
+## `\\//,` pyrosper (pronounced "prosper")
+A continuously improving, experimentation framework.
+Now in python, ported from the [Typescript counterpart](https://github.com/BKKnights/prosper).
+
+### Installation
+TBD
+
+### Why
+pyrosper provides a means of:
+* injecting intelligently selected experimental code that is shorted lived
+* using multi armed bandit machine learning to selected which experimental code is injected
+* prevents code churn where long-lived code belongs
+
+The non-pyrosper way:
+* Uses feature flagging
+* Favors code churn, with highly fractured experimentation
+* Constantly effects test coverage
+* Provides a very blurry understanding of the code base when experimenting
+
+The pyrosper way:
+* Use experiments rather than Features Flags
+  * Picture one master switch, rather than a many small switches
+  * Code for each variant lives close together, within an experiment
+* Favors short-lived experimental code, that accentuates long-lived code
+  * Once understandings from a variant is known, then it can be moved from short-lived (experiment) to long-lived (source)
+* Meant to churn as little as possible.
+* Provides a very clear understanding of the code base when experimenting
+
+
+### Examples
+TBD
+
+...Vulcan's are cool.
+
+
+TODO:
+* Make package
+* Create pip install launchdarkly-server-sdk project
+* 

pyrosper-0.1.0.post12/pyproject.toml

@@ -0,0 +1,43 @@
+[metadata]
+name = "pyrosper"
+
+[project]
+name = "pyrosper"
+dynamic = ["version"]
+description = "A continuously improving, experimentation framework."
+readme = "README.md"
+authors = [
+    { name = "Robert Plummer", email = "robertleeplummerjr@gmail.com" }
+]
+requires-python = '>=3.11'
+
+[project.urls]
+    "Homepage" = "https://github.com/BKKnights/pyrosper"
+    "Bug Tracker" = "https://github.com/BKKnights/pyrosper/issues"
+
+[tool.interrogate]
+fail-under = 80
+verbose = 1
+
+[tool.isort]
+profile = "black"
+line_length = 79
+
+[tool.pytest.ini_options]
+addopts = "-n auto"
+
+[project.optional-dependencies]
+dev = [
+    "pytest",
+    "black",
+    "isort"
+]
+
+[build-system]
+requires = ["setuptools", "wheel", "setuptools-scm"]
+build-backend = "setuptools.build_meta"
+
+[tool.setuptools_scm]
+version_scheme = "post-release"
+local_scheme = "no-local-version"
+version_file = "src/version.py"

pyrosper-0.1.0.post12/pyrosper.egg-info/PKG-INFO

@@ -0,0 +1,60 @@
+Metadata-Version: 2.4
+Name: pyrosper
+Version: 0.1.0.post12
+Summary: A continuously improving, experimentation framework.
+Home-page: https://github.com/BKKnights/pyrosper
+Author: Robert Plummer
+Author-email: Robert Plummer <robertleeplummerjr@gmail.com>
+Project-URL: Homepage, https://github.com/BKKnights/pyrosper
+Project-URL: Bug Tracker, https://github.com/BKKnights/pyrosper/issues
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: isort; extra == "dev"
+Dynamic: author
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+## `\\//,` pyrosper (pronounced "prosper")
+A continuously improving, experimentation framework.
+Now in python, ported from the [Typescript counterpart](https://github.com/BKKnights/prosper).
+
+### Installation
+TBD
+
+### Why
+pyrosper provides a means of:
+* injecting intelligently selected experimental code that is shorted lived
+* using multi armed bandit machine learning to selected which experimental code is injected
+* prevents code churn where long-lived code belongs
+
+The non-pyrosper way:
+* Uses feature flagging
+* Favors code churn, with highly fractured experimentation
+* Constantly effects test coverage
+* Provides a very blurry understanding of the code base when experimenting
+
+The pyrosper way:
+* Use experiments rather than Features Flags
+  * Picture one master switch, rather than a many small switches
+  * Code for each variant lives close together, within an experiment
+* Favors short-lived experimental code, that accentuates long-lived code
+  * Once understandings from a variant is known, then it can be moved from short-lived (experiment) to long-lived (source)
+* Meant to churn as little as possible.
+* Provides a very clear understanding of the code base when experimenting
+
+
+### Examples
+TBD
+
+...Vulcan's are cool.
+
+
+TODO:
+* Make package
+* Create pip install launchdarkly-server-sdk project
+* 

pyrosper-0.1.0.post12/pyrosper.egg-info/SOURCES.txt

@@ -0,0 +1,30 @@
+.gitignore
+.pre-commit-config.yaml
+LICENSE
+README.md
+pyproject.toml
+pytest.ini
+pytype.toml
+requirements-dev.txt
+requirements.txt
+setup.py
+test_release.sh
+.github/workflows/publish.yml
+.github/workflows/python-package.yml
+.github/workflows/test-publish.yml
+pyrosper.egg-info/PKG-INFO
+pyrosper.egg-info/SOURCES.txt
+pyrosper.egg-info/dependency_links.txt
+pyrosper.egg-info/requires.txt
+pyrosper.egg-info/top_level.txt
+src/__init__.py
+src/base_experiment.py
+src/base_experiment_test.py
+src/mock_algorithm.py
+src/mock_experiment.py
+src/pyrosper.py
+src/pyrosper_test.py
+src/symbol.py
+src/user_variant.py
+src/variant.py
+src/version.py

pyrosper-0.1.0.post12/pyrosper.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

pyrosper-0.1.0.post12/pyrosper.egg-info/requires.txt

@@ -0,0 +1,5 @@
+
+[dev]
+pytest
+black
+isort

pyrosper-0.1.0.post12/pyrosper.egg-info/top_level.txt

@@ -0,0 +1 @@
+src

pyrosper-0.1.0.post12/pytest.ini

@@ -0,0 +1,3 @@
+[pytest]
+markers =
+    asyncio: for testing async code

pyrosper-0.1.0.post12/pytype.toml

@@ -0,0 +1,86 @@
+# NOTE: All relative paths are relative to the location of this file.
+
+[tool.pytype]
+
+# Space-separated list of files or directories to exclude.
+exclude = [
+    '**/*_test.py',
+]
+
+# Space-separated list of files or directories to process.
+inputs = [
+    './app',
+]
+
+# Keep going past errors to analyze as many files as possible.
+keep_going = true
+
+# Run N jobs in parallel. When 'auto' is used, this will be equivalent to the
+# number of CPUs on the host system.
+jobs = 4
+
+# All pytype output goes here.
+output = '.pytype'
+
+# Platform (e.g., "linux", "win32") that the target code runs on.
+platform = 'darwin'
+
+# Paths to source code directories, separated by ':'.
+pythonpath = '.'
+
+# Python version (major.minor) of the target code.
+python_version = '3.11'
+
+# Bind 'self' in methods with non-transparent decorators. This flag is temporary
+# and will be removed once this behavior is enabled by default.
+bind_decorated_methods = true
+
+# Enable parameter count checks for overriding methods with renamed arguments.
+# This flag is temporary and will be removed once this behavior is enabled by
+# default.
+overriding_renamed_parameter_count_checks = false
+
+# Variables initialized as None retain their None binding. This flag is
+# temporary and will be removed once this behavior is enabled by default.
+strict_none_binding = false
+
+# Support the third-party fiddle library. This flag is temporary and will be
+# removed once this behavior is enabled by default.
+use_fiddle_overlay = false
+
+# Opt-in: Do not allow Any as a return type.
+no_return_any = false
+
+# Opt-in: Require decoration with @typing.override when overriding a method or
+# nested class attribute of a parent class.
+require_override_decorator = false
+
+# Experimental: Infer precise return types even for invalid function calls.
+precise_return = true
+
+# Experimental: Solve unknown types to label with structural types.
+protocols = false
+
+# Experimental: Only load submodules that are explicitly imported.
+strict_import = false
+
+# Experimental: Enable exhaustive checking of function parameter types.
+strict_parameter_checks = false
+
+# Experimental: Emit errors for comparisons between incompatible primitive
+# types.
+strict_primitive_comparisons = false
+
+# Experimental: Check that variables are defined in all possible code paths.
+strict_undefined_checks = false
+
+# Experimental: FOR TESTING ONLY. Use pytype/rewrite/.
+use_rewrite = false
+
+# Space-separated list of error names to ignore.
+disable = [
+    'pyi-error',
+]
+
+# Don't report errors.
+report_errors = true

pyrosper-0.1.0.post12/requirements-dev.txt

@@ -0,0 +1,7 @@
+black
+isort
+pyright
+pytest
+pytest-mock
+pytest-asyncio
+pytype

pyrosper-0.1.0.post12/setup.cfg

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

pyrosper-0.1.0.post12/setup.py

@@ -0,0 +1,23 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="pyrosper",
+    use_scm_version={
+        "write_to": "src/version.py",  # This writes a version.py file on build
+        "write_to_template": '__version__ = "{version}"\n',
+    },
+    author="Robert Plummer",
+    author_email="robertleeplummerjr@gmail.com",
+    description="A continuously improving experimentation framework.",
+    long_description=open("README.md").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/BKKnights/pyrosper",
+    packages=find_packages(),
+    classifiers=[
+        "Programming Language :: Python :: 3",
+        "License :: OSI Approved :: MIT License",
+        "Operating System :: OS Independent",
+    ],
+    python_requires=">=3.11",
+    setup_requires=["setuptools-scm"],
+)