{"id":13552918,"url":"https://github.com/rictic/code_swarm","last_synced_at":"2025-04-06T22:10:59.515Z","repository":{"id":417695,"uuid":"37399","full_name":"rictic/code_swarm","owner":"rictic","description":"A (fork of a) slick visualization for your source code","archived":false,"fork":false,"pushed_at":"2014-01-12T18:31:00.000Z","size":37650,"stargazers_count":354,"open_issues_count":6,"forks_count":63,"subscribers_count":13,"default_branch":"master","last_synced_at":"2025-03-30T21:08:51.846Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://code.google.com/p/codeswarm/","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rictic.png","metadata":{"files":{"readme":"README.markdown","changelog":null,"contributing":null,"funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2008-07-26T09:22:13.000Z","updated_at":"2024-06-28T07:50:04.000Z","dependencies_parsed_at":"2022-07-14T12:50:33.929Z","dependency_job_id":null,"html_url":"https://github.com/rictic/code_swarm","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/rictic%2Fcode_swarm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rictic%2Fcode_swarm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rictic%2Fcode_swarm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rictic%2Fcode_swarm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rictic","download_url":"https://codeload.github.com/rictic/code_swarm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247557767,"owners_count":20958047,"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":[],"created_at":"2024-08-01T12:02:13.313Z","updated_at":"2025-04-06T22:10:59.494Z","avatar_url":"https://github.com/rictic.png","language":"Java","funding_links":[],"categories":["Java","others"],"sub_categories":[],"readme":"code_swarm is an experiment in organic software visualization.\r\n\r\nSee http://vis.cs.ucdavis.edu/~ogawa/codeswarm for a picture of what we want\r\nto produce.\r\n\r\nGoogle Code Project :      http://code.google.com/p/codeswarm/\r\nGoogle Group/Mailing List: http://groups.google.com/group/codeswarm \r\n\r\n\r\n# Building #\r\n\r\n## Prerequisites ##\r\n\r\nYou will need the Apache ant build tool, at least version 5 of the Java SDK from Sun, and Python version 2.4 or later.  Linux users: we've been unable to get code_swarm to compile with the GNU toolchain, Sun's implementation is strongly recommended.  If you're able to get it to compile with another toolchain, we'll be glad to include instructions here on how to do so.\r\n\r\n\r\n### Mac ###\r\n\r\nRecent versions of OS X come with a good java compiler and Python interpreter, so all you need to do is get and install ant.\r\n\r\nIf you have DarwinPorts/MacPorts, you can simply:\r\n    sudo port install apache-ant\r\n\r\n\r\n### Linux ###\r\n\r\n    sudo apt-get install ant \r\n    sudo apt-get install sun-java6-jdk \r\n    sudo update-java-alternatives -s java-6-sun \r\n\r\nTested with Ubuntu 8.04, probably similar in other linux distributions.\r\n\r\nYou should also ensure that Python is installed.  Run `python` in the terminal if you're unsure.\r\n\r\n### Windows ###\r\n\r\n* download ant: \u003chttp://ant.apache.org/bindownload.cgi\u003e\r\n* unpack it and add the location of its binaries to the the\r\n `PATH` environment variable. For instance, add at the end : \r\n  `C:\\apache-ant-1.7.0\\bin;` \r\n\r\n* download the Sun Java SDK at \u003chttp://java.sun.com/javase/downloads/index.jsp\u003e\r\n* install it and add the Java binaries to the `PATH` : \r\n  `C:\\Program Files\\Java\\jdk1.6.0_06\\bin;`\r\n\r\n* then create a new environment variable called JAVA_HOME and set its path to \r\n  `C:\\Program Files\\Java\\jdk1.6.0_06;`\r\n\r\n* download and install Python from \u003chttp://www.python.org/download/\u003e and \r\n  ensure that it too is in the `PATH`\r\n\r\n## Getting the source code ##\r\n\r\n### git ###\r\n\r\nA git fork of the main code_swarm repository is maintained at \u003chttp://github.com/rictic/code_swarm/tree/master\u003e\r\n\r\nThis fork contains a number of patches which improve the speed of code_swarm significantly, \r\nas well as an executable, which makes running code_swarm a one-step process.\r\n\r\nTo obtain a clone of the repository, simply use:\r\n\r\n    git clone git://github.com/rictic/code_swarm.git\r\n    \r\n\r\n### Subversion ###\r\n\r\nThe main code_swarm repository however is on Google Code: \r\n\u003chttp://codeswarm.googlecode.com/\u003e\r\n\r\nTo get the source, see \u003chttp://code.google.com/p/codeswarm/source/checkout\u003e\r\n\r\n\r\n## Running code_swarm ##\r\n\r\nWith Java and ant installed, and the code_swarm source downloaded, running it on a git, svn, or hg based project is easy:\r\n\r\n* Add `code_swarm/bin` to your PATH.  A line like `export PATH=$PATH:/path/to/code_swarm/bin` in your `~/.profile` or `~/.bash_profile` should do it\r\n* `cd project/to/visualize`\r\n* `code_swarm`\r\n\r\n\r\n## Other ways of running code_swarm ##\r\n\r\n### Running manually ###\r\n\r\nWhile code_swarm was developed to visualize source code repositories, its input format is generic, and some have experimented with visualizing other collaborative environments, including user activity on wikis and freebase.com.\r\n\r\ncode_swarm can be invoked by pointing it at a project config file, which contains a number of options for customizing the visualization.  The config file must point at a repository xml file, which contains a set of events, which each describe a file, edited by a person, at a specific time.  The time is specified as the number of milliseconds since January 1st, 1970.\r\n\r\nExample config files can be seen in `data/sample.config` and `bin/config.template`\r\n\r\nTo invoke `code_swarm` with a given config file, use `./run.sh path/to/project.config`\r\n\r\n#### SVN GUI ####\r\nFor an experimental GUI where you can specify a svn url to visualize:\r\n\r\n* `cd path/to/code_swarm`\r\n* `ant run`\r\n\r\nOther commands:\r\n\r\n* `ant` will build, but not run the project\r\n* `ant all` will also generate Javadoc HTML documentation\r\n* `ant clean` will delete all intermediate and binary files \r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frictic%2Fcode_swarm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frictic%2Fcode_swarm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frictic%2Fcode_swarm/lists"}