runcode 0.2__py3-none-any.whl → 0.3.0__py3-none-any.whl

runcode/__init__.py

@@ -1 +1,83 @@
-from .runner import Runner
+"""runcode is now onlinecompiler. This release keeps runcode.Runner working through the onlinecompiler client.
+
+New code should use the client directly:
+
+    from onlinecompiler import OnlineCompiler
+"""
+
+from __future__ import annotations
+
+import warnings
+from typing import Any
+
+from onlinecompiler import OnlineCompiler, Queued
+
+__version__ = "0.3.0"
+__all__ = ["Runner", "OnlineCompiler"]
+
+# The compiler ids runcode 0.2.1 offered, mapped to the current version of each language.
+# None means the language is no longer offered.
+_CURRENT_IDS: dict[str, str | None] = {
+    "python-3.9.7": "python-3.14",
+    "gcc-4.9": "gcc-15",
+    "g++-4.9": "g++-15",
+    "openjdk-11": "openjdk-25",
+    "dotnet-5": "dotnet-csharp-10",
+    "python-2.7.18": None,
+    "php-8.1": "php-8.5",
+    "fsharp-5": "dotnet-fsharp-10",
+    "ruby-3.0.2": "ruby-4.0",
+}
+
+
+class Runner:
+    """The runcode 0.2.1 API, sent through onlinecompiler's queued run (POST /api/run-code/)."""
+
+    python39 = "python-3.9.7"
+    gcc49 = "gcc-4.9"
+    cpp49 = "g++-4.9"
+    openjdk11 = "openjdk-11"
+    dotnet5 = "dotnet-5"
+    python27 = "python-2.7.18"
+    php81 = "php-8.1"
+    fsharp5 = "fsharp-5"
+    ruby30 = "ruby-3.0.2"
+
+    def __init__(self, api_key: str = "", callback_url: str = ""):
+        """api_key defaults to Django's settings.RUNCODE_API_KEY, as before, then to the
+        ONLINECOMPILER_API_KEY environment variable. Get a key at https://onlinecompiler.io."""
+        warnings.warn(
+            "runcode is now onlinecompiler: use `from onlinecompiler import OnlineCompiler`. "
+            "runcode.Runner keeps working through it.",
+            DeprecationWarning,
+            stacklevel=2,
+        )
+        if not api_key:
+            try:
+                from django.conf import settings
+
+                api_key = getattr(settings, "RUNCODE_API_KEY", "") or ""
+                callback_url = callback_url or getattr(settings, "RUNCODE_CALLBACK_URL", "") or ""
+            except Exception:
+                pass
+        self.api_key = api_key
+        self.callback_url = callback_url
+        if callback_url:
+            warnings.warn(
+                "callback_url is not sent: results go to the callback URL set on your API key in the "
+                "onlinecompiler.io dashboard.",
+                UserWarning,
+                stacklevel=2,
+            )
+        self.client = OnlineCompiler(api_key or None)
+
+    def execute(self, code: str, input: str, compiler: str, extra_params: dict[str, Any] | None = None) -> Queued:
+        """Queue a run and return at once with its id ({"status": ..., "id": ...}). The result is
+        POSTed to the callback URL set on your API key in the onlinecompiler.io dashboard, with
+        extra_params echoed back. Raises onlinecompiler.OnlineCompilerError if the run is refused."""
+        if compiler in _CURRENT_IDS:
+            current = _CURRENT_IDS[compiler]
+            if current is None:
+                raise ValueError(f"{compiler} is no longer offered. Runner.python39 runs Python 3.14.")
+            compiler = current
+        return self.client.submit(compiler, code, input, extra_params=extra_params or None)

runcode-0.3.0.dist-info/METADATA

@@ -0,0 +1,74 @@
+Metadata-Version: 2.5
+Name: runcode
+Version: 0.3.0
+Summary: runcode is now onlinecompiler: this release keeps runcode.Runner working through the OnlineCompiler.io client
+Project-URL: Homepage, https://onlinecompiler.io
+Project-URL: Documentation, https://pypi.org/project/onlinecompiler/
+Author: RunCode Inc.
+License-Expression: MIT
+License-File: LICENSE
+Keywords: code execution,compiler api,online compiler,onlinecompiler,runcode
+Classifier: Development Status :: 7 - Inactive
+Classifier: Intended Audience :: Developers
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3 :: Only
+Requires-Python: >=3.10
+Requires-Dist: onlinecompiler>=0.1.0
+Description-Content-Type: text/markdown
+
+# runcode is now onlinecompiler
+
+RunCode's code execution API is now [OnlineCompiler.io](https://onlinecompiler.io/?utm_source=pypi-runcode),
+and its Python client is [`onlinecompiler`](https://pypi.org/project/onlinecompiler/). New code should
+use it:
+
+```bash
+pip install onlinecompiler
+```
+
+```python
+from onlinecompiler import OnlineCompiler
+
+client = OnlineCompiler()  # reads ONLINECOMPILER_API_KEY
+
+result = client.run("python-3.14", "name = input()\nprint(f'Hello, {name}!')", input="Ada")
+print(result["output"])  # Hello, Ada!
+```
+
+It runs code in 46 languages and judges it against test cases, and it is free up to 100,000 runs a
+month. Get an API key at https://api.onlinecompiler.io/compilers/api-keys/.
+
+## Code written for runcode 0.2.1
+
+runcode 0.2.1 sent runs to app.runcode.io, which no longer answers. This release keeps the same
+`Runner` working through `onlinecompiler`, so old code runs again after `pip install -U runcode`:
+
+```python
+from runcode import Runner
+
+runner = Runner(api_key="YOUR_ONLINECOMPILER_API_KEY")
+queued = runner.execute(code="print(input())", input="hi", compiler=Runner.python39)
+print(queued["id"])
+```
+
+What changed:
+
+- The API key is an OnlineCompiler.io key. Without one, `Runner()` reads Django's
+  `settings.RUNCODE_API_KEY` as before, then the `ONLINECOMPILER_API_KEY` environment variable.
+- Results are POSTed to the callback URL set on your API key in the
+  [dashboard](https://api.onlinecompiler.io/compilers/api-keys/), with `extra_params` echoed back.
+  Set one there first: a key without a callback URL is refused. A `callback_url` passed to `Runner`
+  (or `RUNCODE_CALLBACK_URL`) is not sent, and `Runner` warns.
+- `execute` returns `{"status": ..., "id": ...}` for the queued run, and raises
+  `onlinecompiler.OnlineCompilerError` when the run is refused (a bad key, a limit), where 0.2.1
+  returned nothing.
+- The old compiler ids run on current versions: `python39` on Python 3.14, `gcc49` on GCC 15,
+  `cpp49` on G++ 15, `openjdk11` on OpenJDK 25, `dotnet5` on C# (.NET 10), `php81` on PHP 8.5,
+  `fsharp5` on F# (.NET 10) and `ruby30` on Ruby 4.0. Python 2.7 (`python27`) is no longer offered
+  and raises `ValueError`. Any current compiler id works too, such as `"rust-1.93"`; the full list is
+  at https://onlinecompiler.io/languages.
+- Python 3.10 or newer, and no `requests` dependency. The Django sample project is gone.
+
+`Runner` shows a `DeprecationWarning`. To get results in the response, judge against test cases,
+verify webhooks and more, move to `OnlineCompiler`: see the
+[onlinecompiler README](https://pypi.org/project/onlinecompiler/).

runcode-0.3.0.dist-info/RECORD

@@ -0,0 +1,5 @@
+runcode/__init__.py,sha256=I6optAMzkCrRmd1ILFyxeOeQjovCva5L0dsac33Giv4,3156
+runcode-0.3.0.dist-info/METADATA,sha256=eti3SMJkmBpfLSYJQDyTmoSJLibIsc_zBsg94-1KUAw,3346
+runcode-0.3.0.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+runcode-0.3.0.dist-info/licenses/LICENSE,sha256=ewJ8Ho-t36T048PVcYWDREgjhelKO_i5q2cH8pafvU0,1069
+runcode-0.3.0.dist-info/RECORD,,

{runcode-0.2.dist-info → runcode-0.3.0.dist-info}/WHEEL

@@ -1,5 +1,4 @@
 Wheel-Version: 1.0
-Generator: bdist_wheel (0.37.0)
+Generator: hatchling 1.33.0
 Root-Is-Purelib: true
 Tag: py3-none-any
-

{runcode-0.2.dist-info → runcode-0.3.0.dist-info/licenses}/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2020 RunCode
+Copyright (c) 2026 RunCode Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

runcode/runner.py

@@ -1,74 +0,0 @@
-import requests
-
-
-class Runner:
-
-    python39 = "python-3.9.7"
-    gcc49 = "gcc-4.9"
-    cpp49 = "g++-4.9"
-    openjdk11 = "openjdk-11"
-    dotnet5 = "dotnet-5"
-    python27 = "python-2.7.18"
-    php81 = "php-8.1"
-    fsharp5 = "fsharp-5"
-    ruby30 = "ruby-3.0.2"
-
-    def __init__(self, api_key="", callback_url=""):
-        """
-        Constructs and sends a :class:`Runner <Runner>`.
-        :param api_key: API Key to autheticate and process your request. You can get it in runcode.io dashboard.
-        :param callback_url: URL to receive executon results.
-        :return: :class:`Runner <Runner>` object
-        :rtype: runcode.Runner
-        Usage::
-        >>> from runcode import Runner
-        >>> runner = Runner(
-                api_key="{API_KEY}",
-                callback_url="{URL_TO_PROCESS_RESULT}",
-            )
-        """
-
-        if api_key == "":
-            try:
-                from django.conf import settings
-
-                self.api_key = settings.RUNCODE_API_KEY
-                self.callback_url = settings.RUNCODE_CALLBACK_URL
-            except:
-                pass
-        else:
-            self.api_key = api_key
-            self.callback_url = callback_url
-
-    def execute(self, code, input, compiler, extra_params={}):
-        """
-        Sends code and input to be executed by runcode platform.
-        :param code: Code to get executed.
-        :param input: input values for the code.
-        :compiler: Compiler to use to execute the code.
-        :extra_params: json dict to post extra parameters to identify the response or any other purpose
-        Usage::
-        >>> runner.execute(
-                code='''
-                print("Hello world")
-                start = input()
-                end = input()
-                for i in range(int(start), int(end)):
-                    print(i)
-                ''',
-                        input="1\n10",
-                        compiler=Runner.python39,
-            )
-        """
-
-        out = {
-            "api_key": self.api_key,
-            "code": code,
-            "input": input,
-            "compiler": compiler,
-            "callback_url": self.callback_url,
-            "extra_params": extra_params,
-        }
-
-        r = requests.post("https://app.runcode.io/api/run-code/", json=out)
-        # r = requests.post("http://localhost:8000/api/run-code/", json=out)

runcode-0.2.dist-info/METADATA

@@ -1,107 +0,0 @@
-Metadata-Version: 2.1
-Name: runcode
-Version: 0.2
-Summary: RunCode Python API
-Home-page: https://github.com/runcode-io/runcode-python
-Author: RunCode
-Author-email: hello@runcode.io
-License: UNKNOWN
-Platform: UNKNOWN
-Classifier: Intended Audience :: Developers
-Classifier: Operating System :: OS Independent
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.3
-Classifier: Programming Language :: Python :: 3.4
-Classifier: Programming Language :: Python :: 3.5
-Classifier: Programming Language :: Python :: 3.6
-Classifier: Programming Language :: Python :: 3.7
-Classifier: Programming Language :: Python :: 3.8
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Topic :: Software Development :: Internationalization
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: requests
-
-# RunCode Python API
-
-This API is as simaple as send your code and getting execution result. 
-
-Install 
-
-```
-pip install runcode
-```
-
-
-
-## Python Example
-```
-from runcode import Runner
-
-runner = Runner(
-    api_key="",
-    callback_url="",
-)
-
-runner.execute(
-        code="""
-print("Hello world")
-start = input()
-end = input()
-for i in range(int(start), int(end)):
-    print(i)
-""",
-        input="1\n10",
-        compiler=Runner.python39,
-    )
-    
-```
-You need to provide two parameters here.  
-api_key - you will get it from runcode.io dashboard after loging.  
-callback_url - Your application URL to process execution result.  
-compiler - You can choose any of the available compilers from RunCode docs.
-## Django Example
-```
-from runcode import Runner
-
-runner = Runner()
-
-runner.execute(
-        code="""
-print("Hello world")
-start = input()
-end = input()
-for i in range(int(start), int(end)):
-    print(i)
-""",
-        input="1\n10",
-        compiler=Runner.python39,
-    )
-```
-You need to specify compiler here.
-compiler - You can choose any of the available compilers from RunCode docs.
-
-You need to add two parameters to settings.py file.
-
-RUNCODE_API_KEY - you will get it from runcode.io dashboard after loging.  
-RUNCODE_CALLBACK_URL - Your application URL to process execution result. 
-
-### Available compilers
-```
-python39 = "python-3.9.7"
-gcc49 = "gcc-4.9"
-cpp49 = "g++-4.9"
-openjdk11 = "openjdk-11"
-dotnet5 = "dotnet-5"
-python27 = "python-2.7.18"
-php81 = "php-8.1"
-fsharp5 = "fsharp-5"
-ruby30 = "ruby-3.0.2"
-```
-
-
-For further support, contact hello@runcode.io 
-
-

runcode-0.2.dist-info/RECORD

@@ -1,13 +0,0 @@
-runcode/__init__.py,sha256=xh1VuKyxkfiHGWMvcornpA6bEAHfyASZ8d_OdIscccI,27
-runcode/runner.py,sha256=Hdkd4r3Q5iAN5vaW7W0PT72pWVuXM7D4fMOZDM9lb5Q,2372
-runcode_sample/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-runcode_sample/asgi.py,sha256=FNDZzHMw6CI90pXGh2nOhJxQNGeqYVTmBkNQEQY37VY,391
-runcode_sample/settings.py,sha256=OmxDYqUx00bHNXuzVJb2DIOWVja3_bkNvl8SvhSA1sM,3112
-runcode_sample/urls.py,sha256=R29rxCIFcfcAxE8Ywd9I-VpPLpoKnnKunN0cXSg8ZS4,211
-runcode_sample/views.py,sha256=kn8ShRWg9Ds7zpzyVIf11q5WCS-ZY6IZHHOWog0YzJQ,789
-runcode_sample/wsgi.py,sha256=yRTVA45vcvgAjF8AzGafzfQnDyBiT4wlJZBB4TcAD9U,391
-runcode-0.2.dist-info/LICENSE,sha256=-P34USQli1FfJzTwF154T4ZktMRyIMOuQbMW59mMNK0,1064
-runcode-0.2.dist-info/METADATA,sha256=cPyhMDhA3XzwXStjIvCh1pFHZjgld-a1p7wtzMoMTjE,2531
-runcode-0.2.dist-info/WHEEL,sha256=ewwEueio1C2XeHTvT17n8dZUJgOvyCWCt0WVNLClP9o,92
-runcode-0.2.dist-info/top_level.txt,sha256=WInQ7CXL9NEXoG0QE17ZTe0IN_TxEgVgsWaIMwogVW8,23
-runcode-0.2.dist-info/RECORD,,

runcode-0.2.dist-info/top_level.txt

@@ -1,2 +0,0 @@
-runcode
-runcode_sample

runcode_sample/asgi.py

@@ -1,16 +0,0 @@
-"""
-ASGI config for runcode project.
-
-It exposes the ASGI callable as a module-level variable named ``application``.
-
-For more information on this file, see
-https://docs.djangoproject.com/en/3.2/howto/deployment/asgi/
-"""
-
-import os
-
-from django.core.asgi import get_asgi_application
-
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'runcode.settings')
-
-application = get_asgi_application()

runcode_sample/settings.py

@@ -1,120 +0,0 @@
-import os
-from dotenv import load_dotenv
-from pathlib import Path
-
-load_dotenv()
-
-# Build paths inside the project like this: BASE_DIR / 'subdir'.
-BASE_DIR = Path(__file__).resolve().parent.parent
-
-
-# Quick-start development settings - unsuitable for production
-# See https://docs.djangoproject.com/en/3.2/howto/deployment/checklist/
-
-# SECURITY WARNING: keep the secret key used in production secret!
-SECRET_KEY = "django-insecure-k7#@^xuh868*a_md7yll@9(h+((za&gs8t!ybln6*qxb!2s$fo"
-
-# SECURITY WARNING: don't run with debug turned on in production!
-DEBUG = True
-
-ALLOWED_HOSTS = ["*"]
-
-
-# Application definition
-
-INSTALLED_APPS = [
-    "django.contrib.admin",
-    "django.contrib.auth",
-    "django.contrib.contenttypes",
-    "django.contrib.sessions",
-    "django.contrib.messages",
-    "django.contrib.staticfiles",
-]
-
-MIDDLEWARE = [
-    "django.middleware.security.SecurityMiddleware",
-    "django.contrib.sessions.middleware.SessionMiddleware",
-    "django.middleware.common.CommonMiddleware",
-    "django.middleware.csrf.CsrfViewMiddleware",
-    "django.contrib.auth.middleware.AuthenticationMiddleware",
-    "django.contrib.messages.middleware.MessageMiddleware",
-    "django.middleware.clickjacking.XFrameOptionsMiddleware",
-]
-
-ROOT_URLCONF = "runcode_sample.urls"
-
-TEMPLATES = [
-    {
-        "BACKEND": "django.template.backends.django.DjangoTemplates",
-        "DIRS": [],
-        "APP_DIRS": True,
-        "OPTIONS": {
-            "context_processors": [
-                "django.template.context_processors.debug",
-                "django.template.context_processors.request",
-                "django.contrib.auth.context_processors.auth",
-                "django.contrib.messages.context_processors.messages",
-            ],
-        },
-    },
-]
-
-WSGI_APPLICATION = "runcode_sample.wsgi.application"
-
-
-# Database
-# https://docs.djangoproject.com/en/3.2/ref/settings/#databases
-
-DATABASES = {
-    "default": {
-        "ENGINE": "django.db.backends.sqlite3",
-        "NAME": BASE_DIR / "db.sqlite3",
-    }
-}
-
-
-# Password validation
-# https://docs.djangoproject.com/en/3.2/ref/settings/#auth-password-validators
-
-AUTH_PASSWORD_VALIDATORS = [
-    {
-        "NAME": "django.contrib.auth.password_validation.UserAttributeSimilarityValidator",
-    },
-    {
-        "NAME": "django.contrib.auth.password_validation.MinimumLengthValidator",
-    },
-    {
-        "NAME": "django.contrib.auth.password_validation.CommonPasswordValidator",
-    },
-    {
-        "NAME": "django.contrib.auth.password_validation.NumericPasswordValidator",
-    },
-]
-
-
-# Internationalization
-# https://docs.djangoproject.com/en/3.2/topics/i18n/
-
-LANGUAGE_CODE = "en-us"
-
-TIME_ZONE = "UTC"
-
-USE_I18N = True
-
-USE_L10N = True
-
-USE_TZ = True
-
-
-# Static files (CSS, JavaScript, Images)
-# https://docs.djangoproject.com/en/3.2/howto/static-files/
-
-STATIC_URL = "/static/"
-
-# Default primary key field type
-# https://docs.djangoproject.com/en/3.2/ref/settings/#default-auto-field
-
-DEFAULT_AUTO_FIELD = "django.db.models.BigAutoField"
-
-RUNCODE_API_KEY = os.getenv("RUNCODE_API_KEY")
-RUNCODE_CALLBACK_URL = os.getenv("RUNCODE_CALLBACK_URL")

runcode_sample/urls.py

@@ -1,9 +0,0 @@
-from django.contrib import admin
-from django.urls import path
-from .views import test_index, run_code
-
-urlpatterns = [
-    path("admin/", admin.site.urls),
-    path("", test_index),
-    path("rc/", run_code),
-]

runcode_sample/views.py

@@ -1,33 +0,0 @@
-import json
-from django.http.response import HttpResponse
-from django.views.decorators.csrf import csrf_exempt
-from runcode import Runner
-
-
-def run_code(request):
-    # runner = Runner(
-    #     api_key="KMXQosOYD1Bmrg1OJg4PzaQyprVVXaYkCsv3HgTh",
-    #     callback_url="http://7a91-2405-201-c00a-e012-4abc-50aa-3eb3-71d5.ngrok.io",
-    # )
-    runner = Runner()
-    runner.execute(
-        code="""
-print("Hello world")
-start = input()
-end = input()
-for i in range(int(start), int(end)):
-    print(i)
-""",
-        input="1\n10",
-        compiler=Runner.python39,
-        extra_params={"ukey": "16"},
-    )
-
-    return HttpResponse("hi")
-
-
-@csrf_exempt
-def test_index(request):
-    received_json_data = json.loads(request.body)
-    print(received_json_data)
-    return HttpResponse("ok")

runcode_sample/wsgi.py

@@ -1,16 +0,0 @@
-"""
-WSGI config for runcode project.
-
-It exposes the WSGI callable as a module-level variable named ``application``.
-
-For more information on this file, see
-https://docs.djangoproject.com/en/3.2/howto/deployment/wsgi/
-"""
-
-import os
-
-from django.core.wsgi import get_wsgi_application
-
-os.environ.setdefault('DJANGO_SETTINGS_MODULE', 'runcode.settings')
-
-application = get_wsgi_application()