The Haxe library manager. This repository contains the command line "haxelib" tool as well as the source for both the haxelib server API and haxelib website. Contributions welcome!
Haxe HTML CSS Other
Latest commit 3beed9a Nov 16, 2017 @andyli andyli more https
Permalink
Failed to load latest commit information.
.ebextensions mount EC2 directories as files and tmp in the container Jul 20, 2016
.vscode add dummy -neko arg for vscode server_each.hxml display configuration… Aug 2, 2016
bin updated README, remove outdated files Feb 8, 2016
src Merge pull request #373 from fegies/371-client-quiet-flag Nov 6, 2017
test [AppVeyor] httpd-2.4.29 Nov 1, 2017
uf-content New website by @jasononeil Dec 9, 2015
www more https Nov 16, 2017
.dockerignore rework deployment Apr 27, 2017
.gitignore Added a CMakeLists.txt that can produce valid binary using `nekotools… Feb 3, 2017
.travis.yml [TravisCI] test with Haxe 3.4.4 Oct 21, 2017
CHANGES.md restore subdir functionality as it's actually used for popular libs, … Apr 10, 2016
CMakeLists.txt Added a CMakeLists.txt that can produce valid binary using `nekotools… Feb 3, 2017
Dockerfile rework deployment Apr 27, 2017
README.md Minor typo in README.MD (#394) Sep 26, 2017
apache2.conf merge andyli/tora and use ppa:haxe/snapshots for now Aug 1, 2016
appveyor.yml updated package checking Oct 27, 2017
ci.hxml [AppVeyor] run integration test Mar 30, 2016
client.hxml Make self update work on top of run mechanism Mar 12, 2016
client_legacy.hxml restructured project, removed outdated files Feb 6, 2016
client_tests.hxml fix tests Oct 27, 2017
deploy.json deploy: "bower_components" instead of the no longer exist "js" folder Jul 11, 2016
deploy_key.enc set up auto deploy for the master branch Feb 8, 2016
haxelib.json actually, haxelib client doesn't need record-macros, but server does Mar 21, 2017
integration_tests.hxml fix tests Oct 27, 2017
package.hxml restructured tests, removed more outdated files Feb 6, 2016
prepare_tests.hxml Pull out the test preparation code. Mar 10, 2016
run.n rebuilt run.n Oct 27, 2017
schema.json update json-schema Apr 14, 2016
server.hxml split server.hxml into multiple hxml Aug 5, 2016
server_api.hxml actually, haxelib client doesn't need record-macros, but server does Mar 21, 2017
server_each.hxml actually, haxelib client doesn't need record-macros, but server does Mar 21, 2017
server_legacy.hxml fixed Paths for legacy site Aug 10, 2016
server_tasks.hxml split server.hxml into multiple hxml Aug 5, 2016
server_tests.hxml restructured project, removed outdated files Feb 6, 2016
server_website.hxml split server.hxml into multiple hxml Aug 5, 2016

README.md

TravisCI Build Status AppVeyor Build Status

Haxelib: library manager for Haxe

Haxelib is a library management tool shipped with the Haxe Toolkit.

It allows searching, installing, upgrading and removing libraries from the haxelib repository as well as submitting libraries to it.

For more documentation, please refer to http://lib.haxe.org/documentation/

Development info

Running the haxelib server for development

The server has to be compiled with Haxe 3.2.1+. It can be run in Apache using mod_neko / mod_tora.

Currently using Docker is the simpliest way to build and run the server. It doesn't require setting up Apache or MySQL since everything is included in the container. We would recommend to use the Docker Platform instead of the Docker Toolbox.

To start, run:

docker-compose -f test/docker-compose.yml up -d

The command above will copy the server source code and website resources into a container, compile it, and then start Apache to serve it. To view the website, visit http://localhost:2000/ (or http://$(docker-machine ip):2000/ if the Docker Toolbox is used).

Since the containers will expose port 2000 (web) and 3306 (MySQL), make sure there is no other local application listening to those ports. In case there is another MySQL instance listening to 3306, we will get an error similar to Uncaught exception - mysql.c(509) : Failed to connect to mysql server.

To stop the server, run:

docker-compose -f test/docker-compose.yml down

If we modify any of the server source code or website resources, we need to rebuild the image and replace the running container by issuing the commands as follows:

docker-compose -f test/docker-compose.yml build
docker-compose -f test/docker-compose.yml up -d

To iterate quickly during development, we can use -f test/docker-compose-dev.yml in place of -f test/docker-compose.yml when starting the container. -f test/docker-compose-dev.yml mounts the repo's /www folder to the container, such that there is no need to rebuild and replace the running containers. Instead, after modifying the server source code or html templates, run haxe server.hxml and the container should pick up the changes immediately. The downside of this is that we have to make sure we've installed the right haxelib dependencies. Also, Docker only allows mounting folders in certain locations (e.g. /Users on Mac), so it may not work if we cloned the repo to /my_projects/haxelib.

To run haxelib client with this local server, prepend the arguments, -R $SERVER_URL, to each of the haxelib commands, e.g.:

neko bin/haxelib.n -R http://localhost:2000/ search foo

To run integration tests with the local development server:

# prepare the test files
haxe prepare_tests.hxml

# run the tests
haxe integration_tests.hxml

Note that the integration tests will reset the server database before and after each test.

About this repo

Build files:

  • client.hxml: Build the current haxelib client.
  • client_tests.hxml: Build and run the client tests.
  • client_legacy.hxml: Build the haxelib client that works with Haxe 2.x.
  • server.hxml: Build the new website, and the Haxe remoting API.
  • server_tests.hxml: Build and run the new website tests.
  • server_each.hxml: Libraries and configs used by server.hxml and server_tests.hxml.
  • server_legacy.hxml: Build the legacy website.
  • integration_tests.hxml: Build and run tests that test haxelib client and server together.
  • package.hxml: Package the client as package.zip for submitting to the lib.haxe.org as haxelib.
  • prepare_tests.hxml: Package the test libs.
  • ci.hxml: Used by our CIs, TravisCI and AppVeyor.

Folders:

  • /src/: Source code for the haxelib tool and the website, including legacy versions.
  • /bin/: The compile target for building the haxelib client, legacy client, and others.
  • /www/: The compile target (and supporting files) for the haxelib website (including legacy server)
  • /test/: Source code and files for testings.

Other files:

  • schema.json: JSON schema of haxelib.json.
  • deploy.json: Deploy configuration used by haxelib run ufront deploy for pushing the haxelib website to lib.haxe.org.
  • deploy_key.enc: Encrypted ssh private key for logging in to lib.haxe.org. Used by TravisCI.
  • Dockerfile: Docker build file for building an image that runs the haxelib server.