Repository files navigation

Grep Front End code forgrep.metacpan.org

grep.metacpan.org is currently not usingmetacpan-developer,but it should be pretty straight forward to setup a development environment and starting submitting Pull Request via GitHub.

• docker & docker compose
• checkout a version ofmetacpan-extracted view details after to usemetacpan-cpan-extracted-lite

You should start forking the mainmetacpan-grep-front-end repositoryYou can then clone it locally (where you should replaceYOUR-GITHUB-USERNAME by your github username )

> git clone git@github.com:~YOUR-GITHUB-USERNAME~/metacpan-grep-front-end.git> cd metacpan-grep-front-end> git remote add upstream https://github.com/metacpan/metacpan-grep-front-end.git

The frontend is not using a database, but agit repo itself as a backend.For this the production is using one huge git repository (~20 Go) indexing all the CPAN in one place !You can read more on this topic and find tools used to build this Git repo on theGitHub Repos page.

We do not want to use such a beast during development cycles, we only need a smaller version of it,you can simply clone it from thismetacpan-cpan-extracted-lite.It should be clone at the same level ofmetacpan-grep-front-end itself (do not clone it inside the repository).

# clone at the same level of metacpan-grep-front-end# cd .. # if you are in metacpan-grep-front-end repo> git clone https://github.com/metacpan/metacpan-cpan-extracted-lite.git# you should have something like this> ls -d metacpan-*metacpan-cpan-extracted-lite metacpan-grep-front-end

> make # alias to `make up` or `make up-dev`Watching . bin/lib bin/app.psgi for file updates.HTTP::Server::PSGI: Accepting connections at http://0:5010/

This will start a docker container setup bydocker-compose.yml using by default thedevelopment environment.

You can now open your browser to this url, and you should be able to see thegrep.metacpan.org homepage.

http://127.0.0.1:5010

Each environment comes with its own environment,by default they all use values from the default configurationconfig.yml,but they can overwrite some values or provide some custom values using their ownfile.

config.ymlenvironments/development.ymlenvironments/metacpan.ymlenvironments/production.yml

If you need two tweak your development environment you should look atenvironments/development.ymlYou can even create your own environment if required.

From there you should be ready to

# hack, hack, hack...-> Submit a Pull Request to GitHub# continue to hack, hack, ...have fun !