{"id":26949683,"url":"https://github.com/numerous-com/numerous-sdk","last_synced_at":"2025-04-02T22:17:14.851Z","repository":{"id":237941748,"uuid":"785682005","full_name":"numerous-com/numerous-sdk","owner":"numerous-com","description":"Numerous SDK and CLI. Use the SDK for integrating your Python apps with Numerous so you can share them with users and use the features of the Numerous platform.","archived":false,"fork":false,"pushed_at":"2024-10-29T09:51:44.000Z","size":3203,"stargazers_count":5,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2024-10-29T09:53:28.496Z","etag":null,"topics":["apps","cloud-computing","paas","python","saas","saas-api","sdk","sdk-python"],"latest_commit_sha":null,"homepage":"https://www.numerous.com","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/numerous-com.png","metadata":{"files":{"readme":"docs/README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-04-12T11:55:52.000Z","updated_at":"2024-10-28T12:58:04.000Z","dependencies_parsed_at":"2024-05-29T12:03:14.408Z","dependency_job_id":"c290fde9-9434-4dd4-b173-525cdb15c0fc","html_url":"https://github.com/numerous-com/numerous-sdk","commit_stats":null,"previous_names":["numerous-com/numerous-sdk"],"tags_count":96,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numerous-com%2Fnumerous-sdk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numerous-com%2Fnumerous-sdk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numerous-com%2Fnumerous-sdk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/numerous-com%2Fnumerous-sdk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/numerous-com","download_url":"https://codeload.github.com/numerous-com/numerous-sdk/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246899655,"owners_count":20851899,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["apps","cloud-computing","paas","python","saas","saas-api","sdk","sdk-python"],"created_at":"2025-04-02T22:17:14.234Z","updated_at":"2025-04-02T22:17:14.835Z","avatar_url":"https://github.com/numerous-com.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Numerous Software Development Kit\n\n[![pypi badge](https://img.shields.io/pypi/v/numerous)](https://pypi.python.org/pypi/numerous)\n[![Validate workflow badge](https://github.com/numerous-com/numerous-sdk/actions/workflows/validate.yml/badge.svg)](https://github.com/numerous-com/numerous-sdk/actions/workflows/validate.yml)\n[![Release workflow badge](https://github.com/numerous-com/numerous-sdk/actions/workflows/release.yml/badge.svg)](https://github.com/numerous-com/numerous-sdk/actions/workflows/release.yml)\n![cli coverage badge](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/jfeodor/a9b9bfdfa0620696fba9e76223790f53/raw/cli-coverage.json)\n![sdk coverage badge](https://img.shields.io/endpoint?url=https://gist.githubusercontent.com/jfeodor/a9b9bfdfa0620696fba9e76223790f53/raw/sdk-coverage.json)\n\nWelcome to the Numerous Developer Documentation page!\n\nThis is the documentation for the Numerous SDK. If you are looking an overview of the\nNumerous platform, please visit the\n[Numerous platform documentation](https://numerous.com/docs).\n\n📥 To begin, install the SDK into your Python environment with:\n\n    pip install numerous\n\n🛠 The installation includes two main components: the CLI and the Numerous\nPython package.\n\n## Command Line Interface (CLI): A tool for managing your apps\n\nUse the CLI to deploy and manage apps on the Numerous platform:\n\n- `numerous init` - Create a new Numerous app\n- `numerous deploy` - Deploy your app to production\n\n## Python SDK package: Integrate Numerous features into Python-based web apps\n\nThe SDK enables you to interact with Numerous services programmatically in\nyour Python web applications.\n\n- Store and organize data (JSON documents, and files) with collections.\n- Access information about users and manage user interaction with sessions.\n\n# SDK Development\n\nThis section contains information about how to develop the SDK itself for\ndevelopers interested in contributing to the SDK.\n\nMost common tasks are defined in the `Makefile`. Use `make help` to get an\noverview.\n\nTo setup pre-commit hooks, use [pre-commit](https://pre-commit.com/)\nto setup hooks for linters and tests. This requires pre-commit to be installed and it is included in the Python SDK development dependencies.\n\nTo install pre-commit and pre-push hooks:\n\n    pre-commit install\n\nAnd you can run them on demand:\n\n    pre-commit run --all\n\n## Development of Python SDK 🐍\n\nCreate a virtual environment and activate it:\n\n    python -m venv ./venv\n    ./venv/bin/activate\n\nInstall the package in editable mode (including development dependencies):\n\n    pip install -e ./python[dev]\n\nRun the tests:\n\n    make sdk-test\n\nAnd the linters:\n\n    make sdk-lint\n\n## Development of Go CLI 🐹\n\nTo build, run `make cli-build`. The executable is stored as `build/numerous`.\n\nWhile developing, you can run the CLI like below:\n\n    # Run the CLI\n    go run .\n\n    # e.g.\n    go run . init\n    go run . dev\n\nYou can lint with:\n\n    make cli-lint\n\nAnd you can run tests with:\n\n    make cli-test\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumerous-com%2Fnumerous-sdk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnumerous-com%2Fnumerous-sdk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnumerous-com%2Fnumerous-sdk/lists"}