{"id":17919252,"url":"https://github.com/oldmud0/codeu17-group18","last_synced_at":"2025-04-03T08:25:36.552Z","repository":{"id":72536906,"uuid":"91510353","full_name":"oldmud0/codeu17-group18","owner":"oldmud0","description":"Google CodeU Summer 2017 chat project","archived":false,"fork":false,"pushed_at":"2017-08-04T23:26:51.000Z","size":874,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-02-08T21:48:52.848Z","etag":null,"topics":["google","summer-project"],"latest_commit_sha":null,"homepage":"https://github.com/google/codeu_project_2017","language":"Java","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/oldmud0.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","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}},"created_at":"2017-05-16T22:34:38.000Z","updated_at":"2018-03-02T05:40:36.000Z","dependencies_parsed_at":"2023-05-24T11:15:21.315Z","dependency_job_id":null,"html_url":"https://github.com/oldmud0/codeu17-group18","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oldmud0%2Fcodeu17-group18","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oldmud0%2Fcodeu17-group18/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oldmud0%2Fcodeu17-group18/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oldmud0%2Fcodeu17-group18/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oldmud0","download_url":"https://codeload.github.com/oldmud0/codeu17-group18/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246963559,"owners_count":20861506,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["google","summer-project"],"created_at":"2024-10-28T20:15:39.581Z","updated_at":"2025-04-03T08:25:36.544Z","avatar_url":"https://github.com/oldmud0.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"\n# CODEU CHAT SERVER | README\n\n\n## DISCLAIMER\n\nCODEU is a program created by Google to develop the skills of future software\nengineers. This project is not an offical Google Product. This project is a\nplayground for those looking to develop their coding and software engineering\nskills.\n\n\n## ENVIRONMENT\n\nAll instructions here are relative to a LINUX environment. There will be some\ndifferences if you are working on a non-LINUX system. We will not support any\nother development environment.\n\nThis project was built using JAVA 7. It is recommended that you install\nJAVA\u0026nbsp;7 when working with this project.\n\n\n## GETTING STARTED\n\n  There is a single python script build.py that is used to build and run\n  the project. There are many ways to run a python script. The syntax\n  below should work almost anywhere if the script is in your current directory.\n\n  1. To build the project:\n       ```\n       $ python build.py clean\n       $ python build.py build\n       ```\n\n  1. To test the project:\n       ```\n       $ python build.py run codeu.chat.TestRunner\n       ```\n\n  1. To run the project you will need to run both the client and the server. Run\n     the following two commands in separate shells:\n\n       ```\n       $ python build.py run codeu.chat.ServerMain \u003cteam_id\u003e \u003cteam_secret\u003e \u003cport\u003e \u003cpersistent-dir\u003e\n       $ python build.py run codeu.chat.ClientMain \"\u003chost\u003e@\u003cport\u003e\"\n       ```\n\n     You must provide the following startup arguments to `ServerMain`:\n     + `\u003cteam_id\u003e` and `\u003cteam_secret\u003e`: a numeric id for your team, and a secret\n       code, which are used to authenticate your server with the Relay server.\n       You can specify any integer value for `\u003cteam_id\u003e`, and a value expressed\n       in hexadecimal format (using numbers `0-9` and letters in the range\n       `A-F`) for `\u003cteam_secret\u003e` when you launch the server in your local setup\n       since it will not connect to the Relay server.\n     + `\u003cport\u003e`: the TCP port that your Server will listen on for connections\n       from the Client. You can use any value between 1024 and 65535, as long as\n       there is no other service currently listening on that port in your\n       system. The server will return an error:\n\n         ```\n         java.net.BindException: Address already in use (Bind failed)\n         ```\n\n       if the port is already in use.\n     + `\u003cpersistent-dir\u003e`: the path where you want the server to save data between\n       runs. This directory must exist when you start the server.\n\n     The startup argument for running `ClientMain` is `\u003chost\u003e@\u003cport\u003e`:\n     + `\u003chost\u003e`: the hostname or IP address of the computer on which the server\n       is listening. If you are running server and client on the same computer,\n       you can use `localhost` here.\n     + `\u003cport\u003e`: the port on which your server is listening. Must be the same\n       port number you specified when you launched `ServerMain`.\n     + The \"@\" between `\u003chost\u003e` and `\u003cport\u003e` is mandatory.\n\nAll running images write informational and exceptional events to log files.\nThe default setting for log messages is \"INFO\". You may change this to get\nmore or fewer messages, and you are encouraged to add more LOG statements\nto the code. The logging is implemented in `codeu.chat.util.Logger.java`,\nwhich is built on top of `java.util.logging.Logger`, which you can refer to\nfor more information.\n\nIn addition to your team's client and server, the project also includes a\nRelay Server. This is not needed to get your project started. You can start\nit locally using `python build.py run codeu.chat.RelayMain \u003cargs\u003e`. Look in\n`RelayMain.Java` for information about arguments.\n\n\n## Finding your way around the project\n\nAll the source files (except test-related source files) are in\n`./src/codeu/chat`.  The test source files are in `./test/codeu/chat`. If you\nuse the supplied scripts to build the project, the `.class` files will be placed\nin `./bin`. There is a `./third_party` directory that holds the jar files for\nJUnit (a Java testing framework). Your environment may or may not already have\nthis installed. The supplied scripts use the version in `./third_party`.\n\nFinally, there are some high-level design documents in the project Wiki. Please\nreview them as they can help you find your way around the sources.\n\n\n\n## Source Directories\n\nThe major project components have been separated into their own packages. The\nmain packages/directories under `src/codeu/chat` are:\n\n### codeu.chat.client\n\nClasses for building a simple client (`codeu.chat.ClientMain`).\n\n### codeu.chat.server\n\nClasses for building the server (`codeu.chat.ServerMain`).\n\n### codeu.chat.relay\n\nClasses for building the Relay Server (`codeu.chat.RelayMain`). The Relay Server\nis not needed to get started.\n\n### codeu.chat.common\n\nClasses that are shared by the clients and servers.\n\n### codeu.chat.util\n\nSome basic infrastructure classes used throughout the project.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foldmud0%2Fcodeu17-group18","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foldmud0%2Fcodeu17-group18","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foldmud0%2Fcodeu17-group18/lists"}