Skip to main content
Archived

This project has been archived by its maintainers, and is no longer receiving any updates.

Py4research: A step-by-step tutorial on how to build a Python package for research

Py4research provides a thorough tutorial on how to build and upload a Python package for research, which is going to be presented at the "X Workshop do Programa de Pós-Graduação em Ciência da Computação". Apart from the tutorial itself, we also implemented a straightforward package to illustrate how to build its package.


Guidelines

  1. Every needed piece of information is elucidated in this README;
  2. Installation is also straightforward and well-explained;
  3. If there is a problem, please do not hesitate and call us.

Installation

The installation process is straightforward as the package is hosted at PyPI, and the dependencies are listed on the requirements.txt file. One can install the package with either command, as follows:

pip install py4research
pip install -r requirements.txt

Additionally, the source files for the lecture are presented in LaTeX. Thus, one might need an additional compiler or even Overleaf to build the files into a PDF file.


Getting Started

This section provides an overview of the "build your python package" tutorial and the main package description.

Tutorial

The tutorial is written in Portuguese in a slide-based format. The contents are available in the slides folder and compiled to PDF using a LaTeX compiler.

Py4research

Py4research is a standard package composed of a single math module composed of two sub-modules: clustering and random. Essentially, the idea is to provide a simple framework that can foster research and help the community deploy their official implementations to PyPI.


Support

It is inevitable to make mistakes or create some bugs. If there is any problem or concern, we will be available at this repository or gustavo.rosa@unesp.br.


Metadata

Release files for py4research 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for py4research 1.0.1
File Size Uploaded Provenance
py4research-1.0.1.tar.gz 4.4 kB Without provenance Details

Release files / py4research-1.0.1.tar.gz

Download URL py4research-1.0.1.tar.gz
Size 4.4 kB
Tags Source
SHA-256 checksum
How to use checksums
267d1963e0d2eb2568b9faeb0ea127b1a7aac711fa93069396803147cd2efe02
BLAKE2b-256 checksum
How to use checksums
33e8d51c3522e6b8feaf9974d64fa5414917b597508d6d94a0a4bdcbf9eb2825
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/3.1.1 pkginfo/1.5.0.1 requests/2.23.0 setuptools/46.1.3.post20200330 requests-toolbelt/0.9.1 tqdm/4.50.0 CPython/3.7.7

Security for py4research 1.0.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page