> project-markers

Common project root markers.

It's just a JSON file, so you can use it in any environment.

Installation

pip install project-markers

Usage

import project_markers

print(project_markers)
# => ['.ansible-lint', '.bazelrc', '.browserslistrc', '.buckconfig', ...]

Note: Most type checkers will falsely warn project_markers is not iterable because they are incapable of analyzing runtime behavior (where the module is replaced w/ a list for cleaner, direct access). You can safely suppress such warnings using # type: ignore.

The list includes hundreds of markers from many tools and ecosystems, including:

Version control (.git, .hg, .svn)
Python (pyproject.toml, setup.py, requirements.txt)
JavaScript (package.json, yarn.lock, tsconfig.json)
Docker/K8s (Dockerfile, docker-compose.yml)
CI/CD (.github, .gitlab-ci.yml, Jenkinsfile)

MIT License

📂 find-project-root - Locate project root via custom markers.
📊 get-min-py - Get the minimum Python version required for a PyPI package.

More Python utilities / Discuss / Report bug / Report vulnerability

Download files

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

Source Distribution

project_markers-1.1.0.tar.gz (6.5 kB view details)

Uploaded Apr 28, 2026 Source

Built Distribution

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

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

project_markers-1.1.0-py2.py3-none-any.whl (6.2 kB view details)

Uploaded Apr 28, 2026 Python 2Python 3

File details

Details for the file project_markers-1.1.0.tar.gz.

File metadata

Download URL: project_markers-1.1.0.tar.gz
Upload date: Apr 28, 2026
Size: 6.5 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for project_markers-1.1.0.tar.gz
Algorithm	Hash digest
SHA256	`32a787bfff09312b3571b38d0a4b2e678093e399f9130ecb02cf0bdd6c888b85`
MD5	`eebf55f04eea3d89cb5765c1ded0fc27`
BLAKE2b-256	`029f8f09398633381b254fc2458e7d5a2dbe1096e1278be5f182c292902c544f`

See more details on using hashes here.

Provenance

The following attestation bundles were made for project_markers-1.1.0.tar.gz:

Publisher: publish-to-pypi-on-new-tag.yml on adamlui/python-utils

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: project_markers-1.1.0.tar.gz
- Subject digest: 32a787bfff09312b3571b38d0a4b2e678093e399f9130ecb02cf0bdd6c888b85
- Sigstore transparency entry: 1396113259
- Sigstore integration time: Apr 28, 2026
Source repository:
- Permalink: adamlui/python-utils@44a8f1b37928acd9b026b54ee15770f958059cd2
- Branch / Tag: refs/tags/project-markers-1.1.0
- Owner: https://github.com/adamlui
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish-to-pypi-on-new-tag.yml@44a8f1b37928acd9b026b54ee15770f958059cd2
- Trigger Event: release