Skip to content

Commit b6a1c09

Browse files
authored
Merge pull request #26 from redis-developer/chore/public-readiness
Chore/public readiness
2 parents 9e9eb52 + e0a0bc6 commit b6a1c09

7 files changed

Lines changed: 113 additions & 129 deletions

File tree

CONTRIBUTING.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# Contributing to sql-redis
2+
3+
Thanks for your interest in contributing! `sql-redis` is an early-stage,
4+
proof-of-concept SQL-to-Redis translator and we welcome bug reports, feature
5+
ideas, and pull requests from the community.
6+
7+
## Reporting bugs and requesting features
8+
9+
- Open a [GitHub issue](https://github.com/redis-developer/sql-redis/issues)
10+
describing the problem or idea.
11+
- For bug reports, include:
12+
- The SQL input that misbehaved.
13+
- The translated Redis command (`SQLQuery.redis_query_string()` output) or
14+
the actual results, plus what you expected.
15+
- The `sql-redis` and `redis` versions you're running.
16+
- For security-sensitive reports, follow [SECURITY.md](./SECURITY.md) instead
17+
of opening a public issue.
18+
19+
## Development setup
20+
21+
`sql-redis` uses [uv](https://docs.astral.sh/uv/) for dependency management
22+
and [hatchling](https://hatch.pypa.io/latest/) as the build backend.
23+
24+
```bash
25+
# Clone and install
26+
git clone https://github.com/redis-developer/sql-redis.git
27+
cd sql-redis
28+
uv sync
29+
30+
# Common tasks (see the Makefile for the full list)
31+
make format # black + isort
32+
make lint # format + mypy
33+
make test # pytest
34+
make test-cov # pytest with coverage
35+
make build # wheel + sdist
36+
```
37+
38+
Tests use [`testcontainers`](https://testcontainers.com/) to spin up an
39+
ephemeral Redis instance, so a local Docker daemon is required to run the
40+
full suite.
41+
42+
## Pull requests
43+
44+
1. Fork and create a branch off `main`.
45+
2. Make your change, including tests for any new behavior.
46+
3. Run `make lint test` and confirm everything passes.
47+
4. Open a pull request against `main`. Apply one of the
48+
[`auto:` labels](./.autorc) to indicate the intended version bump
49+
(`auto:major`, `auto:minor`, `auto:patch`, or `auto:skip-release`).
50+
Maintainers add `auto:release` when the change is ready to ship; the
51+
release workflow handles the version bump, tag, GitHub release, and
52+
PyPI publish automatically.
53+
54+
## Code style
55+
56+
- Black and isort are enforced via `make format` and pre-commit hooks.
57+
- Type hints required on new public APIs; `mypy` runs in CI.
58+
- Keep new modules focused and add tests in the corresponding `tests/test_*.py`.

LICENSE

Lines changed: 21 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,21 @@
1+
MIT License
2+
3+
Copyright (c) 2025-2026 Redis, Inc.
4+
5+
Permission is hereby granted, free of charge, to any person obtaining a copy
6+
of this software and associated documentation files (the "Software"), to deal
7+
in the Software without restriction, including without limitation the rights
8+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9+
copies of the Software, and to permit persons to whom the Software is
10+
furnished to do so, subject to the following conditions:
11+
12+
The above copyright notice and this permission notice shall be included in all
13+
copies or substantial portions of the Software.
14+
15+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21+
SOFTWARE.

PR_NOTES.md

Lines changed: 0 additions & 124 deletions
This file was deleted.

SECURITY.md

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
# Security Policy
2+
3+
## Reporting a Vulnerability
4+
5+
If you believe you have discovered a security vulnerability in `sql-redis`,
6+
please report it **privately** through GitHub's private vulnerability
7+
reporting:
8+
9+
1. Go to the [Security tab](https://github.com/redis-developer/sql-redis/security)
10+
of the repository.
11+
2. Click **Report a vulnerability**.
12+
3. Fill in the form with a description of the issue, reproduction steps,
13+
affected versions, and any suggested mitigations.
14+
15+
This sends the report directly to maintainers without making it public, and
16+
gives us a place to coordinate the fix and disclosure timeline with you.
17+
18+
**Please do not open a public GitHub issue or pull request** for security
19+
reports — that would disclose the vulnerability before a fix is available.
20+
21+
For non-security bugs and feature requests, regular
22+
[GitHub issues](https://github.com/redis-developer/sql-redis/issues) are the
23+
right place.
24+
25+
## Supported Versions
26+
27+
Security fixes are applied to the latest minor release on PyPI. Older minor
28+
releases are not patched; please upgrade to the latest version to receive
29+
fixes.
File renamed without changes.

pyproject.toml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@ name = "sql-redis"
33
# NOTE: The version below is automatically incremented by the release workflow - do not manually adjust it.
44
version = "0.5.0"
55
description = "SQL to Redis command translation utility"
6-
authors = [{ name = "Redis Inc.", email = "applied.ai@redis.com" }]
6+
authors = [{ name = "Redis Inc." }]
77
requires-python = ">=3.9,<3.14"
88
readme = "README.md"
99
license = "MIT"
@@ -27,8 +27,8 @@ dependencies = [
2727
]
2828

2929
[project.urls]
30-
Homepage = "https://github.com/redis/sql-redis"
31-
Repository = "https://github.com/redis/sql-redis"
30+
Homepage = "https://github.com/redis-developer/sql-redis"
31+
Repository = "https://github.com/redis-developer/sql-redis"
3232

3333
[build-system]
3434
requires = ["hatchling"]

uv.lock

Lines changed: 2 additions & 2 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)