Skip to main content

A webapp that fetches software version listings and presents them as download sites.

Project description

Socorepo, the SOftware COmponent REPOsitory exPOser, is a lightweight Python webapp that pulls software component listings from a variety of different sources and presents them as intuitive download sites to end users.

A production instance of the webapp is permanently embedded in https://loadingbyte.com, for example, at https://loadingbyte.com/socorepo/dl/. Try it out!

Features

  • Pulls software components from Nexus 3, GitHub, or PyPI repositories.
  • "Just works": Listings are sorted and classified by sensible and generic (yet configurable) standards.
  • Extremely lightweight: No external services like databases required.
  • Configured fully by simple config files.
  • Features a REST API.
  • 100% JavaScript-free. Doesn't employ any JavaScript in the browser.

Install

Socorepo can be installed from PyPI:

$ pip install socorepo

You can then quickly deploy Socorepo, e.g., using Gunicorn:

$ pip install gunicorn
$ gunicorn -b 127.0.0.1:4000 socorepo:app

Configure

When you just fire up Socorepo, it uses the default configuration files that it ships with. You probably want to edit these files. To do that, first extract the default configuration files using:

$ socorepo-default-config

This will copy the default configuration files into a new config/ folder in your shell's current directory. Now put that folder wherever you want. When you start Socorepo in the future, simply supply the path to your new config directory in the environment variable SOCOREPO_CONFIG_DIR:

$ SOCOREPO_CONFIG_DIR=/path/to/config/ gunicorn -b 127.0.0.1:4000 socorepo:app

All configuration files use the TOML configuration format.

The settings.toml file contains straightforward general settings which are explained in detail by the comments in that file. Meanwhile, the projects.toml file defines the software projects for which Socorepo presents download pages. When configuring Socorepo for the first time, start with these two files and use the extensive comments as a guide. The remaining .toml files you probably won't need to touch for starters.

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

socorepo-1.2.1.tar.gz (38.3 kB view details)

Uploaded Source

Built Distribution

socorepo-1.2.1-py3-none-any.whl (47.8 kB view details)

Uploaded Python 3

File details

Details for the file socorepo-1.2.1.tar.gz.

File metadata

  • Download URL: socorepo-1.2.1.tar.gz
  • Upload date:
  • Size: 38.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.15

File hashes

Hashes for socorepo-1.2.1.tar.gz
Algorithm Hash digest
SHA256 ba6e8c96593af0896806287456daef175df5fca95901c6ab46b21ab6ef26c6d7
MD5 7e1bdf4d7a20522b6ac202e347d7be94
BLAKE2b-256 4f4f1e9c1a1b2eeb2480ec471699f865bd068db237617592efc3dd9f641e251a

See more details on using hashes here.

Provenance

File details

Details for the file socorepo-1.2.1-py3-none-any.whl.

File metadata

  • Download URL: socorepo-1.2.1-py3-none-any.whl
  • Upload date:
  • Size: 47.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.15

File hashes

Hashes for socorepo-1.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 a5af376875a8468ca18b4af56c9050dd02e81068d592b4409b8e1ba99eadc8d9
MD5 751f37d630e15b8ebff6e882808a9eb4
BLAKE2b-256 e29932431847d122ccf3cf8c84a74a926bf0e07b618acba89ddde3b9ad3853a3

See more details on using hashes here.

Provenance

Supported by

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