Skip to main content

A Python SDK for France Travail API

Project description

France Travail API Python SDK

Continuous Integration Continuous Delivery codecov PyPI version

A high-level Python SDK to interact with the France Travail API.

Quick start

Installation

python3 venv .france-travail-api
source .france-travail-api/bin/activate
pip install france-travail-api

Authentication

The SDK handles the OAuth2 Client Credentials Grant flow to authenticate with the API.

Get your API credentials (FRANCE_TRAVAIL_CLIENT_ID and FRANCE_TRAVAIL_CLIENT_SECRET) from the France Travail API developer portal.

Usage

from france_travail_api.client import FranceTravailClient
from france_travail_api.auth.scope import Scope

with FranceTravailClient(
    client_id="your_id",
    client_secret="your_secret",
    scopes=[Scope.OFFRES]
) as client:
    job_offers =client.offres.search(mots_cles="developpeur")

Contributing

Unix-like systems (GNU/Linux, macOS, etc.)

You need to have curl and uv installed on your system.

Then run the following command : curl -sSL https://raw.githubusercontent.com/cmnemoi/france-travail-api/main/clone-and-install | bash

Development

You can run tests with make test.

To run integration tests, you need to set FRANCE_TRAVAIL_CLIENT_ID and FRANCE_TRAVAIL_CLIENT_SECRET environment variables.

License

The source code of this repository is licensed under the Apache License 2.0.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

france_travail_api-1.6.0.tar.gz (126.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

france_travail_api-1.6.0-py3-none-any.whl (36.0 kB view details)

Uploaded Python 3

File details

Details for the file france_travail_api-1.6.0.tar.gz.

File metadata

  • Download URL: france_travail_api-1.6.0.tar.gz
  • Upload date:
  • Size: 126.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for france_travail_api-1.6.0.tar.gz
Algorithm Hash digest
SHA256 3273446e562b242f224a64b6ca904f61ec224da0a76a2d36c2d5554ef6062717
MD5 ad3df7113034ac79e2065e5bc0a2cee7
BLAKE2b-256 296a9155c32ccba4733baa66b1223e84b57eca353c9fdaf22b5b4e9971f0d395

See more details on using hashes here.

File details

Details for the file france_travail_api-1.6.0-py3-none-any.whl.

File metadata

  • Download URL: france_travail_api-1.6.0-py3-none-any.whl
  • Upload date:
  • Size: 36.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.9.21 {"installer":{"name":"uv","version":"0.9.21","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for france_travail_api-1.6.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8e7fc6a613ca61421122164a677a896b43df727130afa649e2aaa8d5f42b1046
MD5 b737f1f6fbbcf42300227384de17ea20
BLAKE2b-256 483e52df0d265cc275f5c68c7c77c5ac0a346d6aa0938a46e6167566f1e0f86a

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page