feat(client): bootstrap

Author: vmscw

CONTRIBUTING.md

@@ -0,0 +1,81 @@
+# Contribute to `scaleway-qaas-client`
+
+`scaleway-qaas-client` is Apache 2.0 licensed and accepts contributions via GitHub.
+This document will cover how to contribute to the project and report issues.
+
+## Topics
+
+- [Reporting Security Issues](#reporting-security-issues)
+- [Reporting Issues](#reporting-issues)
+- [Suggesting feature](#suggesting-feature)
+- [Contributing Code](#contributing-code)
+- [Community Guidelines](#community-guidelines)
+
+## Reporting security issues
+
+At Scaleway we take security seriously.
+If you have any issue regarding security, please notify us by sending an email to [security@scaleway.com](mailto:security@scaleway.com).
+
+Please _DO NOT_ create a GitHub issue.
+
+We will follow up with you promptly with more information and a plan for remediation.
+We currently do not offer a paid security bounty program, but we would love to send some Scaleway swag your way along with our deepest gratitude for your assistance in making Scaleway a more secure Cloud ecosystem.
+
+## Reporting issues
+
+A great way to contribute to the project is to send a detailed report when you encounter a bug.
+We always appreciate a well-written, thorough bug report, and will thank you for it!
+Before opening a new issue, we appreciate you reviewing open issues to see if there are any similar requests.
+If there is a match, thumbs up the issue with a 👍 and leave a comment if you have additional information.
+
+When reporting an issue, include the following:
+
+- The version of `scaleway-qaas-client` you are using
+- Python version
+- The target backend is applicable
+
+## Suggesting a feature
+
+When requesting a feature, some of the questions we want to answer are:
+
+- What value does this feature bring to end users?
+- How urgent is the need (nice to have feature or need to have)?
+- Does this align with the goals of `scaleway-qaas-client`?
+
+## Contributing code
+
+### Submit code
+
+To submit code:
+
+- Create a fork of the project
+- Create a topic branch from where you want to base your work (usually master)
+- Add tests to cover contributed code
+- Push your commit(s) to your topic branch on your fork
+- Open a pull request against `scaleway-qaas-client` master branch that follows [PR guidelines](#pull-request-guidelines)
+
+The maintainers of `scaleway-qaas-client` use a "Let's Get This Merged" (LGTM) message in the pull request to note that the commits are ready to merge.
+After one or more maintainer states LGTM, we will merge.
+If you have questions or comments on your code, feel free to correct these in your branch through new commits.
+
+### Pull Request Guidelines
+
+The goal of the following guidelines is to have Pull Requests (PRs) that are fairly easy to review and comprehend, and code that is easy to maintain in the future.
+
+- **Pull Request title should be clear** on what is being fixed or added to the code base.
+  If you are addressing an open issue, please start the title with "fix: #XXX" or "feature: #XXX"
+- **Keep it readable for human reviewers** and prefer a subset of functionality (code) with tests and documentation over delivering them separately
+- **Don't forget commenting code** to help reviewers understand
+- **Notify Work In Progress PRs** by prefixing the title with `[WIP]`
+- **Please, keep us updated.**
+  We will try our best to merge your PR, but please notice that PRs may be closed after 30 days of inactivity.
+
+Your pull request should be rebased against the current master branch. Please do not merge
+the current master branch in with your topic branch, nor use the Update Branch button provided
+by GitHub on the pull request page.
+
+Keep in mind only the **Pull Request Title** will be used as commit message as we stash all commits on merge.
+
+## Community guidelines
+
+Thank you for reading through all of this, if you have any question feel free to [reach us](README.md#reach-us)!

README.md

@@ -0,0 +1,87 @@
+# Scaleway Pyhon client for Quantum as a Service
+
+
+
+## Installation
+
+We encourage installing Scaleway provider via the pip tool (a Python package manager):
+
+```bash
+pip install scaleway-qaas-client
+```
+
+## Getting started
+
+To instantiate the ScalewayProvider, you need to have an access token and a project_id
+
+```python
+from qiskit import QuantumCircuit
+from qiskit_scaleway import ScalewayProvider
+
+provider = ScalewayProvider(
+    project_id="<your-scaleway-project-id>",
+    secret_key="<your-scaleway-secret-key>",
+)
+```
+
+Alternatively, the Scaleway Provider can discover your access token from environment variables or from your .env file
+
+```
+export QISKIT_SCALEWAY_PROJECT_ID="project_id"
+export QISKIT_SCALEWAY_API_TOKEN="token"
+```
+
+Then you can instantiate the provider without any arguments:
+
+```python
+from qiskit import QuantumCircuit
+from qiskit_scaleway import ScalewayProvider
+
+provider = ScalewayProvider()
+```
+
+Now you can have acces to the supported backends:
+
+
+```python
+# List all operational backends
+backends = provider.backends(operational=True)
+print(backends)
+
+# List all backends with a minimum number of qbits
+backends = provider.backends(min_num_qubits=35)
+print(backends)
+
+# Retrieve a backend by providing search criteria. The search must have a single match
+backend = provider.get_backend("aer_simulation_h100")
+```
+
+Define a quantum circuit and run it
+
+```python
+# Define a quantum circuit that produces a 4-qubit GHZ state.
+qc = QuantumCircuit(4)
+qc.h(0)
+qc.cx(0, 1)
+qc.cx(0, 2)
+qc.cx(0, 3)
+qc.measure_all()
+
+# Create and send a job to a new QPU's session (or on an existing one)
+result = backend.run(qc, method="statevector", shots=1000).result()
+
+if result.success:
+    print(result.get_counts())
+else:
+    print(result.to_dict()["error"])
+
+```
+
+## Development
+This repository is at its early stage and is still in active development. If you are looking for a way to contribute please read [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## Reach us
+We love feedback. Feel free to reach us on [Scaleway Slack community](https://slack.scaleway.com/), we are waiting for you on [#opensource](https://scaleway-community.slack.com/app_redirect?channel=opensource)..
+
+## License
+[License Apache 2.0](LICENSE)

scaleway_qaas_client/__init__.py

@@ -32,3 +32,4 @@
 from quantum_as_a_service_api_client.models import (
     ScalewayQaasV1Alpha1ProcessStatus as QaaSProcessStatus,
 )
+from .client import QaaSClient