Metadata-Version: 2.4
Name: cfde-kc-fetch
Version: 0.2.0
Summary: Dataset fetcher for the CFDE Knowledge Center API
Author: Zeyu Yao
License-Expression: MIT
Project-URL: Homepage, https://github.com/cytronicoder/cfde-kc-fetch
Project-URL: Documentation, https://cfde.hugeampkpnbi.org/docs
Project-URL: Repository, https://github.com/cytronicoder/cfde-kc-fetch
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Topic :: Scientific/Engineering :: Bio-Informatics
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.25.0
Requires-Dist: urllib3>=1.26.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0.0; extra == "dev"
Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
Dynamic: license-file

# CFDE Knowledge Center Dataset Fetcher

A small CLI and library for downloading CFDE Knowledge Center single-cell artifacts and querying gene-level log-normalized expression.

This repository contains a brief README and a `docs/` directory with usage instructions, examples, and development notes. If you need detailed guidance, see `docs/usage.md` and `docs/examples.md`.

Quick links:

- Full usage: `docs/usage.md`
- Short examples: `docs/examples.md`
- API docs (Swagger UI): <https://cfde.hugeampkpnbi.org/docs>

Install from PyPI:

```bash
pip install cfde-kc-fetch
```

If you spot missing information or a confusing message in the tool, please open an issue with a minimal reproduction and the command you ran.

## Development & Testing

To run tests locally:

```bash
pip install -e ".[dev]"
pytest tests/
```

Project layout (essential):

- `cfde_kc_fetch/` — package code
- `tests/` — unit tests

## References

- CFDE Knowledge Center: <https://cfdeknowledge.org>
- API docs (Swagger UI): <https://cfde.hugeampkpnbi.org/docs>
- Single Cell Browser: <https://cfdeknowledge.org/single-cell/>

## License

MIT License - See LICENSE file for details.

## Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Submit a pull request

## Citation

If you use this tool in your research, please cite:

```bibtex
@software{cfde_kc_fetch,
  title = {CFDE Knowledge Center Dataset Fetcher},
  author = {Zeyu Yao},
  year = {2026},
  url = {https://github.com/cytronicoder/cfde-kc-fetch}
}
```
