{"id":34529123,"url":"https://github.com/covscript/cspkg","last_synced_at":"2026-03-16T05:07:24.667Z","repository":{"id":53483520,"uuid":"120056753","full_name":"covscript/cspkg","owner":"covscript","description":"Covariant Script Package Manager","archived":false,"fork":false,"pushed_at":"2025-09-28T12:59:11.000Z","size":258,"stargazers_count":4,"open_issues_count":0,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-09-28T14:52:16.121Z","etag":null,"topics":["covscript","package-manager"],"latest_commit_sha":null,"homepage":null,"language":"Batchfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/covscript.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":"2018-02-03T03:42:44.000Z","updated_at":"2025-09-28T12:59:14.000Z","dependencies_parsed_at":"2025-08-20T09:09:44.982Z","dependency_job_id":"419e24f6-fbd0-4ec5-97f2-64a8f7241f2b","html_url":"https://github.com/covscript/cspkg","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/covscript/cspkg","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/covscript%2Fcspkg","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/covscript%2Fcspkg/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/covscript%2Fcspkg/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/covscript%2Fcspkg/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/covscript","download_url":"https://codeload.github.com/covscript/cspkg/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/covscript%2Fcspkg/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30567023,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-16T04:42:47.996Z","status":"ssl_error","status_checked_at":"2026-03-16T04:42:44.668Z","response_time":96,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["covscript","package-manager"],"created_at":"2025-12-24T05:26:28.839Z","updated_at":"2026-03-16T05:07:24.662Z","avatar_url":"https://github.com/covscript.png","language":"Batchfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Covariant Script Package Manager\n\n\u003cimg src=\"./powered-by.png\" width=\"50%\"\u003e\n\nCovariant Script Package Manager is an online package manager written in Covariant Script itself.\n\n## Dependency\n+ [Covariant Script Interpreter](https://github.com/covscript/covscript): v3.4.1(STD210504) or newer version\n+ [CovScript Process](https://github.com/covscript/covscript-process)\n+ [CovScript Regex](https://github.com/covscript/covscript-regex)\n+ [CovScript Codec](https://github.com/covscript/covscript-codec)\n+ [CovScript cURL](https://github.com/covscript/covscript-curl)\n\n## Usage\n```\nUsage: cspkg \u003ccommands\u003e ... [options] ...\n\nCommands:\n    init                          Initialize cspkg environment and configuration\n    install   | -i  \u003cPackage\u003e...  Install packages from remote source\n    remove    | -r  \u003cPackage\u003e...  Remove packages\n    config    | -c  \u003cKey\u003e         Manage local configuration\n    upgrade   | -u                Upgrade local packages\n    build     | -b  [Path]        Build \u0026 test local packages\n    list      | -l                List current packages\n    help      | -h                Show help information\n    version   | -v                Show version information\n\nOptions:\n  General\n    --yes                         Cancel the prompt\n\n  cspkg install\n    --fix                         Fix broken dependencies\n    --import                      Scanning local CovScript packages\n    --show-avail                  Show available CovScript packages in remote source\n\n  cspkg upgrade\n    --retread                     Retread all local packages and their dependencies\n\n  cspkg config\n    --set         \u003cValue\u003e         Set a configuration key\n    --app         \u003cValue\u003e         Append to a configuration key\n    --unset                       Restore a configuration key to default\n\n  cspkg build\n    --install     [Package]...    Install a local package\n    --compile     [Argument]...   Compile extension using CXX compiler\n    --release     \u003cSource URL\u003e    Generate package index files for release\n    --flat                        Don't create cspkg-repo directory structure\n\n```\n\n## Configure CSPKG\n\nLocal path: `~/.cspkg/config.json`\n\n```json\n{\n\t\"arch\": \"x86_64\",\n\t\"home\": \"PATH-TO-COVSCRIPT-HOME\",\n\t\"source\": \"URL-OF-REPO;URL-OF-REPO\",\n\t\"proxy\": \"URL-OF-HTTP-PROXY\",\n\t\"timeout_ms\": \"3000\"\n}\n```\n\nFor fresh installment, you can run `cspkg init` to generate config file manually.\n\n## Architecture of a typical CSPKG repository\n\n### File Storage\n\nTypically a CSPKG repository is a HTTP(s) site in following structure:\n\n- http://mirrors.covariant.cn/cspkg_v2/\n  - index.json\n  - index\n    - universal\n    - winucrt\n      - x86_64\n        - index.json\n        - xxx.json\n    - linux\n      - x86_64\n        - index.json\n        - xxx.json\n    - macos\n      - arm64\n        - index.json\n        - xxx.json\n  - universal\n    - xxx.csp\n  - winucrt/x86_64\n    - xxx.cse\n  - linux/x86_64\n    - xxx.cse\n  - macos/arm64\n    - xxx.cse\n\nYou can also use local storage by setting source to URL like `file:///path-to-your-local-repo/`.\n\n\n## Build your package\n\n### Step 1: Write your Package Description File\n#### Package Description File Template:\n```json\n{\n    \"Name\": \"test\",\n    \"Info\": \"Test Package\",\n    \"Author\": \"Anonymous\",\n    \"Version\": \"1.0.0\",\n    \"Target\": \"URL to your package\",\n    \"Dependencies\": []\n}\n\n```\n+ `Name` is the unique identifier of the package and cannot be repeated.\n+ `Info` is the description of your package, should be short in one sentence.\n+ `Author` is the name of the package author.\n+ `Version` is the version of your package, which will be sorted in lexicographical order.\n+ `Target` is the URL of your file(`.cse` or `.csp`), you can use GitHub as your server.\n+ `Dependencies` is an array of package names you depend on.\n\n#### Example:\n```json\n{\n    \"Name\": \"csdbc_mysql\",\n    \"Info\": \"CSDBC MySQL Driver\",\n    \"Author\": \"CovScript Organization\",\n    \"Version\": \"1.0.0\",\n    \"Target\": \"http://mirrors.covariant.cn/cspkg_v2/universal/csdbc_mysql.csp\",\n    \"Dependencies\": [\n        \"database\",\n        \"codec\",\n        \"csdbc\",\n        \"regex\"\n    ]\n}\n```\n### Step 2: Upload your Package Description File\nYou can:\n+ Upload with your project file to GitHub or other VCS (Recommended!!!)\n+ Upload to dedicated server(mostly for releasing purpose)\n\n### Step 3: Building your package\nIf your package is written in Covariant Script, there's no need for extra building. But if you are writting an Covariant Script Extension, please follow [CSBuild Instruction](https://github.com/covscript/csbuild#build-your-package-with-csbuild).\n\nCSPKG provides lots commands for building and compiling. If you are writting an extension and have `Source` field configured in `csbuild` folders, you can use `cspkg build --install` for auto installation and `cspkg build \u003cFILE\u003e --compile` for single file compilation.\n\nAfter that, you can use `cspkg build --release \u003cSource URL\u003e` for auto releasing, which can generate a legal file structural for your CSPKG source.\n\n### Step 4: Submit your Package to CSPKG Source\n1. Fork [CSPKG Source GitHub Repository](https://github.com/covscript/cspkg-sources)\n2. Fill the URL of your Package Description File to CSPKG Index File\n    + Universal Package(No platform dependency): cspkg/universal.json\n    + Platform Specified Package: cspkg/OS_Architectural.json\n3. Create new pull request","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcovscript%2Fcspkg","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcovscript%2Fcspkg","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcovscript%2Fcspkg/lists"}