version 0.0.1b2

sinanbekar · sinanbekar · commit 55ee341c471c · 2022-01-12T15:10:53.000+03:00
diff --git a/.gitignore b/.gitignore
@@ -0,0 +1,73 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# PyBuilder
+.pybuilder/
+target/
+
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow
+__pypackages__/
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
diff --git a/LICENSE b/LICENSE
@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Sinan Bekar
+
+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.
diff --git a/README.md b/README.md
@@ -0,0 +1,102 @@
+## Python Laravel Queue
+
+Queue sync between Python and Laravel using Redis driver. You can process jobs dispatched from Laravel in Python.
+
+**NOTE: This package is in beta and only Redis is supported currently. Production usage is not recommended until stable release.**
+
+In the 1.0.0 stable version these implementations are planned:
+
+- Auto-discovery jobs in both Laravel and Python.
+- Auto-configuration by reading Laravel config in Python side.
+- More clean API.
+- Supporting more queue drivers.
+
+### Install
+
+```bash
+pip install python-laravel-queue
+```
+
+### Usage
+
+- Listen for jobs on Python:
+
+```python
+from python_laravel_queue import Queue as PlQueue
+from redis import Redis
+
+r = Redis(host='localhost', port=6379, db=0)
+queue_python = PlQueue(r, queue='python')
+
+@queue_python.handler
+def handle(data):
+    name = data['name'] # job name
+    data = data['data'] # job data
+    print('TEST: ' + data['a'] + ' ' + data['b'] + ' ' + data['c'])
+
+queue_python.listen()
+```
+
+- Sending jobs from Laravel :
+
+```php
+<?php
+$job = new \App\Jobs\TestJob('hi','send to','python');
+dispatch($job)->onQueue('python');
+```
+
+- Schedule a job to be run in Laravel from Python:
+
+```python
+from python_laravel_queue import Queue as PlQueue
+from redis import Redis
+
+r = Redis(host='localhost', port=6379, db=0)
+queue_laravel = PlQueue(r, queue='laravel')
+queue_laravel.push('App\\Jobs\\TestJob', {'a': 'hello', 'b': 'send to', 'c': 'laravel'})
+
+```
+
+**TestJob** in Laravel:
+
+```php
+<?php
+
+namespace App\Jobs;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Bus\Queueable;
+use Illuminate\Contracts\Queue\ShouldQueue;
+use Illuminate\Foundation\Bus\Dispatchable;
+use Illuminate\Queue\InteractsWithQueue;
+use Illuminate\Queue\SerializesModels;
+use Illuminate\Support\Facades\Log;
+
+class TestJob extends Job implements ShouldQueue
+{
+    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
+
+    public $a, $b, $c;
+
+    /**
+     * Create a new job instance.
+     *
+     * @return void
+     */
+    public function __construct ($a, $b, $c) {
+        $this->a = $a;
+        $this->b = $b;
+        $this->c = $c;
+    }
+
+    public function handle () {
+        Log::info('TEST: ' . $this->a . ' '. $this->b . ' ' . $this->c);
+    }
+}
+
+```
+
+- You need to :listen (or :work) the preferred queue name above to handle data sent from Python in Laravel.
+
+```bash
+php artisan queue:listen --queue=laravel
+```
diff --git a/pyproject.toml b/pyproject.toml
@@ -0,0 +1,6 @@
+[build-system]
+requires = [
+    "setuptools>=42",
+    "wheel"
+]
+build-backend = "setuptools.build_meta"
diff --git a/setup.cfg b/setup.cfg
@@ -0,0 +1,29 @@
+[metadata]
+name = python-laravel-queue
+version = 0.0.1b2
+author = Sinan Bekar
+author_email = sinanbekar.work@gmail.com
+description = Sync Laravel queue with Python.
+long_description = file: README.md
+long_description_content_type = text/markdown
+url = https://github.com/sinanbekar/python-laravel-queue
+project_urls =
+    Bug Tracker = https://github.com/sinanbekar/python-laravel-queue/issues
+classifiers =
+    Programming Language :: Python :: 3
+    License :: OSI Approved :: MIT License
+    Operating System :: OS Independent
+
+[options]
+package_dir =
+    = src
+packages = find:
+python_requires = >=3.6
+install_requires =
+    redis
+    pyee
+    
+    
+
+[options.packages.find]
+where = src
diff --git a/src/python_laravel_queue/__init__.py b/src/python_laravel_queue/__init__.py
@@ -0,0 +1,2 @@
+__version__ = "0.0.1b2"
+from .queue import Queue
diff --git a/src/python_laravel_queue/module/phpserialize.py b/src/python_laravel_queue/module/phpserialize.py
diff --git a/src/python_laravel_queue/queue.py b/src/python_laravel_queue/queue.py

Original file line number	Diff line number	Diff line change
`@@ -0,0 +1,2 @@`
	`1`	`+__version__ = "0.0.1b2"`
	`2`	`+from .queue import Queue`