{"id":37528308,"url":"https://github.com/nipsysdev/logos-storage-nim-bin","last_synced_at":"2026-02-19T02:30:36.851Z","repository":{"id":332220199,"uuid":"1124974158","full_name":"nipsysdev/logos-storage-nim-bin","owner":"nipsysdev","description":"Pre-built static binaries for Logos Storage","archived":false,"fork":false,"pushed_at":"2026-02-14T00:58:26.000Z","size":148,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-02-14T08:00:31.014Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/nipsysdev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-12-30T00:04:35.000Z","updated_at":"2026-02-05T02:04:18.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/nipsysdev/logos-storage-nim-bin","commit_stats":null,"previous_names":["nipsysdev/logos-storage-nim-bin"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/nipsysdev/logos-storage-nim-bin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nipsysdev%2Flogos-storage-nim-bin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nipsysdev%2Flogos-storage-nim-bin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nipsysdev%2Flogos-storage-nim-bin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nipsysdev%2Flogos-storage-nim-bin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/nipsysdev","download_url":"https://codeload.github.com/nipsysdev/logos-storage-nim-bin/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/nipsysdev%2Flogos-storage-nim-bin/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29601081,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-19T00:59:38.239Z","status":"online","status_checked_at":"2026-02-19T02:00:07.702Z","response_time":117,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-01-16T08:26:33.893Z","updated_at":"2026-02-19T02:30:31.842Z","avatar_url":"https://github.com/nipsysdev.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# logos-storage-nim-bin\n\n[![codecov](https://codecov.io/github/nipsysdev/logos-storage-nim-bin/graph/badge.svg?token=DFKTDP7U9B)](https://codecov.io/github/nipsysdev/logos-storage-nim-bin)\n\nPre-built static libraries for [logos-storage-nim](https://github.com/logos-storage/logos-storage-nim).\n\n## Why Use logos-storage-nim-bin?\n\nWhile the upstream [logos-storage-nim](https://github.com/logos-storage/logos-storage-nim) provides stable dynamic libraries (`.so`, `.dylib`, `.dll`), this repository offers **static libraries** (`.a`) with key advantages:\n\n- **Simplified Integration**: No need to manage dynamic library paths or runtime loading—just link against the `.a` files\n- **No Runtime Dependencies**: All dependencies (libnatpmp, libminiupnpc, libbacktrace) are bundled\n- **Maximum Compatibility**: Built with architecture-specific flags for broad CPU support\n- **Complete Bundle**: Includes all 4 required static libraries in one package\n\n## Release Types\n\nThis repository provides two types of releases:\n\n### Stable Releases\n\n- **Trigger**: Builds from upstream tagged releases (e.g., v0.2.5)\n- **Purpose**: Production-ready builds\n- **Tag Format**: Same as upstream tags\n\n### Nightly Pre-releases\n\n- **Trigger**: Daily builds from upstream master branch commits\n- **Purpose**: Latest development builds\n- **Tag Format**: `master-{commit_short}`\n\n## Supported Platforms\n\n### Linux\n\n- **x86_64 (amd64)**: `linux-amd64`\n- **ARM64 (aarch64)**: `linux-arm64`\n\n### macOS\n\n- **Apple Silicon (ARM64)**: `darwin-arm64`\n\n### Windows\n\n- **x86_64 (amd64)**: `windows-amd64`\n\n## Quick Start\n\nDownload the latest stable release from [GitHub Releases](https://github.com/nipsysdev/logos-storage-nim-bin/releases/latest).\n\nEach release contains:\n\n- `logos-storage-nim-\u003ctag\u003e-\u003cplatform\u003e.tar.gz` - Platform-specific archive (stable releases)\n- `logos-storage-nim-\u003cbranch\u003e-\u003ccommit\u003e-\u003cplatform\u003e.tar.gz` - Platform-specific archive (nightly releases)\n- `SHA256SUMS.txt` - Checksums for all archives\n\nExtract and verify:\n\n```bash\n# Stable release example\ntar -xzf logos-storage-nim-v0.2.5-linux-amd64.tar.gz\nsha256sum -c SHA256SUMS.txt\n\n# Nightly release example\ntar -xzf logos-storage-nim-master-60861d6a-linux-amd64.tar.gz\nsha256sum -c SHA256SUMS.txt\n```\n\nThe archive includes:\n\n- `libstorage.a` - Main storage library\n- `libnatpmp.a` - NAT-PMP library\n- `libminiupnpc.a` - MiniUPnP library\n- `libbacktrace.a` - Backtrace library\n- `libstorage.h` - Header file\n- `SHA256SUMS.txt` - SHA256 checksums for all files\n\n## Building from Source\n\n### Prerequisites\n\n- Python 3.14\n- Git\n- Make\n- GCC\n- ar\n\n**Windows**: Install MSYS2 from https://www.msys2.org/ and install required packages:\n\n```bash\npacman -S --needed base-devel mingw-w64-x86_64-gcc mingw-w64-x86_64-cmake mingw-w64-x86_64-make git\n```\n\n### Build\n\n```bash\n# Clone repository\ngit clone https://github.com/nipsysdev/logos-storage-nim-bin\ncd logos-storage-nim-bin\n\n# Build for host architecture (default: master branch)\nmake build\n\n# Build from specific branch\nBRANCH=\"release/0.2.5\" make build\n\n# Build from specific commit\nCOMMIT=\"abc123def456789abc123def456789abc123def\" make build\n\n# Build from specific tag\nTAG=\"v0.2.5\" make build\n```\n\n**Note**: `BRANCH`, `COMMIT`, and `TAG` are mutually exclusive. Specify only one.\n\n### Make Targets\n\n```bash\nmake build        # Build for host architecture\nmake clean        # Clean build artifacts\nmake clean-all    # Clean everything including dist/ and logos-storage-nim/\nmake ci-build     # Test build.yml workflow locally (requires act)\nmake ci-nightly   # Test nightly-release.yml workflow locally (requires act)\nmake ci-stable    # Test stable-release.yml workflow locally (requires act)\nmake help         # Show all targets\n```\n\n## Testing\n\n```bash\n# Install test dependencies\npip install -r requirements-test.txt\n\n# Run all tests\npytest\n\n# Run with coverage\npytest --cov=src --cov-report=html\n```\n\n## CI/CD\n\n- **Build**: Runs on push to `main` and on any PRs\n- **Nightly Release**: Runs daily at 00:00 UTC and on push to main. Creates pre-releases for new upstream commits\n- **Stable Release**: Runs daily at 00:00 UTC and on push to main. Creates releases for new upstream tags\n- **Stable Refresh**: Checks daily and refreshes stable releases older than 89 days\n\n## Versioning\n\n### Nightly Releases\n\nFormat: `\u003cbranch\u003e-\u003ccommit-hash\u003e`\n\nExample: `master-60861d6a` means built from logos-storage-nim branch `master` at commit `60861d6a`.\n\n### Stable Releases\n\nFormat: `\u003ctag\u003e`\n\nExample: `v0.2.5` means built from logos-storage-nim tag `v0.2.5`.\n\n## License\n\nMIT - see [LICENSE](LICENSE) file.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnipsysdev%2Flogos-storage-nim-bin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnipsysdev%2Flogos-storage-nim-bin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnipsysdev%2Flogos-storage-nim-bin/lists"}